接口索引
需求原型: http://trac.pc.com.cn/iphone/wiki/pcauto_club_4.5.0
1. 车友会提供APP接口4.5
PC端开发环境域名:dev18.pcauto.com.cn
WAP端开发环境域名:dev43.pcauto.com.cn:83/club
PC端线上环境域名:club.pcauto.com.cn
WAP端线上域名:m.pcauto.com.cn/club
1. 举报管理相关
1.1. 内容举报接口
接口:/appapi/1.0/report/addReport.do [POST]
请求参数:
reporterId: 举报人id [long, not null]
reporterNickname: 举报人昵称 [not null]
targetUserId: 被举报人id [long]
targetUserNickname: 被举报人昵称
targetId: 举报内容ID [long](如果是论坛帖子,这个id,传的是楼层的id)
targetExtId: (简单做法:1、如果是相片,这个id,传的就是相片所对应相册的id;2、如果是论坛帖子,这个id,传的就是帖子id;3、其他类型,不需要传)
targetUrl: 举报内容URL
targetType: 举报类型(1:帖子;2:动态;3:话题;4:照片;5:活动;6:投票;7:WebView') [int, not null]
content: 举报原因
otherReson: 其他原因(举报原因和其他原因不能同时为空)[String, maxSize:100]
reportContent:举报内容(即标题)[String, not null maxSize:35]
是否登录 :是
缓存时间 : 否
是否分页 : 否
返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
}
2. 用户管理相关
2.1. 用户权限接口
原有接口:/1.0/user/getUserPermission.do
1、添加锁用户判断
2、添加用户爱车信息,最终返回结果:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
// 新增字段,如果用户被锁,没有该字段
// 认证车主:取认证车型;否则取保存的车型信息;没有就为空
carInfo: {
isVip: 是否认证车主(0-否;1-是)
// 出现脏数据或者有些旧数据,会没有下面这几个字段
brandId: 品牌id
brandName: 品牌名
serialId: 车系id
serialName: 车系名
},
// 保持原来字段不变,如果用户被锁,不用有该字段
permissions: [
]
}
3.车系印象详情页
3.1.车系印象详情页
接口:/impressApp-${id}.html
是否分页:否
是否缓存:否
是否登录:是
请求参数:
${id}: 车系Id[long, not null]
返回: 无
协议:
pcautoclub://auto-ask-price/ :点击“询底价”、“置换”、“试驾”都跳到询价页,
pcautoclub://bbs-topic/ :“必看帖子”里的帖子,点击要进入帖子终端页(即主题终端页),
pcautoclub://bbs-topics/ :“必看帖子”最后的“查看更多”,点击进入该车系的圈子终端页,
pcautoclub://bbs-topic/ :“车友问答”里的帖子,点击进入帖子终端页(即主题终端页),
pcautoclub://user-center/ :“车友问答”里的用户昵称,点击进入该用户的个人中心,
pcautoclub://user-center/ :“吐槽OR点赞”,点击头像或用户昵称都进入该用户的个人中心
pcautoclub://bbs-topics-ask/圈子id :车提问
4.最新提问帖id列表
4.1.最新提问帖id列表
接口:/appapi/1.0/topic/getNewestQuestionTopicIds.do
是否分页:是
是否缓存:否
是否登录:否
请求参数:
pageNo
pageSize
返回:
{
code:0成功,-1失败
message:提示信息
version: 接口版本号如1.0,1.0(latest)表示最新版本
pageCount: 11,
pageNo: 3,
pageSize: 20,
total: 220,
idList: [
]
}
3. 论坛提供APP4.5接口
PC端开发环境域名:dev39.pcauto.com.cn
WAP端开发环境域名: http://dev43.pcauto.com.cn:83/bbs/
PC端线上环境域名:bbs.pcauto.com.cn
WAP端线上域名:m.pcauto.com.cn/bbs/
3.1. 删除帖子接口
接口:/appapi/1/post/delete.do [POST]
请求参数:
topicId: 主题id [long, not null]
postId: 帖子id [long, not null]
是否登录 :是
缓存时间 : 否
是否分页 : 否
返回结果:
{
status:0成功,-1失败
desc:提示信息
}
3.2. 恢复帖子接口
接口:/appapi/1/post/restore.do [POST]
请求参数:
topicId: 主题id [long, not null]
postId: 帖子id [long, not null]
deleteAt: 删除时间(时间戳) [long, not null]
是否登录 :是
缓存时间 : 否
是否分页 : 否
返回结果:
{
status:0成功,-1失败
desc:提示信息
}
3.3 车问答发帖接口
接口/appapi/1/topic/create.ajax [POST]
说明 : 主题图片表
请求参数 :
forumId:板块id
sgId: 车系id(不传版块id时通过车系id匹配版块)
type: (""/"question")发帖的种类(普通贴)/提问)
appTitle:标题
message:正文 必填
messageImage:图片+图片描述
agent: 6代表ios 7 代表android 必填
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果:
{
"Location":"http://localhost.pcauto.com.cn/bbs7/topic-7808773.html",
code : 0成功,-1失败
message : 提示信息
version : 接口版本号如1.0,1.0(latest)表示最新版本
}
3.4 设置最佳答案接口
接口/appapi/1/post/bestAnswer.do [POST]
说明 : 主题图片表
请求参数 :
tid: 必填
pid: 必填(被设置最佳答案的回帖)
doNotOverride: 是否覆盖现有最佳答案(true/false,不传默认覆盖)
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果:
{
status:0,
desc: "操作成功"
}
{
status:1,
desc: "操作失败"
}
3.5 全站最新提问帖列表接口
接口/appapi/1/question/newest.do [POST]
说明 : 主题图片表
请求参数 :
pageNo:
pageSize:
是否登录 : 是
缓存时间 : 无
是否分页 : 否
返回结果:
{
"message": "操作成功",
"pageNo": 1,
"pageSize": 50,
"topicList": [
{
"authorId": 826717,
"content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
"createAt": 1431941116000,
"dynaType": 4, 1为普通 4为提问帖
"isPick": false,
"isRecommend":false,
"lastpostAt": 1431941116000,
"replyCount": 0,
"title": "普通贴",
"topicId": 7808734,
"uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
},
]
"total": 18048,
code : 0成功,-1失败
message : 提示信息
version : 接口版本号如1.0,1.0(latest)表示最新版本
}
3.6 提问帖列表
接口/appapi/1/forum/listTopicsByForumId.do [GET]
说明 : 按版块取提问帖列表
请求参数 :
forumId:板块id
sgId: 车系id(不传版块id时通过车系id匹配版块)
filter: question 提问帖
orderby: 选择最新贴时"postat"发布时间排序, 其它可以不传
pageNo: 页码
pageSize: 页码大小
是否登录 : 否
缓存时间 : 无
是否分页 : 是
返回结果:
{
"forum": {
"bbs": 19,
"forumId": 14674,
"name": "嘉年华论坛",
"parentId": 298
},
"message": "操作成功",
"pageNo": 1,
"pageSize": 50,
"topicList": [
{
"authorId": 826717,
"content": "正文[表情]下一个呢[表情]后面就是上传的图片了\n\n\n\n",
"createAt": 1431941116000,
"dynaType": 4, 1为普通 4为提问帖
"isPick": false,
"isRecommend":false,
"lastpostAt": 1431941116000,
"replyCount": 0,
"title": "普通贴",
"topicId": 7808734,
"uri": "http://localhost.pcauto.com.cn/bbs7/topic-7808734.html"
},
]
"total": 18048,
code : 0成功,-1失败
message : 提示信息
version : 接口版本号如1.0,1.0(latest)表示最新版本
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)