[[TOC]] == 1.基本约定 == [[BR]]mrobot开发机代理：192.168.10.199 端口为 1080 [[BR]]mrobot开发机域名：dev40.pcauto.com.cn '''(warning：使用此域名或会导致某些html内嵌js请求产生跨域问题，不建议使用）''' [[BR]]mrobot测试机代理：192.168.10.198 端口为 1080 == 2.接口列表 == === 2.1 [=#point2.1 圈子广场] === ==== 2.1.1 [=#point2.1.1 圈子广场栏目信息] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/x/dev11.pcauto.com.cn/bbs7/xcappapi/1/forum/findForums.ajax {{{ 应用后端url： http://dev11.pcauto.com.cn/bbs7/xcappapi/1/forum/findForums.ajax HTTP请求方式:GET 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: 无 返回结果: { "desc": "sucess", "forumList": [ { "forumId": 22686, "forumName": "学前交流", "tags": "原创,转载,讨论,提问,召集,公告" }, { "forumId": 22615, "forumName": "挂科吐槽", "tags": "原创,转载,讨论,提问,召集,公告" } ], "status": 0, "version": "v1.0(latest)" } }}} ==== 2.1.2 [=#point2.1.2 圈子入口用户数及头像] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/authImg.xsp {{{ 应用后端url： http://dev40.pcauto.com.cn/configs/pcauto_xueche_authimg (获取用户系数和头像) http://dev11.pcauto.com.cn/bbs7/xcappapi/1/forums/pv.ajax (获取用户数) HTTP请求方式:GET 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: 无 返回结果: { subject1: { //科目一 total: 250, forumId: 22486, //版块id images: [ "http://i6.3conline.com/images/upload/upc/face/30/22/93/51/30229351_120x120", "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120", "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120" ] }, subject2: { //科目二 total: 500, forumId: 22505, images: [ "http://i6.3conline.com/images/upload/upc/face/30/22/93/52/30229352_120x120", "http://i6.3conline.com/images/upload/upc/face/30/22/93/81/30229381_120x120", "http://i6.3conline.com/images/upload/upc/face/30/22/93/84/30229384_120x120" ] }, subject3: { //科目三 total: 750, forumId: 22487, images: [ "http://i6.3conline.com/images/upload/upc/face/24/99/80/81/24998081_120x120", "http://i6.3conline.com/images/upload/upc/face/33/41/39/08/33413908_120x120", "http://i6.3conline.com/images/upload/upc/face/30/22/93/84/30229384_120x120" ] }, subject4: { //科目四 total: 1000, forumId: 22515, images: [ "http://i6.3conline.com/images/upload/upc/face/82/67/17/826717_120x120", "http://i6.3conline.com/images/upload/upc/face/34/76/82/00/34768200_120x120", "http://i6.3conline.com/images/upload/upc/face/34/55/13/62/34551362_120x120" ] }, wish: { //许愿 forumId: 22695 } } 注意：数据从mrobot后台录入，配置名称为：pcauto_xueche_authimg }}} ==== 2.1.3 [=#point2.1.3 精彩推荐帖子列表] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/recommendList.xsp?pageNo=&pageSize= {{{ 应用后端url： http://www.pcauto.com.cn/client/xcbd/1506/intf7067.js （获取推荐列表） http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/getTopicListByIds.do?topicIds= （获取帖子详情） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?id= （获取用户昵称和头像） HTTP请求方式:GET 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: pageNo 可选 默认为1 pageSize 可选 默认为20 返回结果: { total: pageNo: pageSize: topicList: [ { title: 标题 picUrl: 图片 to_uri: 跳转协议（若是论坛贴子则返回pcautobrowser://bbs-topic/） seq: 序号 isRecommend:1 是否推荐，1表示推荐帖子 }, { authorPhoto: 作者头像 createBy: 作者id createDate: 帖子发布时间（时间戳） forumId: 版块ID forumName: 版块名字 imageList: [ url:图片 width:宽 height:高 qua:选题参数 ], isPick: 是否精华（0：非,1:是） nickName: 作者昵称 postCount: 评论数 praiseCount: 赞数 title: 帖子标题 topicId: 帖子id to_uri: 跳转协议（若是论坛贴子则返回pcautobrowser://bbs-topic/） isRecommend:0 是否推荐，0表示普通帖子 } ] } }}} ==== 2.1.4 [=#point2.1.4 论坛帖子列表] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getTopicList.xsp?forumId= {{{ 应用后端url： http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/getTopicListByForumId.do?forumId= （根据版块ID获取帖子列表） http://dev11.pcauto.com.cn/bbs7/xcappapi/1/forum/listForumTopTopics.ajax?resp_enc=utf-8&fid= （根据版块ID获取topList数据） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?id= (获取个人信息批量接口) HTTP请求方式:GET 是否需要登录:否 返回格式:json 缓存方式:无 缓存时间:无 请求参数: forumId (必填) pageNo （选填） pageSize（选填） tagName(选填) xssEncode (0 不刷刷选 1刷选) 返回结果: { "code": 0, "message": "操作成功", "pageCount": 1, "pageNo": 1, "pageSize": 20, "topicList": [ { "createBy": 31457462, "createDate": 1435221397000, "forumId": 22486, "forumName": "科目一", "imageList": [], "isPick": 0, "postCount": 8, "praiseCount": 0, "tagName": "原创", "title": "学车1.2测试", "topicId": 7809290, "userName": "Crazydemon", "userId": "31457462", "nickName": "Crazydemon", "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/31/45/74/62/31457462_100x100" }, { "createBy": 13128876, "createDate": 1435717316000, "forumId": 22486, "forumName": "科目一", "imageList": [], "isPick": 0, "postCount": 12, "praiseCount": 0, "tagName": "原创", "title": "测试bip接口", "topicId": 7809323, "userName": "3edc4rfv", "userId": "13128876", "nickName": "2222", "userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/13/12/88/76/13128876_100x100" } ], "total": 2, "version": "v1.0(latest)", "topList": [ { "isPick": true, "tag": "提问", "tid": 7809289, "title": "学车1.2－发提问帖修改版V1" }, { "isPick": false, "tag": "原创", "tid": 7809286, "title": "学车发帖测试V2" }, { "isPick": false, "tag": "原创", "tid": 7809273, "title": "学车1.2发帖" }, { "isPick": false, "tag": "原创", "tid": 7809268, "title": "学车会同步科目一这个版块的帖子不V3" } ] } }}} === 2.2 [=#point2.1 我的圈子] === ==== 2.2.1 [=#point2.2.1 回复我的] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=13128876&typeId=2068&pageNo=1&pageSize=20 {{{ 应用后端url： http://dev2.pcauto.com.cn:8001/intf/sysnotice.jsp?act=find&accountId=13128876&siteId=2&typeIds=2068&pageNo=1&pageSize=20&noTemplate=true （获取回复、点赞列表） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?id= （获取用户昵称和头像） 说明:回复我的列表 HTTP请求方式:GET 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: accountId：必填 用户id typeId: 可选 系统消息类型，(typeIds=2068,2070)可传多值，2068表示回复我的，2070表示回复帖子回复 pageNo 可选 默认1 pageSize 可选 默认20 返回结果: { total: 1, pageNo: 1, pageCount: 1, pageSize: 5, data: [ { status:1 ：正常状态 ， 2： 删除状态， isPick: 是否精华, postContent: 回复内容, type: 帖子类型 1：普通帖子，2：提问帖子, createBy: 回复用户id, topicCreateBy: 帖子创建者id, title: 帖子标题, floor: 回复楼层, forumId: 板块id, tagName: 标签, userId: 回复用户id, topicId: 主帖id, replyId: 回复id, createDate: 回复时间, nickName: 回复用户昵称, userPhoto: 回复用户头像， postReplyId 被回复帖子回复id （回复帖子回复才有） postReplyCreateBy 被回复的帖子回复的创建者（回复帖子回复才有） postToMessage 被回复的帖子回复的内容（回复帖子回复才有） } ] } }}} ==== 2.2.2 [=#point2.2.2 赞我的] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=13128876&typeId=2069&pageNo=1&pageSize=20 {{{ 应用后端url： http://dev2.pcauto.com.cn:8001/intf/sysnotice.jsp?act=find&accountId=13128876&siteId=2&typeIds=2069&pageNo=1&pageSize=20&noTemplate=true （获取回复、点赞列表） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?id= （获取用户昵称和头像） 说明:回复我的列表 HTTP请求方式:GET 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: accountId：必填 用户id typeId: 可选 系统消息类型，2069表示赞我的， pageNo 可选 默认1 pageSize 可选 默认20 返回结果: { total: 1, pageNo: 1, pageCount: 1, pageSize: 5, data: [ { topicCreateBy: 帖子创建者, praiseTime: 点赞时间, topicTitle: 帖子title, forumId: 板块id, tagName: 标签, status:1 ：正常状态 ， 2： 删除状态， isPick: 是否精华, userId: 赞用户的id, topicId: 帖子id， nickName: 赞用户昵称, userPhoto: 赞用户头像 } ] } }}} ==== 2.2.3 [=#point2.2.3 我的帖子] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getMyTopicList.xsp?pageNo=&pageSize= {{{ 应用后端url： http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/getMyTopicList.do （获取我的帖子列表） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?resp_enc=utf-8&id= （获取个人信息批量接口） 说明 : 我的帖子/回帖列表 HTTP请求方式:GET 是否需要登录:是 返回格式:json 缓存方式:无 缓存时间:无 请求参数: pageNo：页数 pageSize：每页条数 返回结果: { userId:用户ID authorPhoto:用户头像 nickName:昵称 topicList:[{ type:主贴/回帖（1：主帖子；2：回帖） topicId:帖子ID title:帖子标题 content:内容 isTopicDelete:主帖是否删除（-1：是；1：否） createDate:发布时间（时间戳） isPick:是否精华（0：非,1:是） tagName:标签名称 praiseCount:赞数 postCount:评论数 topicCreateBy:帖子发布者ID（回帖时） topicNickname:帖子发布者昵称（回帖时） imageSize:图片数量 imageList:[ { url:图片 width:宽 height:高 qua:选题参数 }, { url:图片 width:宽 height:高 qua:选题参数 } ] }] total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 code : 0成功，-1失败，-2未登录 message : 提示信息 version : 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 2.2.4 [=#point2.2.4 获取最新消息数] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getNewMessage.xsp?accountId= {{{ 应用后端url： http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=getNum&accountId=&siteId=2&status=0&typeIds=&groupType=8 HTTP请求方式:GET 是否需要登录:否 返回格式:json 缓存方式:对象缓存 缓存时间:4小时 请求参数: accountId：必填 用户ID 返回结果: { replyCount: 0, //回复我的未读数 praiseCount: 0 //赞我的未读数 } }}} ==== 2.2.5 [=#point2.2.5 清空回复我的/赞我的新消息数] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/x/bip.pcauto.com.cn/intf/sysnotice.jsp?act=readAll&siteId=2&typeIds=2068,2069,2070&groupType=8 {{{ 应用后端url： http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=readAll&siteId=2&typeIds=2068,2069,2070&groupType=8 HTTP请求方式:POST 是否需要登录:是 返回格式:json 缓存方式: 缓存时间: 请求参数: act: 必填 readAll表示修改所有消息状态为已读 siteId: 必填 2表示汽车网 typeIds: 可选 系统消息类型，可传多值 返回结果: {"code":-1,"message":"非法请求"} 必须post提交 {"code":-1,"message":"缺少参数"} 未登录或者缺少siteId参数 {"code":0} 操作成功 }}} === 2.3 [=#point2.3 话题详情] === （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topicDetail.xsp?tid= {{{ 应用后端url： http://dev11.pcauto.com.cn/bbs7/xcappapi/1/topic/topicDetail.ajax?resp_enc=utf-8&tid= (获取帖子详情) http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/getPraiseCountByTopicId.do?topicId= （获取帖子赞数） http://dev11.pcauto.com.cn/bbs7/xcappapi/1/topic/photos.do?ajax=true&tid= （获取主贴图片列表） HTTP请求方式:GET 是否需要登录:否 返回格式:HTML 缓存方式:无 缓存时间:无 请求参数: tid :帖子ID（必填） set cookie ：设置header，登录后拿到的cookie --> commensessionId（选填） 返回结果:HTML 页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 数据内容为 { "title": "学车发帖测试V2",(标题) "url": "http://dev11.pcauto.com.cn/bbs7/topic-7809286.html",(分享URL) "firstPic": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg"(第一张图) } 页面协议 pcdrive://reply/floorId (floorId)楼层id 回复楼层协议 pcdrive://praise/tid (tid) 帖子id 点赞协议 pcdrive://big-photo?data={\"total\":" + total + ",\"currentIndex\":" + currentIndex + ",\"photos\":[" +photos+ "]} (total)图片总数 (currentIndex)当前图片位置 (photos) 所有图片URL 点击图片协议 }}} === 2.4 [=#point2.4 成绩排行] === ==== 2.4.1[=#point2.4.1 今日成绩排行榜列表] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankListToday.xsp?subjectId= {{{ 应用后端url： http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListToday.do?subjectId= （获取今日成绩排行榜） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?resp_enc=utf-8&id= (批量获取个人信息) 说明 : 今日成绩排行榜 HTTP请求方式:GET 是否需要登录:(登陆后有个人数据，不登陆就是默认数据） 是否分页：是 返回格式:json 缓存方式:无 缓存时间:无 请求参数 ：subjectId:科目ID（必填） 返回结果: { myRank://我在今日排行榜的排名 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） rank:我的排名 score:分数 } rankList:[//今日排行榜 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 }, { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 } ] total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 code : 0成功 message : 提示信息 version : 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 2.4.2[=#point2.4.2 本周成绩排行榜列表] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankListWeek.xsp?subjectId= {{{ 应用后端url： http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListWeek.do?subjectId= （获取本周成绩排行榜） http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?resp_enc=utf-8&id= (批量获取个人信息) 说明 : 本周成绩排行榜 HTTP请求方式:GET 是否需要登录:(登陆后有个人数据，不登陆就是默认数据） 是否分页：是 返回格式:json 缓存方式:无 缓存时间:无 请求参数 ：subjectId:科目ID（必填） 返回结果: { myRank://我在本周排行榜的排名 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） rank:我的排名 score:分数 } rankList:[//本周排行榜 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 }, { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 } ] total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 code : 0成功 message : 提示信息 version : 接口版本号如1.0，1.0（latest)表示最新版本 } }}} ==== 2.4.3[=#point2.4.3 总排行榜列表] ==== （开发已完成，测试请连开发机代理）[[BR]] '''请求url''': http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankList.xsp?subjectId= {{{ 应用后端url： http://dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListToday.do?subjectId= (获取总成绩排行榜) http://dev4.pcauto.com.cn:8081/intf/client/getUserById.jsp?resp_enc=utf-8&id= (批量获取个人信息) 说明 : 成绩排行总榜 HTTP请求方式:GET 是否需要登录:(登陆后有个人数据，不登陆就是默认数据） 是否分页：是 返回格式:json 缓存方式:无 缓存时间:无 请求参数 ：subjectId:科目ID（必填） 返回结果: { myRank://我在总排行榜的排名 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） rank:我的排名 score:分数 } rankList:[//总排行榜 { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 }, { userId:用户ID nickName:用户昵称 authorPhoto:用户头像 completeTime:完成答题时间（秒） score:分数 } ] total:总条数 pageNo:页码 pageSize:每页条数 pageCount:总共几页 code : 0成功 message : 提示信息 version : 接口版本号如1.0，1.0（latest)表示最新版本 } }}} === 2.5 [=#point2.5 成绩分享] === '''请求url''':http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/scoreShare1.2.xsp {{{ 应用后端url：无 HTTP请求方式:GET 是否需要登录:false 返回格式:html 缓存方式:无 缓存时间:无 请求参数： “imageUrl” : www.baidu.com (头像图片地址) “score”:90 ： (分数) “constTime” : 121 (用时) “userName”: 华 (用户名) “schoolName” : 东方驾校 (驾校) “gender”: 0|1(性别0=女|男=1） “subjectId” ： 1=科目一 | 科目四=4 “percent” ： 90 (百分比) 返回结果:HTML }}}