Table of Contents
所有接口文档 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
}
]
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)