[[TOC]] == 1.基本约定 == {{{ 通用接口请求参数: req_enc=utf-8 请求参数编码 resp_enc=utf-8 响应返回编码 common_session_id=xxxx 用户登录凭证,如果接口需要登陆则生效 pageNo=1 请求页码(>=1),如果接口返回有分页处理则生效 pageSize=20 请求页长度,默认20,如果接口返回有分页处理则生效 通用接口返回参数: total:18 返回记录总条数,如果接口返回有分页处理则生效 pageNo:1 返回页码(>=1),如果接口返回有分页处理则生效 pageSize:20 返回页长度,如果接口返回有分页处理则生效 测试接口前缀:http://dev18.pcauto.com.cn:8003 上线接口前缀:http://club.pcauto.com.cn 名词解释 接口URL: 接口URL 接口说明: 描述接口的应用场景 请求参数:参数名=xxx 是否登录:是|否,表示接口是否要登陆才能访问 是否分页: 是|否,表示返回的列表有分页处理 缓存时间:xx,设置Response Http Headers Cache-Control:max-age=xx(单位/秒) 返回结果:成功返回结果示例 全局接口返回格式:json 全局接口错误格式: { code:0 //错误代码,0:正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆 message: “您还没有登陆” //错误提示 } }}} == 2.接口列表 == === 2.1 车友会详情接口 === {{{ 整合到:2.4车友会搜索接口 根据车友会ID返回车友会详情 获取车友会二维码接口 http://车友会域名/util/clubQrCode.jsp?clubId=车友会id }}} === 2.2车友会信息与已加入的车友会权限列表接口 === {{{ 接口URL:/club/getJoinedClubList.do 说明:获取车友会信息与已加入的车友会权限列表 请求参数: uid:用户ID,如果不传,默认是当前登录用户ID 是否登录:是 缓存时间:无 是否分页:是 返回结果: {"data":[ { "clubId":车友会ID, "clubStatus":车友会状态(是否被锁之类) "name":车友会名称, "logo":logo的URL, "introduce":简介, "brandId":品牌ID, "brandName":品牌名称, "seriesId":车系ID "seriesName":车系名称, "cityId":城市ID, "cityName":城市名称, "provinceId":省份ID, "provinceName":省份, "rank":全国排名,为0时,表示暂时没有排名, "reginRank":区排名,为0时,表示暂时没有排名, "memberNum":会员总人数, "vipNum":认证总人数, "totalPetrol":总油值, "level":等级ID, "addressPhone":收货地址——联系号码, "addressUserName":收货地址——联系人, "addressProvinceId":收货地址——省份ID, "addressProvinceName":收货地址——省份名称, "addressCityId":收货地址——城市ID, "addressCityName":收货地址——城市名称, "addressDetail":收货地址——详细地址, "addressPostcode":收货地址——邮编, "adminType":成员角色 "memberId":会员ID "userName":用户名称 "userNikeName":用户昵称 "userPhone":用户电话 "userCar":用户爱车 "userProvince":用户所在省 "userCity":用户所在市 "userGener":用户性别,性别,0:男,1:女 } ] } adminType说明:-3->当前车友会审核当中 -2->加入其他或者其他车友会审核当中 -1->游客 0->普通会员 1->副会长 2->会长, }}} === 2.3首页车友会列表接口 === {{{ 接口URL:/club/getClubByUIdOrRegionId.do 说明:如果用户已登陆并且有加入车友会则返回用户已加入的车友会列表,否则根据IP地址判断用户所在地,并返回所在地车友会列表 请求参数: userId (可选参数) provinceId:地区id cityId:地区id(只有一层,如澳门,只传的provinceId) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "userId": 用户ID[地区ID], //已加入车友会数据 "data": [ { "logo": 车友会会标 "clubStatus":车友会状态(是否被锁之类)0未审核 1已审核 2拒绝 3被封 4锁定 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ], //推荐数据 "recommendData": [ { "logo": 车友会会标 “ clubStatus”:车友会状态 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 } ], //审核中车友会 “applyData”:[ { "logo": 车友会会标 "clubStatus":车友会状态(是否被锁之类) "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 “adminType”:成员角色//说明参考2.2 ”isCheck“:true/false 是否签到 } ] } }}} === 2.4车友会搜索接口 === {{{ 接口URL:/club/getClubByCityOrRegionId.do 说明:搜索,精确查找,根据id查找,根据主题查找 请求参数: provinceId:省id cityId:城市ID(无则无须传cityid) brand:品牌id seriesId:车系ID clubName:车友会名称 clubId:车友会ID userId:用户ID(可选) tagId:主题id 是否登录:否 缓存时间:无 是否分页:是 返回结果: "data": [ { "logo": 车友会会标 “clubBackgroundImg”://顶部背景图片url “levelupTip”:升级提示,0-》不可升级,1-》可升级 “applyCount”:待审核人数, “presidentName”:会长昵称 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubStatus":车友会状态(是否被锁之类) "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 "adminType":成员角色//说明参考2.2 "isCheck":true/false 是否签到 "forumId":论坛id,用于发帖 } ] }}} === 2.5车友动态接口 === {{{ 接口URL:/topic/listTopicByClubId.do 说明:根据车友会ID,返回车友动态列表 请求参数: clubId:车友会ID imagesType:1//图片返回形式,1.2.0需求修改,兼容旧版本,加参数判断,为1时返回参数增加下面这个字段,里面是数组,旧的image1 image2 image3字段的无须返回,不传或其他情况需要返回该3个字段 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "clubId": clubId, "data": [ { "postCount":回复数 "pubTime": 发布时间, "topicTitle": 帖子标题, "forumName": 板块名称, "isPick": 是否是精华, "authorId": 作者ID, "isHasImg": 是否有图片, "image2": 第二张图, "image1": 第一张图, "forumId": 16160, "authorName": 作者名称, "nickname":作者昵称, "contribution": 贡献油值, "topicId": 帖子ID, "authorPhoto": 作者头像, "image3": 第三张图, "isRecommend": 是否是推荐, "images":[ { “url”:http://xxxx.jpg, //真实宽度 “width”:960, //真实高度 “height”:1000 }, { “url”:http://xxxx.jpg, //真实宽度 “width”:960, //真实高度 “height”:1000 } ] } ] } }}} === 2.6车友会相册列表接口 === {{{ 接口URL:/album/getAlbumByClubId.do 说明:根据车友会ID,返回相册列表 请求参数: clubId:车友会ID userId (可选参数) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "clubId": 车友会ID, "clubName": 相册名称, “adminType”:成员角色//说明参考2.2 "data": [ { "photos":[ { "urlsmall":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_160x120.jpg", "urlbig":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_700.jpg" }], "albumName":"默认相册", "albumId":171, "photoSize": 相片数, "coverurlsmall":"http://dev2.pconline.com.cn:9191/autoclub/1403/27/c0/1195694_1395912475624_160x120.jpg",//封面图片 } ] } }}} === 2.7相册图片列表接口 === {{{ 接口URL:/album/getPhotoByAlbumId.do 说明:根据相册ID返回相片列表 请求参数: albumId:相册ID userId (可选参数) 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "albumId": 相册ID, "albumName": 相册名称, “adminType”:成员角色//说明参考2.2 "data": [ { "urlsmall":小图地址, "urlbig":大图地址 } ] } }}} === 2.8上传图片接口 === {{{ 接口URL:/album/uploadPic.do 说明:上传图片到车友会指定相册 请求参数: albumId:相册ID userId:用户id,从登录信息取 urls : 格式:名称@路径@尺寸,多张图片以”,”分割(上传原图url) 如 abc@http://123.png@100x150 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.9创建相册接口 === {{{ 接口URL:/album/updateSaveAlbum.do 说明:创建(修改)相册名称 请求参数: clubId:车友会ID userId:用户ID,从登录信息取 albumId:相册ID[若有ablumId,则为修改,为0,则为创建] name;相册名称 是否登录:是 缓存时间:无 是否分页:否 返回结果: { code:0, message:失败描述 albumId:相册ID } }}} === 2.10车友会活动列表接口 === {{{ 接口URL:/activity/listActivityByClubId.do 说明:根据车友会ID,返回该车友会活动列表 请求参数: clubId:车友会ID userId:用户Id(可选参数) 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "clubId": "clubName": "data":[ { "activityId":活动ID "title":活动标题 "signupDate":报名截至时间 "endDate":活动截至时间 "pic":活动封面图 "place":活动地址 "beginDate":活动开始时间 "isSignUp":是否报名 “limitCount”:人数限制 “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 "statusCode":状态码 } ] } 活动状态码说明 火热报名中 101 报名已结束(人数上限) 102 报名已结束(时间过截止时间) 103 活动进行中 104 活动已结束 105 审核中 201 取消报名 --- 无 已报名 203 活动不存在 100 }}} === 2.11活动详情与报名人员名单接口 === {{{ 接口URL:/activity/getActivityById.do 说明:返回活动详情及活动报名人员名单 请求参数: activityId:活动ID userId(可选参数,如果已登陆) 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "activityId": 活动ID, “adminType”:成员角色//说明参考2.2 "memberId":会员Id, "clubId":车友会ID, "content":活动内容, "createAt": 创建时间, "title": 活动标题, "signupDate": 报名截止时间, "money": 活动费用, "isSignUp":是否报名, "place": 活动地点, "createBy": 创建者, "endDate": 活动结束时间, "beginDate": 活动开始时间, “limitCount”:人数限制 “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 “statusCode”:活动状态code//参考2.10 “applysCount”:待审核人员数 "data":[ { “userId”:用户id "name":用户名称 "nickname":用户昵称 "joinNum":参加人数 "phone":联系电话 "pic":头像 "lincensePlate":车牌号 "descript":备注信息 } ] } }}} === 2.12活动报名接口 === {{{ 接口URL:/activity/applyActivity.do 说明:活动报名 请求参数: activityId:活动ID userId:用户ID,从登录信息中取 name;真实姓名 phone:联系电话 joinNum:参加人数 lincensePlate;车牌号 descript:备注信息 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.13车友会成员列表接口 === {{{ 接口URL:/member/getMemberByClubId.do 说明:获取车友会成员列表接口 请求参数: clubId:车友会ID isShowAdmin:1 //1 区分管理和会员,0 不区别,建议是用0 是否登录:是 缓存时间:无 是否分页:是 返回结果: { "clubId": 车友会ID, “adminType”:成员角色//说明参考2.2 "admins": [{管理员 "name": 用户名称, "nickname":用户昵称, "truename":申请真实姓名, "userId": 用户ID, "memberId": 用户ID, "type": 用户类别[0:会员,1:副会长,2,会长] "photo": 用户头像地址 "phone":电话号码 "vipInfo":爱车 "province":省份 "city":城市 }], "members": [{普通会员,分页在此生效 "name": 用户名称, "nickname":用户昵称, "truename":申请真实姓名, "userId": 用户ID, "memberId": 用户ID, "type": 用户类别[0:会员,1:副会长,2,会长] "photo": 用户头像地址 "phone":电话号码 "vipInfo":爱车 "province":省份 "city":城市 }], "applys": [待审核人员 { "name": "申请人名称", "nickname":用户昵称, "truename":申请真实姓名, "userId": 申请人ID, "memberId": 用户ID, "photo":申请人头像 "phone":电话号码 "vipInfo":爱车 "province":省份 "city":城市 }] } }}} === 2.14车友会成员管理接口 === {{{ 接口URL:/member/operation.do 说明:车友会成员管理 请求参数: clubId:车友会ID targetId:操作用户memberId,如果操作者自己的memberId,并且type=4则表示退出该车友会,type=5表示取消审核中车友会申请 type:操作类型,1--转让会长,2--设置副会长,3--解除职务,4--移除车友会 5--取消审核中车友会申请 type=5时,targetId为用户id 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.15车友会入会接口 === {{{ 接口URL:/member/apply.do 说明:加入车友会 请求参数: clubId;车友会ID truename:真实姓名 gender:性别(0:男,1:女) provinceName:省 cityName:市 phone:联系电话 brand:品牌ID serial:车系ID brandName:品牌名称 serialName:车系名称 是否登录:是 缓存时间:无 是否分页:否 返回结果: { status:-1>处理错误 0>成功 1>没有权限,没有登录 2>参数错误 3>不符合处理条件 desc:信息提示 } }}} === 2.16车友会留言列表接口 === {{{ 接口URL:/comment/listCommentByUserClubId.do 说明:获取车友会最新留言与我的留言 请求参数: clubId:车友会ID targetId:用户id(可选,如果传入,则为该用户的留言,不传入,则为车友会留言,区分下面的字段) 备注:请求用户信息从cookies里面获取 是否登录:否 缓存时间:无 是否分页:是 返回结果: { “adminType”:成员角色//说明参考2.2 "data": [ { "msgId":ID "image1big":图片1大图, "image2small": 图片2小图, "image1small":图片1小图, "createAt": 发表留言时间, "image2big": 图片2, "userId": 用户ID, "userName": 用户姓名, "msg": 留言信息, "replays": [ { "replayId":回复ID, "replyUserId":回复用户ID, "replayName": 回复人名称, "replayContent":回复内容, "createAt": 回复时间, "image1big": 图片1大图, "image2big": 图片2大图, "image1small": 图片1小图, "image2small": 图片2小图, } ] } ], "clubId": 车友会ID, "clubName": 车友会名称 } }}} === 2.17创建留言与回复留言接口 === {{{ 接口URL:/comment/addComment.do 说明:创建与回复留言 请求参数: clubId:车友会ID content:回复内容 replyId:回复留言的ID(可选) imgUrl1 :上传图片1(可选) imgUrl2 : 上传图片2(可选) 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.18创建车友会接口 === {{{ 接口URL:/club/createClub.do 说明:创建车友会接口 请求参数: clubName:车友会名称 clubUrl:车友会自定义域名(域名后面一截就行) provinceId:省ID provinceName:省名称 cityId:城市ID cityName:城市名称 brandId:品牌ID brandName:品牌名称 seriesId:车系ID seriesName:车系名称 introduce:简介 realName:姓名 gender:性别(0:男,1:女) birthday:出生日期 clubAddressCityId:城市ID clubAddressCityName:城市名称 clubAddressProvinceId:省ID clubAddressProvinceName:省 postCode:邮编 address:地址 phone:联系电话 qqGroup:Q群号 code:验证码 agree:是否同意 type:车友会类型 1-》地区 2-》车系 3-》主题 themeId:主题类型id,看主题列表接口返回的id appBanner:车友会背景URL 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.19修改车友会接口=== {{{ 接口URL:/club/editClub.do 说明:修改车友会资料 请求参数: clubId:车友会ID userId:用户Id,从登录信息取 editType:1》会标修改,2》宣言修改,3》公告修改 4》顶部背景 content:修改内容(url/宣言/公告/顶部背景,传url) 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.20域名合法校验接口 === {{{ 接口URL:/club/checkClubUrl.do 说明:检查车友会域名是否可用 请求参数: clubUrl:自定义域名 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.21车友会名合法校验接口 === {{{ 接口URL:/club/checkClubName.do 说明:检查车友会名称是否可用 请求参数: name:车友会名称 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.22获取手机验证码接口 === {{{ 接口URL:http://passport2.pconline.com.cn/passport2/api/sendVerificationCode.jsp?resp_enc=utf-8 测试环境:http://test232.pchouse.com.cn:7003/passport2/api/sendVerificationCode.jsp?resp_enc=utf-8 说明: 1.必须post提交; 2.Http Referer = appAutoClub; 3.同一ip一分钟之内可以发一次; 4.同一ip一天之内只能发5次(目前的设定); 5.同一个手机号码一天之内只能发5次(目前的设定); 参数: act = getPassword mobile= 手机号 (以下两个参数为必填,为了防刷而添加的,vCodeKey为通过特定的MD5加密,VCodeTime为系统当前时间) vCodeKey = 在出调用该接口页面前的java代码中生成 VCodeTime = 为系统当前时间 //取系统当前时间再和指定key做md5加密 String Vkey = "sendVerificationCode.jsp"; long VCodeTime =System.currentTimeMillis(); String vCodeKey = T.md5(Vkey + VCodeTime); request.setAttribute("VCodeTime", VCodeTime); request.setAttribute("vCodeKey", vCodeKey); //end匹配加密信息 返回值: {"code":-1, "message":"...各种情况.."} {"code":0, "message":"发送验证码成功,手机号:1111111"} }}} === 2.23中国车友会管理条例页面 === {{{ 接口页面:http://www.pcauto.com.cn/forum/club/rule/ }}} === 2.24车友会签到接口 === {{{ 接口URL:/checkIn.do 说明:用户签到车友会 请求参数: clubId:车友会ID agent:1 userId:用户ID,从登录信息取 是否登录:是 缓存时间:无 是否分页:否 返回结果: { status:0, desc:{ continuousCheckIns:连续签到次数, totalCheckIns:总签到次数, petrol:签到加分值 } } 失败返回: { status:非0,//-1处理错误;1没有权限/登陆;2参数错误;3不符合处理条件 desc:"错误信息" } 被锁后签到依然作为成功返回,petrol字段返回0,app判断为0显示文案为已锁之类的 }}} === 2.25编辑推荐论坛接口 === {{{ 测试接口URL:http://v15.pcauto.com.cn/intf/hotForums.do 正式接口URL:http://bbs.pcauto.com.cn/intf/hotForums.do 说明:获取编辑推荐 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "data":[ { "forumId":"论坛ID", "lastTopicTitle":"最新标题", "logo":"论坛logo", "forumName":"论坛名称", "todaypostcount":今日回复贴总数 } ] } }}} === 2.26论坛新帖数与新帖标题接口 === {{{ 合并到接口:2.34 }}} === 2.27论坛相关车友会接口 === {{{ 接口URL:/club/countClubByForumId.do 说明:根据论坛ID返回论坛相关车友会数量 请求参数: forumId:论坛ID userId:用户id(可选) 是否登录:否 缓存时间:无 是否分页:否 返回: {total:车友会个数} -------------------------------------------- 接口URL:/club/listClubByForumId.do 说明:根据论坛ID返回论坛相关车友会 请求参数: forumId:论坛ID 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "data": [ { "logo": 车友会会标, "clubStatus":车友会状态(是否被锁之类) "announcement":公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce":简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId": 车友会ID, "level": 等级ID, "seriesName": 车系名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name": 车友会名称, "levelName": 等级名称, "albumSum": 相册数, "activityName": 最新活动名称, “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ] } }}} === 2.28同城车友会列表接口 === {{{ 接口URL:同2.4 }}} === 2.29车友会排行榜接口 === {{{ 接口URL:/club/listTopClubWeekly.do 说明:top10认证人数,全国油值排行榜 请求参数: type:0:上周新增认证人数排行,1:上周新增油值排行 2全国排名 3车系排名 4地区排名 userId:用户id(可选) showType:是否需要返回后面数组,用于首页排行榜是否有变化显示,0则返回下面所有信息,1则只返回排名变化(前六个字段),默认0 是否登录:否 缓存时间:无 是否分页:否 返回结果: { “rank”:全国排名 “rankAsc”:全国排名上升多少,下降则为负数 “brandRank”:车系排名 “brandRankAsc”:车系排名上升多少,下降则为负数 “provinceRank”:地区排名 “provinceRankAsc”:地区排名上升多少,下降则为负数 以上信息假设user对应无加入车友会则不返回 "data": [ { "logo": 车友会会标 “clubBackgroundImg”://顶部背景图片url “levelupTip”:升级提示,0-》不可升级,1-》可升级 “applyCount”:待审核人数, “presidentName”:会长昵称 "clubStatus":车友会状态 "announcement": "内容含有敏感词,已屏蔽", "memberSum": 公告, "cityName": 市, "commentSum": 留言数, "introduce":简介 "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "level": 等级ID, "seriesName": 车系名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "activityName": 最新活动名称 weekPetrol:上周新增油值(当type为1是有值) weekVipNum:上周新增认证人数(当type为0是有值) “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ] //前20 "clubIndexData": [ { "logo": 车友会会标 "clubStatus":车友会状态 "announcement": "内容含有敏感词,已屏蔽", "memberSum": 公告, "cityName": 市, "commentSum": 留言数, "introduce":简介 "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "level": 等级ID, "seriesName": 车系名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "activityName": 最新活动名称 weekPetrol:上周新增油值(当type为1是有值) weekVipNum:上周新增认证人数(当type为0是有值) “adminType”:成员角色//说明参考2.2 "isCheck": true/false 是否签到 } ] //user所加入车友会前后两个,自己,后面两个 } }}} === 2.30 取消活动报名接口 === {{{ 接口URL:/activity/cancelActivity.do 说明:取消活动报名 请求参数: activityId:活动ID 是否登录:是 缓存时间:无 是否分页:否 返回结果: {code:0} }}} === 2.31 获取城市列表 === {{{ 接口URL:http://my.pcauto.com.cn/intf/jsonArea.jsp 说明:获取城市列表 请求参数:无 是否登录:否 缓存时间:无 是否分页:否 返回结果: { "areas":[ { "citys":[ { "cityName":"东城区", "cityCode":110101 }], "areaName":"北京市", "areaCode":110000 }] } }}} === ~~2.32 根据IP获取城市ID~~ === {{{ app需要产品库对应地区,旧接口使用ip库,2.0.0版本已融合到接口2.3中,不需要额外拿地区,已废弃 接口URL:http://my.pcauto.com.cn/intf/getAreaIdByIp.jsp 说明:根据IP获取城市ID 请求参数: 是否登录:否 缓存时间:无 是否分页:否 返回结果: { areaName:省名称 areaCode:省编码 cityName:城市名称, cityCode:城市编码, ip:ip地址 } }}} === 2.33 入会审核接口 === {{{ 接口URL:/member/audit.do 说明:管理员对申请加入车友会的成员进行审核 请求参数: clubId;车友会ID action:1:通过,-1:拒绝 applicationId:申请人memberId 是否登录:是 缓存时间:无 是否分页:否 返回结果: { status:-1>处理错误 0>成功 1>没有权限,没有登录 2>参数错误 3>不符合处理条件 desc:信息提示 } }}} === 2.34 获取论坛最新帖子接口 === {{{ 测试接口URL:http://v15.pcauto.com.cn/intf/common/_block_forums_app.jsp 正式接口URL:http://bbs.pcauto.com.cn/intf/common/_block_forums_app.jsp 说明:管理员对申请加入车友会的成员进行审核 请求参数: fids:板块ID,多个“,”分隔 callback:json 必须 是否登录:是 缓存时间:无 是否分页:否 返回结果: { "data":[ { "count": 今天提交贴, "forumId": 板块ID, "forumName": "板块名称", "logo": "板块图标", "lastTopicAuthor": { "authorId": 最后回复作者ID, "name": "最后回复作者名称", "nickname": "最后作者昵称", "url": "头像" }, "lastTopicCreateAt": "最后回复时间", "lastTopicId": 最后回复ID, "lastTopicTitle": "最后发表主题", "lastTopicUrl": "最后发表主题链接", "posts": 提交总数, "todayNewtic": 今日新帖, "topics": 主题帖总数, "url": "板块URl" } ] } }}} === 2.34(编号重复了,注意一下) 获取用户已参加活动列表接口 === {{{ 接口URL:/activity/listActivityByUserId.do 说明:根据用户ID返回该用户已经参加的活动列表 请求参数: userId:用户ID 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "userId": 用户ID, "pageNo": 当前页数, "pageSize": 分页代销,   "clubName": "车友会名称",   "total": 活动总数, "data": [ { "clubId": 车友会ID, "clubName": "车友会名称", "activityId": 活动ID, "title": "活动标题", "signupDate": "报名截止时间", "pic": "活动封面图", "place": "活动地址", "endDate": "活动结束时间", "beginDate": "活动开始时间" "statusMsg":活动状态 "statusCode":活动状态码//参考2.10 } ] } }}} === 2.35 图片上传接口 === {{{ 接口URL:http://upc.pcauto.com.cn/upload_quick.jsp 说明:通用图片上传接口,包括车友会会标,留言,论坛等 请求参数: application:yidong 是否登录:是 缓存时间:无 是否分页:否 成功返回: { retCode: 0, tid:xxx, files:[ {rid:xxx, fileName:xxx, url:xxx, orgFileName:xxx, width, height} ] } 失败返回:{retCode: xxx} 留言增加居中正方形截图指令53013 }}} === v2.1.0新增 === === 2.36 ip获取地区接口 === {{{ url:http://my.pcauto.com.cn/intf/getAreaIdByIp.jsp 无请求参数,后台根据请求链接获取ip 返回 { areaCode:省id areaName:省名字 cityCode:城市ID//如无城市,则id为0 cityName:城市名字//无则为空字符串 ip:ip地址 } }}} === 2.37 活动审核列表 === {{{ url:/activity/listActivityAudit.do 是否分页:否 是否登陆:是 是否缓存:否 请求参数: activityId:活动id common_session_id 返回 { data:[ userId:用户id nickname:昵称 memberId:申请人ID name;真实姓名 phone:联系电话 joinNum:参加人数 lincensePlate;车牌号 descript:备注信息] } }}} === 2.38 活动审核操作(通过、拒绝) === {{{ url:/activity/auditActivity.do 是否登录:是 是否分页:否 是否缓存:否 请求参数: activityId;车友会ID action:1:通过,-1:拒绝 targetId:申请人memberId 返回结果: { code://增加1004为人数上限,需要app写文案 message: } }}} === 2.39 发现首页活动焦点图(CMS) === {{{ url:http://www.pcauto.com.cn/forum/club/activeapp/ 是否分页:无 是否缓存:无 是否登陆:无 请求参数:无 返回 { activelist:[ “img”:图片url, “title”:标题, “url”:”http://bbs.pcauto.com.cn/topic-123.html //只含帖子与专题两种,专题用PC端接口,判断http://bbs.pcauto.com.cn/topic- 为帖子,其他弹全屏webview,需求方确认结果 createBy: //创建者Id 以下二个参数用于跳转动态详情终端页。 dynaInfoId: //动态Id ] } 编辑录入可配置title url,默认于网站一致 }}} === 2.40 热门活动日记 === {{{ url:/activity/listHostActivityDiary.do 是否登陆:否 是否分页:否 是否缓存:是 请求参数: size:接口返回多少条数据(最大不能超过50) 返回: 返回结果: { "data": [ { “clubName”:车友会名字 “clubId”:车友会id "title": 帖子标题, "image1": 第一张图, "image2": 第二张图, "image3": 第三张图, //小于等于3张 "topicId": 帖子ID, "pubTime": 自定义时间, "nickname":昵称 "userId": } ] } }}} === 2.41 获取车友会操作权限(报名 创建) === {{{ url:/club/getOperateAuthority.do 请求参数 userId:用户id clubId:车友会id//判断能否创建传clubId为0 返回 { “clubId”:车友会Id “adminType”:成员角色//说明参考2.2 “message”:无法申请加入车友会原因文案 } }}} === 2.42 判断能否申请加入活动(只有申请加入活动才调用) === {{{ url:/activity/isJoinActivity.do 是否登录:是 是否分页:否 是否缓存:否 请求参数: activityId;活动ID targetId:申请人memberId 返回结果: { “statusMsg”:状态名字,服务器返回显示火热报名,已报名等状态的文字,app建议直接读取这个新的字段显示 "statusCode":状态码//参考2.10 } }}} === 2.43 推送设置接口 === {{{ url:/interface/club/do_autoClubUserApp.jsp 参数: userId://用户id,登出则不传本参数 token://设备token ids: //1,0,1 字符串,顺序表示帖子回复,私信,系统通知,1为打开,0为关闭 beginTime:(如果勿扰模式关闭了,就不传此字段)02:00传02 23:00传23 endTime:(如果勿扰模式关闭了,就不传此字段)02:00传02 23:00传23 open: (1发推送,0不发推送) sound:(1为有声音,0为无) shake:(1为有振动,0为无) 请求方法:post 是否需要登录:是 返回参数: { "description":"token或者ids为空",//错误详情 "status":0; (0:成功 -1:ids不正确或者日期格式不正确 -2:token为空或者ids为空 -3:提交方式不对,请改用Post提交 -4:设置失败) } }}} === 2.44可选车友会顶部背景图列表 === {{{ 接口:/club/listAppBanner.do 说明:可选车友会顶部背景图列表 是否登录:否 缓存时间:无 是否分页:是 返回结果: "data": [ { “id”:背景id “title”:背景文字 “img”:背景图片url,提交保存用 "thumbImg":列表显示图 }, { “id”:背景id “title”:背景文字 “img”:背景图片url,提交保存用 "thumbImg":列表显示图 } ] }}} === 2.45获取最新消息数 === {{{ 接口:http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount 说明:获取最新未读数 返回: { ACNewMsgSender:0 未读收到回复动态用户名 articleCmtCount:0 autoClubDynaCount:0 未读新发动态(暂无作用,动态未读请用autoClubNewsfeedCount) autoClubNewMsg:0 未读收到动态内容; autoClubNewTime:1414489274000; autoClubNewsfeedCount:5 未读收到回复动态; autoClubTaskCount:0 ; carReplyCount:0; commentReplyCount:0; fansCount:29; forumReplyCount:0 未读收到帖子回复数; forumReplyNewMsg: 未读收到帖子回复内容; forumReplyNewTime:1411910575000 未读收到帖子回复时间; forumReplySender:xiechuyu 未读收到帖子回复作者; forumReplySenderID:32010420 未读收到帖子回复作者id; messageCount:0 未读收到私信数; messageNewMsg:T2 未读收到私信内容; messageNewTime:1411624464000 未读收到私信时间; messageSender:bjbjbjbj822800 未读收到私信人; messageSenderID:4387176 未读收到私信人ID; systemNoticeCount:0 未读系统消息数; systemNoticeNewMsg: 未读系统消息内容 systemNoticeNewTime:1413525025000 未读系统消息时间; } }}} === 2.46主题列表 === {{{ 接口:/club/listAllTheme.do 说明:获取搜索用主题列表 请求参数: 是否登录:否 缓存时间:无 是否分页:无 返回 "data": [ { “clubTagId”:主题id “clubTagName”:主题名字 }, { “clubTagId”:主题id “clubTagName”:主题名字 }, ] }}} === 3.1 IM获取token === {{{ 请求url:/club/getToken.do, 请求方式:POST, 是否需要登录:是, 返缓存方式:无, 缓存时间:无, 请求参数: userId://太平洋帐号id, grabber: //是否需要强制获取新的Token,0:不需要,1:需要 返回结果: { "token":"P0JtJ0LBGI9Qya1+uIPR0dLyEN9NFQAM0jQTPx8aQUQg5RfoaakM54il9pxVp1TGrpEVXynHbxxfokmJy1QkcQ==", "code":0, "msg":"成功获取token!" } token 获取融云Token message 返回结果描述 code 返回结果代码,1:非登录用户,2:不是车友会成员,3:获取Token导演,0:操作成功 }}} === 3.2 IM获取好友列表 === {{{ 请求url:/club/getFriendList.do, HTTP请求方式:POST, 是否需要登录:true, 返回格式:json, 返缓存方式:无, 缓存时间:无, 请求参数:clubId://车友会id,, 说明: 返回结果: { code:0 //code 返回结果代码,1:车友会没有通过审核,0:操作成功 message://返回结果描述 friendList:[ { userId://太平洋帐号id userName://昵称 faceUrl://头像url } ], image:http://xxxxx 群组头像 } }}} === 4.1车友动态接口 === {{{ 接口URL:/dyna/getDynaList.do 说明:根据车友会ID,返回车友动态列表 请求参数: clubId:车友会ID(二选一) userId:用户Id(二选一) type:筛选 1帖子(不全,只返回车友会对应用户帖子),2动态 , 默认0全部 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "clubId": clubId, (二选一) "userId": userId, (二选一) "data": [ { "postCount":回复数 "pubTime": 发布时间, "topicTitle": 帖子标题, "forumName": 板块名称, "isPick": 是否是精华, "isPost": 是否帖子, "authorId": 作者ID, "forumId": 16160, "authorName": 作者名称, "nickname":作者昵称, "contribution": 贡献油值, "topicId": 帖子ID, "dynaInfoId",动态ID "authorPhoto": 作者头像, "isRecommend": 是否是推荐, “content”:动态内容 "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 } ] } ] } }}} === 4.2 发动态 === {{{ 请求url:/dyna/createCommentDyna.do, HTTP请求方式:POST, 是否需要登录:true, 返回格式:json, 返缓存方式:无, 缓存时间:无, 请求参数: clubId 车友会ID(可选) provinceId 发动态省地区id(必选) cityId 发动态市地区id(无则不传) content 留言内容 images:[ { url:"http://xxxxx", width:100 //宽 height:200 //高 }, { url:"http://xxxxx", width:100 //宽 height:200 //高 } ]//图片 说明: 图片上传指令 command:53003 53004 53016 53017 53018 53019 53020 返回结果:{ code:0 //错误代码,0:正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆 message: “您还没有登陆” //错误提示 } }}} === 4.3修改个人信息 === {{{ 请求url:http://my.pcauto.com.cn/intf/updateUser.jsp, HTTP请求方式:POST, 是否需要登录:true, 返回格式:json, 返缓存方式:无, 缓存时间:无, 请求参数: domicileId;城市ID nickName:昵称 telephone;电话号码 realName;真实姓名 address;地址 msn;msn账号 qq;qq账号 zip;邮编 birthday;出生日期 //格式YYYY-MM-DD gender 1>男 2女 0 未知 返回结果:{ code:0 //错误代码,0:正常返回 message: “您还没有登陆” //错误提示 } }}} === 4.4 回复动态 === {{{ 请求URL:/dyna/replyDyna.do HTTP请求方式:POST, 是否需要登录:true, 返回格式:json, 返缓存方式:无, 缓存时间:无 请求参数: clubId 车友会ID(可选) provinceId:省id cityId:城市ID(无则无须传cityid) content 留言内容 dynaInfoId 动态ID postToDynaReplyId 发表回复的回复ID createDate 创建时间,列表数据的pubTime,后台查表需要,格式yyyy-MM-dd 返回结果: { code 返回结果代码,正常返回 1:操作失败 1001:权限类错误 1002:数据类错误 1003:用户无登陆 message 返回结果描述 data:{ replyId://回复id userId://用户ID authorPhoto://用户头像 nickname://用户昵称 content://回复内容 createDate://回复时间 postToDynaReplyId://被回复id(为回复回复时返回) postToUserId://被回复用户ID(为回复回复时返回) postToNickName://被回复用户昵称(为回复回复时返回) } } }}} === 4.5 动态回复列表 === {{{ 请求URL: HTTP请求方式:GET, 是否需要登录:false, 返回格式:json, 返缓存方式:无, 缓存时间:无, 是否分页:是 请求参数: dynaInfoId 动态ID createDate 创建时间,列表数据的pubTime,后台查表需要 返回结果: { dynaInfoId://动态ID replys:[ { replyId://回复id userId://用户ID authorPhoto://用户头像 userName://用户昵称 content://回复内容 replyToId://被回复id(为回复回复时返回) replyToUserId://被回复用户ID(为回复回复时返回) replyToUserName://被回复用户昵称(为回复回复时返回) } ] } }}} === 4.6个人中心帖子列表 === {{{ 接口URL: bbs.pcauto.com.cn/plugins/autoclub/user/topics.do 说明:根据用户id返回所有帖子列表 是否分页:是 请求参数: userId: 用户ID imgSize: 需要图片数,默认为3张 audited: 是否审核通过,默认为true maxLength: 帖子内容长度,默认为240 resp_enc: 编码,默认为UTF-8 返回 与4.1一致 }}} === 4.7收到的回复(帖子、动态) === {{{ 接口:http://mrobot.pcauto.com.cn/club/bbs/getClubReplyReminds 说明:收到的回复(帖子、动态) 请求参数: 登陆信息通过session拿 是否登录:是 缓存时间:无 是否分页:有 返回 "data": [ { “replyType”:类型,1帖子 2动态 “targetId”:点击进入详情用的id “replyId”:回复id, “replyContent”: “replyUserId”: “replyUserName”: “replyUserImg”: “toReplyId”:被回复id “toReplyContent”: “time”: }, { “replyType”:类型,1帖子 2动态 “targetId”:点击进入详情用的id “replyId”:回复id, “replyContent”: “replyUserId”: “replyUserName”: “replyUserImg”: “toReplyId”:被回复id “toReplyContent”: “time”: }, ] 帖子回复和动态回复要求对应返回字段一致 }}} === 4.8获取动态 === {{{ 接口:/dyna/getDynaDetail.do 说明:根据动态id获取动态信息 请求参数: dynaInfoId:动态id createDate:动态创建时间,yyyy-mm-dd格式 返回 data: { "postCount":回复数 "pubTime": 发布时间, "authorId": 作者ID, "forumId": 16160, "authorName": 作者名称, "nickname":作者昵称, "contribution": 贡献油值, "dynaInfoId",动态ID "authorPhoto": 作者头像, "isRecommend": 是否是推荐, “content”:动态内容 "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 } ] } }}} === 5.1兑换列表 === {{{ 接口:/gift/listGift4App.do 说明:用于app兑换列表显示 请求参数: 是否登录:否 缓存时间:无 是否分页:是 返回 "data": [ { “id”:兑换礼品id//看后台设计是否有用 “img”:图片url “name”:礼品名称 “cost”:兑换所需金币 “status”://0-》马上兑换 1-》缺货 }, { “id”:兑换礼品id//看后台设计是否有用 “img”:图片url “name”:礼品名称 “cost”:兑换所需金币 “status”://0-》马上兑换 1-》缺货 } ] }}} === 5.2用户兑换信息 === {{{ 接口:/gift/listConversionByUserId4App.do 说明:用户金币、兑换信息返回 请求参数: 登陆信息从session拿,不需要传 是否登录:是 缓存时间:无 是否分页:无 返回 "data": { “userId”:用户id “exchangeCount”:兑换记录总数 “goldCount”:金币总数 “userName”:用户昵称 “userImg”:用户头像 } }}} === 5.3申请兑换 === {{{ 接口:/gift/createReply4ConversionInfo.do 说明:申请兑换提交信息 请求方式:POST 请求参数: giftId:礼品Id realName:真实姓名 provinceId:省id provinceName:省名字 cityId:市id,无则不传 cityName:市名字,无则不传 address:地址 postCode:邮编 phoneNum:手机号码 是否登录:是 缓存时间:无 是否分页:无 返回 }}} === 5.4兑换记录 === {{{ 接口:/gift/listConversionHistoryByUserId4App.do 说明:兑换记录列表 请求参数: session获取用户id 是否登录:是 缓存时间:无 是否分页:是 返回 "data": [ { “id”:兑换记录id “img”:图片url “name”:礼品名称 “cost”:兑换所需金币 “time”:兑换时间,返回时间戳 “status”://0-》待发货 1-》已发货 -1-》驳回 2-》待付款 }, { “id”:兑换记录id “img”:图片url “name”:礼品名称 “cost”:兑换所需金币 “time”:兑换时间,返回时间戳 “status”://0-》待发货 1-》已发货 -1-》驳回 2-》待付款 } ] }}} === 6.1 附近的人 === {{{ 接口:/user/listUserByPosition.do 说明:附近的人列表 请求参数 longitude 经度 latitude 纬度 userId 当前用户id,用于返回结果去掉 是否登录:否 缓存时间:无 是否分页:是 返回 "data": [ { “userId”:用户id “nickName”:用户昵称 “userImg”:用户头像 “sex”:性别 “distance”:距离,//直接显示 “serialName”:认证车系 }, { “userId”:用户id “userName”:用户昵称 “userImg”:用户头像 “sex”:性别 “distance”:距离//直接显示 “serialName”:认证车系 }, ] }}} === 6.2更新用户位置信息 === {{{ 说明:更新用户所在位置 接口:/user/updateUserPosition 请求方法:POST 请求参数 longitude 经度 latitude 纬度 }}} === 7.1 任务列表 === {{{ PS:开发环境域名http://dev38.pcauto.com.cn:8085 域名:task.pcauto.com.cn 说明:获取用户任务列表 接口:/intf/clubgc/app/taskList.do 请求参数 是否登录:是 缓存时间:无 是否分页:否 返回 { “disposableTask“:[ { “taskId”:任务id,或任务类型,每个任务一个 “taskName”:”任务名称” “applogo”:任务icon “gold”:“加金币数” “limitPermanantly”:上限数//无则返回0,注意这个字段和下面的不一样 “current”:当前数//无则返回0,例如发了多少帖子 “status”:完成的状态, status=0表示未完成 =1表示已完成 "received":是否领取,0未领取,1已领取 “appAction”:{ “action”:点击触发,如app内跳转pcautoclub://XXX或直接网址http://xxxx,参考焦点图action处理方式 “desc”:描述 } }//一次性任务 “normalTasks”:[ { “taskId”:任务id,或任务类型,每个任务一个 “taskName”:”任务名称” “applogo”:任务icon “gold”:“加金币数” “limitDaily”:上限数//无则返回0 “current”:当前数//无则返回0,例如发了多少帖子 “status”:完成的状态, status=0表示未完成 =1表示已完成 "received":是否领取,0未领取,1已领取 “appAction”:{ “action”:点击触发,如app内跳转pcautoclub://XXX或直接网址http://xxxx,参考焦点图action处理方式 “desc”:描述 } }//普通任务 ] } }}} === 7.2领取奖励 === {{{ PS:开发环境域名http://dev38.pcauto.com.cn:8085 域名:task.pcauto.com.cn 说明:点击领取奖励 接口:/intf/clubgc/recieveGoldCoin.do 请求方法:POST 请求参数 taskId:任务id 返回 任务id后台相关:http://rdtrac.pc.com.cn/autoclub/wiki/taskdef }}} === 8.1 同城优惠列表 === {{{ 说明:获取同城优惠列表 接口:/club/listLocalPromotion.do 请求参数 provinceId 发动态省地区id(必选) cityId 发动态市地区id(无则不传) 是否登录:否 缓存时间:无 是否分页:是 返回 { data:[ { “topicUrl”:http://bbs.pcauto.com.cn/topic-5460623.html 帖子url “img”:帖子图片 “startTime”优惠开始时间 “endTime”优惠结束时间 “title”:帖子标题 }, { “topicUrl”:http://bbs.pcauto.com.cn/topic-5460623.html 帖子url “img”:帖子图片 “startTime”优惠开始时间 “endTime”优惠结束时间 “title”:帖子标题 } ] } }}} === 8.2同城首页信息 === {{{ 说明:同城首页信息,包括同城车友会(<3个),同城优惠(<5个) 接口:/club/listLocalClubAndPromotions.do 请求参数 provinceId 发动态省地区id(必选) cityId 发动态市地区id(无则不传) 是否登录:否 缓存时间:无 是否分页:否 返回 { “sameCityClubCount”:同城车友会总数 “sameCityPreferentialCount”:同城优惠总数 “sameCityClubData”:[ { "logo": 车友会会标 “clubBackgroundImg”://顶部背景图片url “levelupTip”:升级提示,0-》不可升级,1-》可升级 “applyCount”:待审核人数, “presidentName”:会长昵称 "announcement": 公告, "memberSum": 成员数, "cityName": 市, "commentSum": 留言数, "introduce": 简介, "provinceName": 省, "topicSum": 帖子数, "totalPetrol": 总油值, "clubId":用户ID, "clubStatus":车友会状态(是否被锁之类) "clubUrl":车友会域名, "level": 等级ID, "seriesName": 车系名称, "brandName": 品牌名称, "regionRank": 品牌排名, "rank":全国排名, "activitySum": 活动数, "name":车友会名称, "levelName": 等级名称, "albumSum": 相册数, "photoSum":照片数 "activityName": 最新活动名称 "memberId":会员ID,如果有 "adminType":成员角色//说明参考2.2 "isCheck":true/false 是否签到 "forumId":论坛id,用于发帖 } ]//前三个 “preferentialData”:[ { endTime = 1415030400000; img:图片 startTime = 1412092800000; time:时间 title:标题 topicUrl:http://bbs.pcauto.com.cn/topic-5460623.html 帖子url } ]//前5条 } }}} === 8.3同城动态 === {{{ 接口:/dyna/listLocalDyna.do 说明:根据地区ID,返回车友动态列表 请求参数: provinceId 发动态省地区id(必选) cityId 发动态市地区id(无则不传) 是否登录:否 缓存时间:无 是否分页:是 返回结果: { "data": [ { "postCount":回复数 "pubTime": 发布时间, "authorId": 作者ID, "forumId": 16160, "authorName": 作者名称, "nickname":作者昵称, "contribution": 贡献油值, "dynaInfoId",动态ID "authorPhoto": 作者头像, "isRecommend": 是否是推荐, “content”:动态内容 "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 } ] } ] } }}} === 8.4我的二维码 === {{{ 接口:/util/userQrCode.jsp 我的二维码(参考车友会二维码) 请求参数: userId 扫描结果 http://用户主页?action=pcautoclub://user-center/用户id }}} === 8.5经纬度获取城市 === {{{ 接口:http://whois.pconline.com.cn/ipAreaCoordJson.jsp?coords=113.360414,23.16405&level=3&json=true 说明:根据经纬度获取城市 请求参数 longitude 经度 latitude 纬度 返回 { areaCode:省id areaName:省名字 cityCode:城市ID//如无城市,则id为0 cityName:城市名字//无则为空字符串 } }}} === 8.6论坛首页 === {{{ 说明:论坛首页-猜你喜欢(客户端4.5新增接口,由于车友会现实样式不同,需要增加thumbImg字段,显示缩略图,是否在客户端接口上加字段还是新开接口,后台同事自行确认) 开发完成,连代理192.168.22.242 8888即能拿到数据或者页面 请求url:http://mrobot.pcauto.com.cn/v3/bbs/guessYouLike HTTP请求方式:GET 是否需要登录:false 返回格式:json 缓存方式:接口缓存 缓存时间:60分钟 请求参数:第一次进到论坛首页的时候,既没有cookie,也没有visitedFid, 就使用热门论坛的,这个逻辑交给app客户端处理,由客户端调用热门论坛的接口获取数据拼接visitedFid cookie visitedFid:访问过的版块id以D分隔,非必须参数 请求后端url:http://bbs.pcauto.com.cn/intf/guessYouLike.do?smallImg=true&bbsImgOnly=true&type=json&imgCount=3&viewCount=true 说明: visitedFid 访问过的版块id以D分隔,非必须参数 type 输出格式,默认js,可以为json var 当输出为js时,保存数据的变量名,默认为topiclist1 containCoverOnly 是否只出含封面图的精华,默认false bbsImgOnly 是否只出汽车论坛上传的图片,默认false smallImg 是否把图片转为120x80格式,默认false imgCount 每个帖子出的图片数量,默认2 viewCount 值为true,表示出浏览数量 返回结果:(最多60个) [ { "datatime": "2014-04-25 11:04", "datatimemillis": 1398395080000, "desc": "买车过程太痛苦了!不想回忆了![无语]开始看过很多车,雅阁,CC,君越,胜达,3系,C级,还有蒙迪欧。蒙迪欧第一眼就爱上了,外形控的不二选择!高科技配置很多!完...", "forum": "奥迪A4L论坛", "forumId": 14034, "forumlink": "http://v15.pcauto.com.cn/forum-14359.html", "replycount": 100, "topic": "40TFSI个运作业来了!谁说没媳妇合影就不能火!!!!!", "topicId": 4720505, "topicimg": [], "topiclink": "http://v15.pcauto.com.cn/topic-4720505.html", "userId": 30421242, "userface": "http://i1.3conline.com/images/upload/upc/face/30/42/12/42/30421242_100x100", "userlink": "http://v21.pcauto.com.cn/30421242", "username": “qz30421242”, "thumbImg": 缩略图 }, { "datatime": "2014-04-09 23:51", "datatimemillis": 1397058682000, "desc": " 跟拍奥迪与嫩模今日独家奉上精美图集~名车名模,快说,你对哪个心动了呀? 啦啦啦,上图啦,看美女啦! [图]先来张内饰,甜甜圈是不是特别的显眼...", "forum": "奥迪A4L论坛", "forumId": 14034, "forumlink": "http://v15.pcauto.com.cn/forum-14359.html", "replycount": 39, "topic": "【名模名车】奥迪或嫰模,你要哪个?多图杀猫~", "topicId": 4639676, "topicimg": [], "topiclink": "http://v15.pcauto.com.cn/topic-4639676.html", "userId": 8803955, "userface": "http://i1.3conline.com/images/upload/upc/face/88/03/95/5/8803955_100x100", "userlink": "http://v21.pcauto.com.cn/8803955", "username": “爱恨不平行”, "thumbImg": 缩略图 } ] }}} === 8.7wap页面 === {{{ 任务: 手机绑定帐号(取消该功能) 申请成为认证车主 http://m.pcauto.com.cn/bbs/3g/toApply.do?fromPcautoApp 有一个帖子被设置为精华帖 http://m.pcauto.com.cn/bbs/topic-5092954.html 发表1个主题帖 http://m.pcauto.com.cn/bbs/topic-5092954.html 其他: 常见问题(创建车友会)http://www1.pcauto.com.cn/app/autoclub/QA.html 升级车友会 http://club.pcauto.com.cn/wap/club/levelPrizes.do?clubId= }}}