[[PageOutline(1-100,接口索引)]] == 1. 车友会提供APP接口4.5 == 开发环境域名:dev18.pcauto.com.cn 线上环境域名:club.pcauto.com.cn === 1. 举报管理相关 ==== 1.1. 内容举报接口 ==== {{{ 接口:/appapi/1.0/report/addReport.do [POST] 请求参数: reporterId: 举报人id [long, not null] reporterNickname: 举报人昵称 [not null] targetUserId: 被举报人id [long, not null] targetUserNickname: 被举报人昵称 [not null] targetId: 举报内容ID [long, not null](如果是论坛帖子,这个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: [ ] } }}} ==== 2.2 车问答发帖接口 ==== {{{ 接口/appapi/1/forum/createTopic.ajax [POST] 说明 : 主题图片表 请求参数 : forumId: 必填 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)表示最新版本 } }}} ==== 2.3 车问答发帖接口 ==== {{{ 接口/action/post/best_answer.do [POST] 说明 : 主题图片表 请求参数 : tid: 必填 pid: 必填(被设置最佳答案的回帖) 是否登录 : 是 缓存时间 : 无 是否分页 : 否 返回结果: { status:0, desc: "操作成功" } { status:1, desc: "操作失败" } }}} ==== 2.4 向我求助帖子列表接口 ==== {{{ 接口/intf/expert/listQuestionsByUid.do [POST] 说明 : 主题图片表 请求参数 : uid: 车专家Uid 必填 type: 0全部 1推荐答案 2等待采纳 3未被采纳 4未回答 pageNo: pageSize: 是否登录 : 是 缓存时间 : 无 是否分页 : 否 返回结果: showReviews({"list":[{"answerd":false,"authorId":826717,"authorName":"深海无声","bestAnswer":0,"createAt":1445594039000,"replyCount":0,"tid":9892485,"title":"1111111111122","url":"http://v71.pcauto.com.cn/topic-9892485.html"} }],"pageNo":1,"pageSize":15,"totalSize":657}) }}} === 3.车系印象详情页 ==== 3.1.车系印象详情页 ==== {{{ 接口:/wap/carImpression4App.do 是否分页:否 是否缓存:否 是否登录:是 请求参数: sgid: 车系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 :车提问 }}} == 3. 论坛提供APP4.5接口 == ==== 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/topic/restore.do [POST] 请求参数: topicId: 主题id [long, not null] postId: 帖子id [long, not null] deleteAt: 删除时间(时间戳) [long, not null] 是否登录 :是 缓存时间 : 否 是否分页 : 否 返回结果: { status:0成功,-1失败 desc:提示信息 } }}}