[[TOC]] 所有接口文档 http://trac.pc.com.cn/iphone/wiki/pcauto_club_2.0.0/api === 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.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.19修改车友会接口=== {{{ 接口URL:/club/editClub.do 说明:修改车友会资料 请求参数： clubId:车友会ID userId：用户Id，从登录信息取 editType：1》会标修改，2》宣言修改，3》公告修改 4》顶部背景 content：修改内容（url/宣言/公告/顶部背景，传url） 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0} }}} === 5.1兑换列表 === {{{ 接口:/gift/listGift4App.do 说明:用于app兑换列表显示 请求参数: 是否登录:否 缓存时间:无 是否分页:是 返回 "data": [ { “id”:兑换礼品id//看后台设计是否有用 “img”:图片url “name”：礼品名称 “cost”：兑换所需金币 “status”：//0-》马上兑换 1-》缺货 "link": //金币详情url }, { “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-》待付款 } ] }}} === 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.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://被回复用户昵称(为回复回复时返回) } } }}} === 2.45主题列表 === {{{ 接口：/club/listAllTheme.do 说明：获取搜索用主题列表 请求参数： 是否登录:否 缓存时间:无 是否分页:无 返回 "data": [ { “clubTagId”:主题id “clubTagName”:主题名字 }， { “clubTagId”:主题id “clubTagName”:主题名字 }， ] }}} === 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} }}} === 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 纬度 }}} === 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所加入车友会前后两个，自己，后面两个 } }}} === 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 }}} === 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: “您还没有登陆” //错误提示 } }}} === 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= }}} === 2.8上传图片接口 === {{{ 接口URL:/album/uploadPic.do 说明:上传图片到车友会指定相册 请求参数： albumId:相册ID userId:用户id，从登录信息取 urls : 格式:名称@路径@尺寸，多张图片以”,”分割(上传原图url) 如 abc@http://123.png@100x150 是否登录:是 缓存时间:无 是否分页:否 返回结果： {code:0} }}} === 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 } ] } }}}