wiki:pcauto_club_4.0.0/api

Version 31 (modified by liangzhicong, 11 years ago) (diff)

--

Table of Contents

  1. 1. 投票相关
    1. 1.1用户发布投票
    2. 1.2用户投票
  2. 2.相册相关
    1. 2.1创建相册列表
    2. 2.2根据id返回相册列表
    3. 2.3上传图片
    4. 2.4设置封面
    5. 2.5删除照片
    6. 2.6删除相册
  3. 3.活动相关
    1. 3.1 发布/更新活动
    2. 3.2 删除活动
    3. 3.3 活动报名
    4. 3.4 活动审核
    5. 3.5 活动审核列表
    6. 3.6 活动报名列表
  4. mrobot合并
    1. 1.1投票详情
    2. 1.2 活动列表
    3. 1.3 活动详情
    4. 1.4 活动成员列表
    5. 1.5 相册首页列表

1. 投票相关

1.1用户发布投票

1.1.1 用户发布投票
接口/appapi/1.0/vote/createVote.do [POST]

1.2用户投票

1.1.4 用户进行投票
接口/appapi/1.0/vote/takeVote.do [POST]

2.相册相关

2.1创建相册列表

1.2.1 创建/修改相册
接口/appapi/1.0/album/editAlbum.do [POST]

2.2根据id返回相册列表

1.2.2 根据相册ID返回相片列表
接口/appapi/1.0/album/getPhotoByAlbumId.do [GET]

2.3上传图片

1.2.2 上传图片
接口/appapi/1.0/album/uploadPhotos.do [POST]

2.4设置封面

1.2.3 设置封面 
接口/appapi/1.0/album/setAlbumCover.do [POST]

2.5删除照片

1.2.5 删除照片（批量）
接口/appapi/1.0/album/delPhotos.do [POST]

2.6删除相册

1.2.6 删除相册
接口/appapi/1.0/album/delAlbum.do [POST]

3.活动相关

3.1 发布/更新活动

1.3.1 发布/更新活动 
接口/appapi/1.0/activity/editActivity.do [POST]

3.2 删除活动

1.3.6 删除活动
接口：/appapi/1.0/activity/delActivity[POST]

3.3 活动报名

1.3.7 活动报名
接口：/appapi/1.0/activity/applyActivity[POST]

3.4 活动审核

1.3.8 活动审核
接口：/appapi/1.0/activity/auditApply[POST]

3.5 活动审核列表

1.3.9 活动报名列表（审核中）
接口：/appapi/1.0/activity/getApplyingList[GET]

3.6 活动报名列表

1.3.10 活动报名列表（审核通过）
接口：/appapi/1.0/activity/getApplyedList[GET]

mrobot合并

基本约定：
可以连开发机代理或者域名改成相对应环境域名

开发机代理：192.168.10.199 端口为 1080（开发机）
开发机域名：http://dev40.pcauto.com.cn

测试机代理：
测试机域名：

1.1投票详情

1.1.2 获取投票详情
接口：/xsp/s/club/v4.0/vote_detail.xsp?userId=30257562&voteId=301

请求参数：
||参数名||类型||必须||说明||
||voteId||String||Y||投票ID||
||userId||String||Y||用户ID||

返回结果:
{
	code: 0,
	message: "操作成功",
	version: "v1.0(latest)",
	voteCount: 0,
	voteId: 301,
	voteItems: [
		{
			voteItem: "读书",
			voteItemCount: 0,
			voteItemId: 251
		},
		{
			voteItem: "认字",
			voteItemCount: 0,
			voteItemId: 252
		},
		{
			voteItem: "看电视",
			voteItemCount: 0,
			voteItemId: 253
		}
	],
	voteTitle: "好好学习的方法是?",
	hasVoteItemId: 0 //此id为返回用户已投项id votedItemId，无则为0
}

源接口/appapi/1.0/vote/getVoteDetail.do [GET]
1.1.3 判断用户是否已投票 
源接口/appapi/1.0/vote/hasVoted.do [GET]
增加返回用户已投项id votedItemId

1.2 活动列表

1.3.3 活动列表
接口：/xsp/s/club/v4.0/activity_list.xsp?clubId=5381&clubUrl=dynaclub&userId=30257562

请求参数：
||参数名||类型||必须||说明||
||clubId||String||Y||车友会ID||
||clubUrl||String||Y||车友会域名||
||userId||String||N||用户Id||
返回结果:
{
	clubId: 5381,
	clubName: "凤凰车友会",
	clubUrl: "dynaclub",
	code: 0,
	data: [
		{
			activityCost: 123,
			activityId: 4071,
			activityPlace: "北京市",
			activityType: 1,
			beginDate: 1428243060000,
			createBy: 30257562,
			dayCount: 5,
			endDate: 1428588660000,
			limitCount: 0,
			nickName: "test_xl",
			pic: "http://dev2.pconline.com.cn:9191/upcfiles/autoclub/1502/06/c0/6992_1423188755365_1024x1024.jpg",
			signupDate: 1428329460000,
			title: "wqerqwerqwer",
			isSignUp: 3,
			statusMsg: "报名结束",
			statusCode: 101,
			applyCount: 1 //只是通过审核的人数,没有则为0
		},
		{},
		{},
	],
	message: "操作成功",
	pageCount: 2,
	pageNo: 1,
	pageSize: 20,
	total: 24,
	version: "v2.0(latest)"
}

源接口：/appapi/2.0/activity/getActivityList.do [GET]
增加返回
//isSignUp:是否报名
//statusMsg:状态名字，服务器返回显示火热报名，已报名等状态的文字，app建议直接读取这个新的字段显示
//statusCode:状态码
//applyCount:申请人数（只是通过审核的人数）
源接口：
1.3.4 获取活动状态提示 
接口：/appapi/1.0/activity/getActivityStatus.do [GET]
1.3.5 判断用户是否已报名
接口：/appapi/1.0/activity/hasApplyed [GET]
1.3.9 活动报名列表（审核中）
接口：/appapi/1.0/activity/getApplyingList[GET]
1.3.10 活动报名列表（审核通过）
接口：/appapi/1.0/activity/getApplyedList[GET]

1.3 活动详情

1.3.2 活动详情
接口：/xsp/s/club/v4.0/activity_detail.xsp?activityId=4041

请求参数：
||参数名||类型||必须||说明||
||activityId||String||Y||活动ID||

返回结果:
{
	activityId: 4041,
	activityImgUrl: "http://baidu.com",
	activityPlace: "北京市",
	activityType: 1,
	authorTel: "15089699344",
	beginDate: 1423065611000,
	clubId: 5381,
	code: 0,
	content: "222222222",
	contentImages: [ ],
	createAt: 1423124305000,
	createBy: 30257562,
	destinationPlaces: [ ],
	endDate: 1423929611000,
	gatherPlace: {
		latitude: 39.91516771771552,
		longitude: 116.4038742349945,
		name: "abc"
	},
	limitCount: 0,
	message: "操作成功",
	money: 0,
	nickName: "test_xl",
	signupDate: 1423497611000,
	title: "111111",
	userName: "test_xl",
	version: "v1.0(latest)",
	statusMsg: "报名结束",
	statusCode: 101,
        applys:[
             {
                userId: 30257562 //用户id
             }
        ]//从getApplyedList拿，小于等于6个
        applyCount: 1 //只是通过审核的人数,没有则为0
        dynaInfoId://动态id，如果无则返回0;
}

源接口：
1.3.2 活动详情
/appapi/1.0/activity/getActivityDetail.do [GET]
增加返回
//statusMsg:状态名字，服务器返回显示火热报名，已报名等状态的文字，app建议直接读取这个新的字段显示
//statusCode:状态码
源接口
1.3.4 获取活动状态提示 
接口：/appapi/1.0/activity/getActivityStatus.do [GET]
来源
1.3.9 活动报名列表（审核中）
接口：/appapi/1.0/activity/getApplyingList[GET]
1.3.10 活动报名列表（审核通过）
接口：/appapi/1.0/activity/getApplyedList[GET]
1.3.11 判断活动是否生成过动态（旧数据没有评论功能）
接口：/appapi/1.0/activity/hasDynaByActivityId.do[GET]

1.4 活动成员列表

1.4 活动成员列表
接口：/xsp/s/club/v4.0/activity_member_list.xsp?pageNo=1&pageSize=20&activityId=4071

请求参数：
||参数名||类型||必须||说明||
||activityId||String||Y||活动ID||
||pageNo||String||Y||页数||
||pageSize||String||Y||每页显示条数||

返回结果:
{
      	applying: [ ],  //没有结果就返回空数组，第一页时返回申请审核列表,当page>1时不需要再次请求        
	applyed: [ 
		{
			descript: "22222222222222222222",
			joinNum : 11,
			lincensePlate: "222222222",
			memberId: 26721,
			nickName : "test_xl",
			phone: "15920908586",
			userId: 30257562,
			userName : "vvvvvvvv"
		}
	] //没有结果就返回空数组
}

来源
1.3.9 活动报名列表（审核中）
接口：/appapi/1.0/activity/getApplyingList[GET]
1.3.10 活动报名列表（审核通过）
接口：/appapi/1.0/activity/getApplyedList[GET]

1.5 相册首页列表

1.5 相册首页列表
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/album_homepage_list.xsp?pageNo=1&pageSize=20&clubId=5381

请求参数：
||参数名||类型||必须||说明||
||clubId||String||Y||车友会ID||
||pageNo||String||Y||页数||
||pageSize||String||Y||每页显示条数||
结果
{

   clubId : 车友会ID
   clubName : 车友会名字
   pageNo:
   pageSize:
   
   albumList : [
          {
            albumId : 相册ID
            albumName : 相册名字
            coverUrlSmall : 封面图片
            createAt : 相册创建时间
            createBy : 相册创建者
            nickName : 创建者昵称
            authorPhoto : 创建者头像
            isVip : 是否认证
            photoSize : 相片数
            photoList : [
                {
                  photoId : 照片ID
                  urlSamll : 小图片
                  urlBig : 大图片
                 },
                 {
                  photoId : 照片ID
                  urlSamll : 小图片
                  urlBig : 大图片
                 }   
            ]            
           },],
   lastList:[
        {
          albumId : 相册ID
          photoId : 照片ID
          urlSamll : 小图片
          urlBig : 大图片
          createAt : 照片创建时间
        },
   ]//1.3.0 获取车友会最新照片列表 前4张
}
来源
1.2.1 根据车友会ID,返回相册列表
接口/appapi/1.0/album/getAlbumByClubId.do [GET]
1.3.0 获取车友会最新照片列表
接口/appapi/1.0/album/getLatestPhotosByClubId.do [GET]