![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
Table of Contents
1.基本约定
mrobot开发机代理：192.168.10.199 端口为 1080
mrobot开发机域名：dev40.pcauto.com.cn (warning：使用此域名或会导致某些html内嵌js请求产生跨域问题，不建议使用）
mrobot测试机代理：192.168.10.198 端口为 1080
2.接口列表
2.1 圈子广场
2.1.1 圈子广场栏目信息
请求url: http://mrobot.pcauto.com.cn/xsp/x/bbs.pcauto.com.cn/xcappapi/1/forum/findForums.ajax
应用后端url：
http://bbs.pcauto.com.cn/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 圈子入口用户数及头像
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/authImg.xsp
应用后端url：
http://mrobot.pcauto.com.cn/configs/pcauto_xueche_authimg (获取用户系数和头像)
http://bbs.pcauto.com.cn/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 精彩推荐帖子列表
请求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://xueche.pcauto.com.cn/appapi/1.0/topic/getTopicListByIds.do?topicIds= （获取帖子详情）
http://my.pcauto.com.cn/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表示推荐帖子
activeId: 233 (专家问答专题页出此字段，专家问答id)
type: 6 (6表示专家问答专题页)
},
{
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表示普通帖子
type: 帖子类型 1：普通帖子，2：提问帖子
}
]
}
2.1.4 论坛帖子列表
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getTopicList.xsp?forumId=
应用后端url：
http://xueche.pcauto.com.cn/appapi/1.0/topic/getTopicListByForumId.do?forumId= （根据版块ID获取帖子列表）
http://bbs.pcauto.com.cn/xcappapi/1/forum/listForumTopTopics.ajax?resp_enc=utf-8&fid= （根据版块ID获取topList数据）
http://my.pcauto.com.cn/intf/client/getUserById.jsp?id= (获取个人信息批量接口)
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数: forumId (必填)
pageNo （选填）
pageSize（选填）
tagName(选填)
xssEncode (0 原内容 ;1 过滤xss，对<>内容做转义处理)
返回结果:
{
"code": 0,
"message": "操作成功",
"pageCount": 1,
"pageNo": 1,
"pageSize": 20,
"topicList": [
{
"createBy": 31457462,
"createDate": 1435221397000, (发帖时间)
"lastPostDate": 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,
"lastPostDate": 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 我的圈子
2.2.1 回复我的
应用后端url：
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&accountId=13128876&siteId=2&typeIds=2068&pageNo=1&pageSize=20&noTemplate=true （获取回复、点赞列表）
http://my.pcauto.com.cn/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: 回复内容,
topicType: 帖子类型 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 赞我的
应用后端url：
http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&accountId=13128876&siteId=2&typeIds=2069&pageNo=1&pageSize=20&noTemplate=true （获取回复、点赞列表）
http://my.pcauto.com.cn/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,
topicType: 帖子类型 1：普通帖子，2：提问帖子,
tagName: 标签,
status:1 ：正常状态 ， 2： 删除状态，
isPick: 是否精华,
userId: 赞用户的id,
topicId: 帖子id，
nickName: 赞用户昵称,
userPhoto: 赞用户头像
}
]
}
2.2.3 我的帖子
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getMyTopicList.xsp?pageNo=&pageSize=
应用后端url：
http://xueche.pcauto.com.cn/appapi/1.0/topic/getMyTopicList.do （获取我的帖子列表）
http://my.pcauto.com.cn/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:帖子发布者昵称（回帖时）
topicType: 帖子类型 1：普通帖子，2：提问帖子,
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 获取最新消息数
请求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 清空回复我的/赞我的新消息数
应用后端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 话题详情
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topicDetail.xsp?tid=
应用后端url：
http://bbs.pcauto.com.cn/xcappapi/1/topic/topicDetail.ajax?resp_enc=utf-8&tid= (获取帖子详情)
http://xueche.pcauto.com.cn/appapi/1.0/topic/getPraiseCountByTopicId.do?topicId= （获取帖子赞数）
http://bbs.pcauto.com.cn/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 成绩排行
2.4.1今日成绩排行榜列表
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankListToday.xsp?subjectId=
应用后端url：
http://xueche.pcauto.com.cn/appapi/1.0/topic/rankListToday.do?subjectId= （获取今日成绩排行榜）
http://my.pcauto.com.cn/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本周成绩排行榜列表
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankListWeek.xsp?subjectId=
应用后端url：
http://xueche.pcauto.com.cn/appapi/1.0/topic/rankListWeek.do?subjectId= （获取本周成绩排行榜）
http://my.pcauto.com.cn/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总排行榜列表
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/rankList.xsp?subjectId=
应用后端url：
http://xueche.pcauto.com.cn/appapi/1.0/topic/rankListToday.do?subjectId= (获取总成绩排行榜)
http://my.pcauto.com.cn/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 成绩分享
请求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
