pcauto_club_4.0.0/api – iphone

wiki:pcauto_club_4.0.0/api

Context Navigation

Version 83 (modified by liangzhicong, 11 years ago) (diff)
--

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]

2.7 评论照片

1.2.11 评论照片
接口/appapi/1.0/photo/replyPhoto.do [POST]

2.8 获取照片评论

1.2.13 获取照片评论列表
接口/appapi/1.0/photo/getReplyList.do [GET]

2.9 照片点赞/取消赞

1.2.14 照片点赞/取消赞
接口：/appapi/1.0/photo/doPraise.do [POST]

2.10 照片点赞列表

1.2.17 获取照片点赞用户列表
接口：/appapi/1.0/photo/getPraiseUserList.do [GET]

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]

3.7 取消活动报名

1.3.12 取消活动报名
接口：/appapi/1.0/activity/cancelActivity.do[POST]

4.首页相关

4.1 签到列表

1.4.1 今日签到排行列表
接口：/appapi/1.0/club/todayCheckInList.do[GET]

4.2 设置动态置顶

1.4.2 设置动态置顶
接口：/appapi/1.0/dyna/setDynaTop.do[POST]

4.3 取消动态置顶

1.4.3 取消动态置顶
接口：/appapi/1.0/dyna/cancelDynaTop.do[POST]

4.4 删除动态

1.4.9 删除动态
接口：/appapi/1.0/dyna/deleteDyna.do[POST]

5.1 会员卡

接口：/wap/club/getMemberShipCard.do

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:状态码
源接口：
1.3.4 获取活动状态提示 
接口：/appapi/1.0/activity/getActivityStatus.do [GET]
1.3.5 判断用户是否已报名
接口：/appapi/1.0/activity/hasApplyed [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;
        isSignup://是否报名(0:审核中， 1：报名成功，2：未报名）
}

源接口：
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.5 判断用户是否已报名
接口：/appapi/1.0/activity/hasApplyed [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"
		}
	] //没有结果就返回空数组
        
        applyedTotal：9
        applyedpageNo：1

}

来源
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:每页条数
   pageCount:总共几页
   total:总条数

   
   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]

1.6车友会首页

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/homepage.xsp?pageNo=1&pageSize=20&clubId=5381&userId=30257562


是否登录:否
缓存时间:无
是否分页:是

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

返回
{       
        code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本

        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

        applyCount:新用户申请加入数   //1.1.37功能

       dynaTopList : [      //1.4.4 功能
        {
         dynaInfoId : 动态ID
         dynaType : 动态类型
         content: 动态内容（图片用【图】代替）
         dynaTargetId : 动态目标ID
        }]

         checkInList : [  //1.4.1功能
         {
          userId : 签到者ID
          nickName : 签到者昵称
          checkInTime : 签到时间（时间戳）
         }] 

	dynaList:[
	    {
	        dynaInfoId：动态id，
		postCount:回复数
		pubTime: 发布时间, 
		forumId: 板块ID, 
		forumName: 板块名称, 
		createBy: 创建者ID, 
		nickName:作者昵称,
		isHasImg: 是否有图片(0:没有，1：有）, 
		petrol: 贡献油值, 
		authorPhoto: 作者头像, 
		isVip：是否认证，（0：否，1：是）
		praiseCount：点赞数
                hadPraise：已赞(根据当前登录的用户是否赞过此动态） //1.1.31功能

		dynaType:动态类型(1-普通帖子（旧数据包含提问帖子），2-说说动态，3-图片动态，4-提问帖子，5-公告动态，6-活动动态，7-新会员加入动态，8-创建车友会动态）
				
		//以上是动态列表公共字段
		//下面是根据不同的动态类型，返回不同的字段或内容
		dynaType == 1，4
		         dynaTargetId:帖子ID
		         content:帖子内容 
		         topicTitle: 帖子标题,
		         isPick: 是否是精华（0：不是，1：是，2：是）, 
		         isRecommend: 是否是推荐（0：不是，1：是）
				   
		dynaType == 2
			 dynaTargetId ：说说动态ID
			 content:说说内容
				   
		dynaType == 3
			 dynaTargetId ：相册ID
		         content:上传了100张相片到《相册名字》
				   
		dynaType == 5
                         content : 发布了公告：XXXXXXXXXXXX
				   
		dynaType == 6
			 dynaTargetId ：活动ID
			 content:发起了活动：活动标题
                         signUpCount:成功报名人数
                         activityCost:每人花费	
                         activityCover : 活动封面图
                 
                dynaType == 7
                         content : Hello，我已经加入了 + 车友会名字 + ，现在我是一个有组织的人了，欢迎大家来围观	
                 
                dynaType == 8 
                         content : 创建了+ clubName + 车友会主页： + targetUrl + , 大家快去邀请车友加入吧	

                dynaType == 9	
                        dynaTargetId: 动态ID
                        content : 投票标题
                        voteCount: 投票人数				   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]
}

应用端接口：
说明：获取动态列表（返回动态图片列表）
接口：/appapi/2.0/dyna/getDynaListImages.do [GET]
请求参数
	*clubId:车友会id

来源：
1.1.31 判断是否已赞 [返回：动态是否已赞]
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]

1.1.37 车友会成员列表接口  [返回：会长登陆,返回申请人数]
接口：/appapi/1.0/member/getMemberList.do [GET]

1.4.4 获取动态置顶列表 [返回：置顶列表]
接口：/appapi/1.0/dyna/dynaTopList.do[GET]

1.4.1 今日签到排行列表 [返回：签到用户的信用]
接口：/appapi/1.0/club/todayCheckInList.do[GET]

1.7 照片详情（赞、评论）

1.2.12 获取照片评论数和赞数
接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/photos_praise_detail.xsp?photoId=54661&albumId=6651 GET

是否登录:是

请求参数：
||参数名||类型||必须||说明||
||photoId||String||Y||照片ID||
||albumId||String||Y||相册ID||

{
	albumId: 6651,
	code: 0,
	message: "操作成功",
	photoId: 54661,
	praiseCount: 1,
	replyCount: 0,
	version: "v1.0(latest)",
	hadPraisePhotoIds: "54661" //有则返回photoID，无则为空
}

应用端接口
1.2.12 获取照片评论数和赞数：
/appapi/1.0/photo/getReplyPraiseCount.do [GET]

增加返回当前用户是否已赞 hadPraise字段，来源如下：
1.2.18 判断是否已赞过照片：
/appapi/1.0/photo/getHadPraiseList.do [GET]

1.8 车友会论坛列表

1.4.6 帖子列表（发布时间倒序）
接口http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/topicListByCreateTime.xsp?clubId=1121&pageNo=1&pageSize=3[GET]
是否登录:否

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

{
	"code": 0,
	"message": "操作成功",
	"pageCount": 27,
	"pageNo": 1,
	"pageSize": 20,
	"topicList": [{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1426057760000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1426057760000,
		"replyCount": 0,
		"title": "gregfdvdx",
		"topicId": 5807993,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5807993.html",
		"viewCount": 1
	},
			{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1422949219000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1422949219000,
		"replyCount": 0,
		"title": "测试表格",
		"topicId": 5807139,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5807139.html",
		"viewCount": 1
	},
       {
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1420702151000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1420702151000,
		"replyCount": 0,
		"title": "谁水水水水水水水水水水水水",
		"topicId": 5806248,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5806248.html",
		"viewCount": 1
	},
	{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1420702151000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1420702151000,
		"replyCount": 0,
		"title": "谁水水水水水水水水水水水水",
		"topicId": 5806249,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5806249.html",
		"viewCount": 1
	}],
	"total": 531,
	"version": "v1.0"
}
1.4.7 帖子列表（回复时间倒序）
接口http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/topicListByPostTime.xsp?clubId=1121&pageNo=1&pageSize=3[GET]
是否登录:否

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

{
	"code": 0,
	"message": "操作成功",
	"pageCount": 27,
	"pageNo": 1,
	"pageSize": 20,
	"topicList": [{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1426057760000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1426057760000,
		"replyCount": 0,
		"title": "gregfdvdx",
		"topicId": 5807993,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5807993.html",
		"viewCount": 1
	},
	 1
	},
	{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1423733119000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1423736289000,
		"replyCount": 1,
		"title": "再来一发再来一发(2)",
		"topicId": 5807403,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5807403.html",
		"viewCount": 1
	},
	{
		"author": {
			"nickName": "hh ",
			"realName": "",
			"userId": 13128876
		},
		"createAt": 1420702151000,
		"isPic": 0,
		"isPick": 0,
		"isRecommend": 0,
		"lastPostAt": 1420702151000,
		"replyCount": 0,
		"title": "谁水水水水水水水水水水水水",
		"topicId": 5806251,
		"url": "http://dev11.pcauto.com.cn/bbs7/topic-5806251.html",
		"viewCount": 1
	}],
	"total": 531,
	"version": "v1.0"
}



增加帖子已读数
来源
1.4.8 获取帖子被查看次数（由论坛提供）
接口：${BBSROOT}/clubapi/1/getTopicView.do[GET]

1.9 收到的赞（动态与图片混合）

接口http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/praiseList.xsp?pageNo=1&pageSize=3[GET]
是否登录:是

请求参数：
||参数名||类型||必须||说明||
||pageNo||String||Y||页数||
||pageSize||String||Y||每页显示条数||
{
	"code": 0,
	"message": "操作成功",
	"pageCount": 1,
	"pageNo": 1,
	"pageSize": 20,
	"praiseList": [{
		"content": "上传了1张相片到<a href='http://dev18.pcauto.com.cn/dynaclub/album/a7752-photo/'>《好多好多》</a>",
		"createDate": "2015-03-06",
		"dynaInfoId": 1241333,
		"dynaTargetId": 7752,
		"dynaType": 3,
		"hadRead": 0,
		"images": [{
			"height": 938,
			"qua": 0,
			"url": "http://dev2.pconline.com.cn:9191/upcfiles/autoclub/1503/06/c0/9221_1425605119123.jpg",
			"width": 700
		}],
		"isVip": 0,
		"nickName": "test",
		"praiseTime": 1421307228000,
		"userId": 9685789
	},
				{
		"albumId": 7856,
		"hadRead": 0,
		"isVip": 1,
		"nickName": "test_xl3",
		"photoId": 55055,
		"praiseTime": 1426070430000,
		"userId": 30261200
	}],
	"total": 17,
	"version": "v1.0(latest)"
}}
注：新接口中按照praiseTime 升序排列展示
后端接口：
//收到赞我的照片列表
http://club.pcauto.com.cn/appapi/1.0/dyna/getPraiseList.do
// 收到赞我的照片列表
http://club.pcauto.com.cn/appapi/1.0/photo/getPraiseList.do

然后要调用一下后端接口去清楚已经看过的点赞
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0#a1.1.28未读点赞清零

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.0#a1.2.16未读照片点赞清零

1.10 同城动态列表

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/city_dynas.xsp
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）
userId 当前登录用户id（登录情况传，未登录不传）
说明：获取同城动态列表，封装动态是否已赞

来源
说明：获取同城动态列表
接口：/appapi/2.0/dyna/getTongChengDynaList.do [GET]
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）


1.1.31 判断是否已赞
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getHadPraiseList.do [GET]
请求参数
userId:用户ID
dynaInfoIds：动态id列表，用“，”连接起来


返回
{
	code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本
        
        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

	dynaList:[
	    {
	        dynaInfoId：动态id，
		postCount:回复数
		pubTime: 发布时间, 
		forumId: 板块ID, 
		forumName: 板块名称, 
		createBy: 创建者ID, 
		nickName:作者昵称,
		isHasImg: 是否有图片(0:没有，1：有）, 
		petrol: 贡献油值, 
		authorPhoto: 作者头像, 
		isVip：是否认证，（0：否，1：是）
		praiseCount：点赞数，
                hadPraise：已赞,

		dynaType:动态类型(1-普通帖子（旧数据包含提问帖子），2-说说动态，3-图片动态，4-提问帖子，5-公告动态，6-活动动态，7-新会员加入动态，8-创建车友会动态）
				
		//以上是动态列表公共字段
		//下面是根据不同的动态类型，返回不同的字段或内容
		dynaType == 1，4
		         dynaTargetId:帖子ID
		         content:帖子内容 
		         topicTitle: 帖子标题,
		         isPick: 是否是精华（0：不是，1：是，2：是）, 
		         isRecommend: 是否是推荐（0：不是，1：是）
				   
		dynaType == 2
			 dynaTargetId ：说说动态ID
			 content:说说内容
				   
		dynaType == 3
			 dynaTargetId ：相册ID
		         content:上传了100张相片到《相册名字》
				   
		dynaType == 5
                         content : 发布了公告：XXXXXXXXXXXX
				   
		dynaType == 6
			 dynaTargetId ：活动ID
			 content:发起了活动：活动标题
                         signUpCount:成功报名人数
                         activityCost:每人花费	
                         activityCover : 活动封面图
                 
                dynaType == 7
                         content : Hello，我已经加入了 + 车友会名字 + ，现在我是一个有组织的人了，欢迎大家来围观	
                 
                dynaType == 8 
                         content : 创建了+ clubName + 车友会主页： + targetUrl + , 大家快去邀请车友加入吧	

                dynaType == 9	
                        dynaTargetId: 动态ID
                        content : 投票标题
                        voteCount: 投票人数				   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]
}

1.11 wap社区首页热点推荐（app同城推荐用）

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/recommendedFocus.xsp?pageNo=1
请求参数：
||参数名||类型||必须||说明||
||pageNo||String||Y||页数||
||pageSize||String||N||每页显示条数||

说明：wap社区首页热点推荐{
    "data": [
        {
            "title": "【自驾游】边走边玩 哈弗车友走进呼伦贝尔草原享受欢乐时光",
            "url": "http://bbs.pcauto.com.cn/topic-6768933.html",
            "pic": "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syjian/1503/wapbandicheyouh.jpg",
            "summary": "6月10日，满洲里哈弗H6车友会组织车友自驾游，这是车友会第一次举办长途自驾游，此次共5辆车，14人参加活动。活动为期两天，在大家共同努力下，活动顺利完成！",
            "topicid": "6768933",
            "createAt": "15-02-27 10:50",
            "forumName": "哈弗H6论坛",
            "nickname": "满洲里哈弗车友会",
            "replyCount": 42,
            "viewCount": 6579
        },
        {
            "title": "【车友会福利25】进驻有福利 初建车友会升星赢6000话费",
            "url": "http://bbs.pcauto.com.cn/topic-6785692.html",
            "pic": "http://img0.pcauto.com.cn/pcauto/forum/club/activity/hdfocushot/1503/546-306_1.jpg",
            "summary": "新进驻中国车友会的你最有可能错过了哪些福利？如果没看到这个活动，你很可能错过6000元话费奖励！只要你的车友会在评选周期内升星并排名前6，只要你为车友会贡献的油值够多，你就有机会获得话费奖励！机会只留给有准备的人，你准备好了吗？",
            "topicid": "6785692",
            "createAt": "15-03-03 10:24",
            "forumName": "官方活动论坛",
            "nickname": "车友会活动公告",
            "replyCount": 354,
            "viewCount": 11418
        },
      
        {
            "title": "【新春活动】新春好礼不能停 一波奖品刮过来啦",
            "url": "http://bbs.pcauto.com.cn/topic-6745084.html",
            "pic": "http://img0.pcauto.com.cn/pcauto/forum/club/shequ/home/syfocus/1502/1xin.jpg",
            "summary": "马蹄声声扬鞭跑，羊年转眼要来到。活动君先祝各位车友羊年身体好，健健康康快乐绕。再祝事业节节高，阳关大道任你挑。还要祝你合家笑，幸福快乐在怀抱。祝你羊年无烦恼！新年红包还要抢？！扫扫二维码，刮刮幸运卡，中国车友会让你拿红包拿到手都软！",
            "topicid": "6745084",
            "createAt": "15-02-17 09:52",
            "forumName": "官方活动论坛",
            "nickname": "车友会活动公告",
            "replyCount": 41,
            "viewCount": 923
        }
    ],
    "totalPage": 10,
    "pageSize": 20,
    "pageNo": 3
}
}}

来源
说明：获取同城动态列表
接口：/appapi/2.0/dyna/getTongChengDynaList.do [GET]
请求参数：
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）


1.1.31 判断是否已赞
http://v37.pcauto.com.cn:82/appapi/1.0/dyna/getHadPraiseList.do [GET]
请求参数
userId:用户ID
dynaInfoIds：动态id列表，用“，”连接起来


返回
{
	code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本
        
        total:总条数
        pageNo:页码
        pageSize:每页条数
        pageCount:总共几页

	dynaList:[
	    {
	        dynaInfoId：动态id，
		postCount:回复数
		pubTime: 发布时间, 
		forumId: 板块ID, 
		forumName: 板块名称, 
		createBy: 创建者ID, 
		nickName:作者昵称,
		isHasImg: 是否有图片(0:没有，1：有）, 
		petrol: 贡献油值, 
		authorPhoto: 作者头像, 
		isVip：是否认证，（0：否，1：是）
		praiseCount：点赞数，
                hadPraise：已赞,

		dynaType:动态类型(1-普通帖子（旧数据包含提问帖子），2-说说动态，3-图片动态，4-提问帖子，5-公告动态，6-活动动态，7-新会员加入动态，8-创建车友会动态）
				
		//以上是动态列表公共字段
		//下面是根据不同的动态类型，返回不同的字段或内容
		dynaType == 1，4
		         dynaTargetId:帖子ID
		         content:帖子内容 
		         topicTitle: 帖子标题,
		         isPick: 是否是精华（0：不是，1：是，2：是）, 
		         isRecommend: 是否是推荐（0：不是，1：是）
				   
		dynaType == 2
			 dynaTargetId ：说说动态ID
			 content:说说内容
				   
		dynaType == 3
			 dynaTargetId ：相册ID
		         content:上传了100张相片到《相册名字》
				   
		dynaType == 5
                         content : 发布了公告：XXXXXXXXXXXX
				   
		dynaType == 6
			 dynaTargetId ：活动ID
			 content:发起了活动：活动标题
                         signUpCount:成功报名人数
                         activityCost:每人花费	
                         activityCover : 活动封面图
                 
                dynaType == 7
                         content : Hello，我已经加入了 + 车友会名字 + ，现在我是一个有组织的人了，欢迎大家来围观	
                 
                dynaType == 8 
                         content : 创建了+ clubName + 车友会主页： + targetUrl + , 大家快去邀请车友加入吧	

                dynaType == 9	
                        dynaTargetId: 动态ID
                        content : 投票标题
                        voteCount: 投票人数				   
				   
		images:[
		     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      },
                     {
			url:http://xxxx.jpg,
			//真实宽度
			width:960,
			//真实高度
			height:1000
		      }
	        ]
	   }
     ]
}

1.12官方活动

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/officialActivities.xsp?pageNo=1&pageSize=20
请求参数：
||参数名||类型||必须||说明||
||pageNo||String||Y||页数||
||pageSize||String||N||每页显示条数||


返回
{
    "data": [
        {
            "title": "车友会app4.0测试",
            "url": "http://bbs.pcauto.com.cn/forum-14758.html",
            "pic": "http://img0.pcauto.com.cn/pcauto/forum/club/app/active/1503/660-220_6.jpg",
            "summary": "车友会app4.0测试",
            "status": "报名中",
            "date": "2015-03-24到2015-05-01",
            "hot": "true"
        }
    ],
    "allPage": 1,
    "curPage": 1

1.13收到的回复

接口：http://mrobot.pcauto.com.cn/club/bbs/getClubReplyRemindsV46
说明：收到的回复（动态、图片）

请求参数：
请求参数：
||参数名||类型||必须||说明||
||pageNo||String||N||页数||
||pageSize||String||N||每页显示条数||
登陆信息通过session拿
是否登录:是
缓存时间:无
是否分页:有

返回
{
    "pageCount": 1,
    "pageNo": 1,
    "pageSize": 20,
    "resultList": [
        {
//图片评论
            "isPhotoReply":1//是图片评论
            "createTime": 1420426895000,
            "replyContent": "A?",
            "replyId": 2486411,
            "replyType": 2,
            "replyUserId": 32010420,
            "replyUserImg": "http://i1.3conline.com/images/upload/upc/face/32/01/04/20/32010420_50x50",
            "replyUserName": "xiechuyu",
            "targetId": 170364,//图片id
            "albumId":相册id
            "time": 1420426895506,
            "toReplyContent": "CUSLayout为iOS下提供托管定位机制。系统提供的绝对定位方式极... 方便使用，另外iPhone的4寸屏幕的出现和iPad令iOS开发者在布局需要花更多的时间",
            "toReplyId": 2112279, 
            "urlBig":"http://dev2.pconline.com.cn:9191/upcfiles/autoclub/1503/25/c2/12271_1427274709956_700.jpg";
            "urlSmall":"http://dev2.pconline.com.cn:9191/upcfiles/autoclub/1503/25/c2/12271_1427274709956_144x144.jpg";
        },
        {
//动态评论
            "dynaInfoId":1244391;//动态id
            "dynaTargetId":1244391;//动态实际内容id，例如活动为活动id，投票为投票id，帖子则返回targetId (兼容版本,以前版本没有dynaTargetId)
            "createTime": 1420362723000,
            "replyContent": "E",
            "replyId": 2462236,
            "replyType": 2,
            "replyUserId": 32010420,
            "replyUserImg": "http://i1.3conline.com/images/upload/upc/face/32/01/04/20/32010420_50x50",
            "replyUserName": "xiechuyu",
            "targetId": 224848,
            "time": 1420362723461,
            "toReplyContent": "Hoop[em2004]",
            "toReplyId": 224848
        }
    ],
    "total": 2
}帖子回复和动态回复要求对应返回字段一致

来源bip，图片评论typeId为2060,2061,2064,2065
后端接口：
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&status=-1&typeIds=2060,2061,2064,2065&noTemplate=true&pageNo=1&pageSize=20

1.14 动态详情

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/dyna_detail.xsp
请求参数：
	*dynaInfoId：动态id
	*createBy：动态创建者id
        *userId: 当前用户的id，用于判断该用户是否已赞

{
	code:0成功，-1失败
        message:提示信息
        version: 接口版本号如1.0，1.0（latest)表示最新版本

	dynaDetail:[
		{
	    postCount:回复数
	    pubTime: 发布时间, 
            authorId: 作者ID, 
            forumId: 16160, 
            authorName: 作者名称, 
            nickname:作者昵称,
            contribution: 贡献油值, 
            dynaInfoId,动态ID
            authorPhoto: 作者头像, 
            isRecommend: 是否是推荐,
            content:动态内容
	    isVip：是否认证	(0:未认证,1:已认证)
	    praiseCount：点赞数,
            images:[
		{
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000,
		//质量参数,默认为0，10月上线
		qua:80
		},
                {
		url:http://xxxx.jpg,
		//真实宽度
		width:960,
		//真实高度
		height:1000,
		//质量参数,默认为0，10月上线
		qua:80
		}		
	   ]
	}
    ]
}






后端接口
1.4.13 获取动态详情接口
说明：获取动态
接口：/appapi/2.0/dyna/getDynaDetail.do [GET]

1.1.31 判断是否已赞
接口：/appapi/1.0/dyna/getHadPraiseList.do [GET]
返回增加
hadPraise：已赞,
当前用户是否已赞字段

1.15 获取照片列表里用户是否已关注

接口：http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/praiseUserFocus.xsp?accountId=34321753&photoId=141438
请求参数：
	*photoId：照片ID
        *accountId: 当前用户的id，用于判断该用户是否已关注

{
   code: 0,
   message: "操作成功",
   pageCount: 1,
   pageNo: 1,
   pageSize: 20,
   total: 3,
   userList: [
    {
      nickName: "小鳗鱼",
      userId: 28999678,
      hasFocus: 1 // 1：已关注 0：未关注
    },
    {
      nickName: "秋秋",
      userId: 34321753,
      hasFocus: 0
    },
   {
     nickName: "秋qq",
     userId: 33589794,
     hasFocus: 1
    }
   ],
   version: "v1.0(latest)"
}

后端接口
1.2.17 获取照片点赞用户列表
接口：/appapi/1.0/photo/getPraiseUserList.do [GET]
说明：获取照片点赞用户列表
请求参数
	*photoId:照片ID

1.1.31 判断是否已关注
trac: http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3
接口URL:http://bip.pcauto.com.cn/intf/focus.jsp
必填参数：
    act：getLimitFocusIds
    accountId：指定用户id
返回结果：
    失败：{"code":-1,"message":"缺少参数"}
    成功：[123,456,789......]

1.16 个人中心收到的赞（动态与图片混合）

此接口是做给个人中心用的
接口http://mrobot.pcauto.com.cn/xsp/s/club/v4.0/individualCenterPraiseList.xsp?pageNo=1&pageSize=3[GET]
是否登录:是

请求参数：
||参数名||类型||必须||说明||
||pageNo||String||Y||页数||
||pageSize||String||Y||每页显示条数||
{
	"code": 0,
	"message": "操作成功",
	"pageCount": 1,
	"pageNo": 1,
	"pageSize": 20,
	"praiseList": [{
		"content": "上传了1张相片到<a href='http://dev18.pcauto.com.cn/dynaclub/album/a7752-photo/'>《好多好多》</a>",
		"createDate": "2015-03-06",
		"dynaInfoId": 1241333,
		"dynaTargetId": 7752,
		"dynaType": 3,
		"hadRead": 0,
		"images": [
                  {
			"height": 938,
			"qua": 0,
			"url": "http://dev2.pconline.com.cn:9191/upcfiles/autoclub/1503/06/c0/9221_1425605119123.jpg",
			"width": 700
		  } ],
		"isVip": 0,
		"nickName": "test",
		"praiseTime": 1421307228000,
		"userId": 9685789
	},
	{
		"albumId": 7856,
		"hadRead": 0,
		"isVip": 1,
		"nickName": "test_xl3",
		"photoId": 55055,
		"praiseTime": 1426070430000,
		"userId": 30261200
	}],
	"total": 17,
	"version": "v1.0(latest)"
}}
注：新接口中按照praiseTime 升序排列展示
后端接口：
//收到赞我的照片列表
http://club.pcauto.com.cn/appapi/1.0/dyna/getPraiseList.do
// 收到赞我的照片列表
http://club.pcauto.com.cn/appapi/1.0/photo/getPraiseList.do

然后要调用一下后端接口去清楚已经看过的点赞
http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0#a1.1.28未读点赞清零

http://rdtrac.pc.com.cn/autoclub/wiki/appapi/4.0#a1.2.16未读照片点赞清零

其他

同城推荐（论坛同事看）

参考
http://bbs.pcauto.com.cn/intf/topics.do?tids=5362127
返回字段
[
   {
       "createAt": 1411878476000,//创建时间
       "fid": 19017,//论坛id
       "lastPostAt": 1421916788000,//最后回复时间
       "nickName": "jiangyun22",//作者昵称
       "replyCount": 24,//回复数
       "tid": 5362127,//帖子id
       "title": "shishi",//帖子标题
       "uid": 32394272,//作者id
       "uri": "http://bbs.pcauto.com.cn/topic-5362127.html",//帖子url
       "userName": "jiangyun24",//作者真名
       "view": 102//阅读数
       "forumName"://论坛名字
   },
   ...
]

PV统计

1.5.1 添加车友会pv
接口：/appapi/1.0/club/addVisitorPv.do [POST]

Download in other formats:

Plain Text

Context Navigation

Table of Contents

1. 投票相关

1.1用户发布投票

1.2用户投票

2.相册相关

2.1创建相册列表

2.2根据id返回相册列表

2.3上传图片

2.4设置封面

2.5删除照片

2.6删除相册

2.7 评论照片

2.8 获取照片评论

2.9 照片点赞/取消赞

2.10 照片点赞列表

3.活动相关

3.1 发布/更新活动

3.2 删除活动

3.3 活动报名

3.4 活动审核

3.5 活动审核列表

3.6 活动报名列表

3.7 取消活动报名

4.首页相关

4.1 签到列表

4.2 设置动态置顶

4.3 取消动态置顶

4.4 删除动态

5.1 会员卡

mrobot合并

1.1投票详情

1.2 活动列表

1.3 活动详情

1.4 活动成员列表

1.5 相册首页列表

1.6车友会首页

1.7 照片详情（赞、评论）

1.8 车友会论坛列表

1.9 收到的赞（动态与图片混合）

1.10 同城动态列表

1.11 wap社区首页热点推荐（app同城推荐用）

1.12官方活动

1.13收到的回复

1.14 动态详情

1.15 获取照片列表里用户是否已关注

1.16 个人中心收到的赞（动态与图片混合）

其他

同城推荐（论坛同事看）

PV统计

Download in other formats: