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=
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
(691 bytes) -
added by xieweijie 12 years ago.
