![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 10 (modified by liangzhicong, 11 years ago) (diff) |
|---|
Table of Contents
所有接口文档 http://trac.pc.com.cn/iphone/wiki/pcauto_club_2.0.0/api
车友会后台接口文档 http://rdtrac.pc.com.cn/autoclub/wiki/appapi/3.0
1. 车友会提供APP接口
1.1车友会创建接口
1.1.1 创建品牌车友会接口 接口/appapi/1.0/club/createClubByBrand.do [POST] 1.1.2 创建地区车友会接口 接口/appapi/1.0/club/createClubByArea.do [POST] 1.1.3 创建主题车友会接口 接口/appapi/1.0/club/createClubByTheme.do [POST]
1.2修改车友会信息
1.1.4 修改车友会接口 接口/appapi/1.0/club/editClub.do [POST]
1.3搜索车友会
说明：只做列表信息，对于单个车友会详情信息需要另外接口拿 1.1.5 车友会搜索接口 接口URL:/appapi/1.0/club/getClubBasic.do [GET]
1.4用户权限操作
1.1.6 转让会长接口 接口URL:/appapi/1.0/member/transferClubAdmin.do [POST] 1.1.7 设置副会长接口 接口URL:/appapi/1.0/member/setClubViceAdmin.do [POST] 1.1.8 解除职务接口 接口URL:/appapi/1.0/member/removalClubOffice.do [POST] 1.1.10 退出车友会接口（被会长进行移出车友会） 接口URL:/appapi/1.0/member/removeClub.do [POST] 1.1.11 退出车友会接口(用户自己进行退出）） 接口URL:/appapi/1.0/member/quitClub.do [POST] 1.1.12 取消审核中车友会申请 接口URL:/appapi/1.0/member/cancleApplyRecord.do [POST]
1.5排行榜相关
1.1.15 车友会排行（全国排名） 接口URL:/appapi/1.0/club/listTopClubWeeklyByNationwide.do [GET] 1.1.16 车友会排行（品牌排名） 接口URL:/appapi/1.0/club/listTopClubWeeklyByBrand.do [GET] 1.1.17 车友会排行（地区排名） 接口URL:/appapi/1.0/club/listTopClubWeeklyByArea.do [GET]
1.6获取用户权限（或者签到一些个人信息）
1.1.20 用户权限获取 接口：/appapi/1.0/user/getUserPermission.do [GET]
1.7创建车友会草稿
1.1.25 获取创建车友草稿信息 接口：/appapi/1.0/club/getCreateClubInfo.do [GET]
1.8点赞
1.1.26 点赞/取消赞 接口：/appapi/1.0/dyna/doSupport.do [POST]
1.9收到的赞
1.1.27 收到的赞列表 接口：/appapi/1.0/dyna/getSupportList.do [GET] 接口做清零处理（具体全清或分页清看产品需求）
1.10获取点赞人列表
1.1.29 获取动态点赞用户列表 接口：/appapi/1.0/dyna/getSupportUserList.do [GET]
1.11 获取草稿
2. mrobot提供APP接口
2.1 同城首页信息
说明：同城首页优惠与同城车友会信息返回
后端数据来源:
1.1.18 同城首页信息（同城车友会）
1.1.19 同城首页信息（同城优惠）
接口：
请求参数
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条
}
2.2车友会首页
说明：车友会首页列表
后端数据来源:
1.1.22 首页车友会列表接口(游客的推荐）
1.1.23 首页车友会列表接口(审核中的车友会列表）
接口：
请求参数
provinceId 发动态省地区id（必选）
cityId 发动态市地区id（无则不传）
是否登录:
缓存时间:无
是否分页:否
返回
{
“recommendData”:[]//推荐列表数组
“applyData”:[]//待审核列表数组
}
推荐列表需要对审核列表包含的去重
2.3获取私信列表
说明：获取私信列表
来源：
http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3 (15接口如下)
接口URL: http://bip.pcauto.com.cn/intf/message.jsp
必填参数：
act：findMergeMsg
非必填参数：
status：0是未读，1是已读，默认-1是全部
startDate：开始时间
endDate：结束时间
beforeDay：在某个时间前
pageNo：页码，默认是1，表示第一页
pageSize：一页条数，默认20，最大500
callback ：支持回调函数，=windowname时表示以windowname形式返回
windowname ：1或true 以windowname形式返回，不传或0或false以json格式返回
获取NickName的时候现有做法是要用到以下两个接口：
1. http://bbs.pcauto.com.cn/action/user/user_setting_json.jsp?uid=34369908
2. 用户未访问过汽车网论坛时，在汽车网论坛中还没有创建该用户的信息，故使用上面的接口不能获取到该用户的信息，此时改由下面的接口获取
http://my.pcauto.com.cn/intf/getIdByName.jsp?act=getShowNameById&accountId=34369908
请求参数
是否登录:是
缓存时间:无
是否分页:是
{
total: 总的条数,
pageNo: 页码,
pageCount: 页数,
pageSize: 每页条数,
resultList:[
{“message":{
“id":私信ID,
“content":私信内容,
“createTime":创建时间,
"status":私信状态,
“accountId”:13128876,
“accountNickName”：//accountid对应nickname，
“senderId”:发私信者ID,
“senderNickName":senderId对应nickname,
"senderIsVip":是否认证
“replyId":回复私信ID,
“showStatus":显示状态，如果该信息的sender_id为黑名单里面的则不显示，状态为0，否则为1
},
“notReadTotal":未读总数
}
]
}
2.4私信对话列表
说明：获取私信对话列表
来源：
http://trac.pc.com.cn/bip/wiki/%E6%8E%A5%E5%8F%A3
16接口
需要调用
20.更新指定发送者Id发给当前登录用户的所有未读私信状态为已读
接口URL: http://bip.pcauto.com.cn/intf/message.jsp?
清空未读数
请求参数
是否登录:是
缓存时间:无
是否分页:是
{
total: 总的条数,
pageNo: 页码,
pageCount: 页数,
pageSize: 每页条数,
resultList:[
{“message":{
“id":私信ID,
“content":私信内容,
“createTime":创建时间,
"status":私信状态,
“accountId”:13128876,
“senderId”:发私信者ID,
“replyId":回复私信ID,
“showStatus":显示状态，如果该信息的sender_id为黑名单里面的则不显示，状态为0，否则为1
},
“notReadTotal":未读总数
}
]
}
2.5车友会动态列表
说明：获取车友会动态列表，封装动态是否已赞
来源：
1.1.30 获取动态列表（返回动态图片列表）
1.1.31 判断是否已赞
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
topicTitle: 帖子标题,
forumName: 板块名称,
isPick: 是否是精华,
authorId: 作者ID,
isHasImg: 是否有图片,
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
topicId: 帖子ID,
authorPhoto: 作者头像,
isRecommend: 是否是推荐,
isVip：是否认证
dynaInfoId：动态id
supportCount：点赞数,
hasSupport：已赞(根据当前登录的用户是否赞过此动态）
images:[
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
},
{
url:http://xxxx.jpg,
//真实宽度
width:960,
//真实高度
height:1000
}
]
}
]
}
2.6个人主页动态列表
说明：获取个人主页动态列表，封装动态是否已赞
来源：
1.1.24 个人主页动态列表
1.1.31 判断是否已赞
返回
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
userId:
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
authorId: 作者ID,
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
dynaInfoId,动态ID
authorPhoto: 作者头像,
isRecommend: 是否是推荐,
content:动态内容
isVip：是否认证
supportCount：点赞数,
hadSupport：已赞,
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
}
]
}
]
}
2.7同城动态列表
说明：获取同城动态列表，封装动态是否已赞
来源：
1.1.33 获取同城动态列表
1.1.31 判断是否已赞
{
code:0成功，-1失败
message:提示信息
version: 接口版本号如1.0，1.0（latest)表示最新版本
dynaList:[
{
postCount:回复数
pubTime: 发布时间,
authorId: 作者ID,
forumId: 16160,
authorName: 作者名称,
nickname:作者昵称,
contribution: 贡献油值,
dynaInfoId,动态ID
authorPhoto: 作者头像,
isRecommend: 是否是推荐,
content:动态内容
isVip：是否认证
supportCount：点赞数,
hadSupport：已赞,
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
}
]
}
]
}
2.8未读数
说明：获取未读信息
原接口
接口：http://mrobot.pcauto.com.cn/v3/bbs/getNewMsgCount
1.1.32 未读已赞数
接口：/appapi/1.0/dyna/getUnReadCount.do [GET]
返回
{
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 未读系统消息时间;
//以下为需要合并的信息
supportNotReadCount：未读收到赞数
supportNotReadMsg：未读收到赞内容（暂定为用户昵称）
supportNotReadTime：未读收到赞时间
}
2.9 创建创建车友会草稿
1.1.34 创建车友会草稿接口 接口：/appapi/1.0/club/createClubDraft.do [POST]
