![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 55 (modified by dengyurong, 11 years ago) (diff) |
|---|
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/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 圈子入口用户数及头像
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/authImg.xsp
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=
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 论坛帖子列表
（开发已完成，测试请连开发机代理）
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getTopicList.xsp?forumId=
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数: forumId (必填)
pageNo （选填）
pageSize（选填）
tagName(选填)
返回结果:
{
"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 我的圈子
2.2.1 回复我的
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=24998081&typeId=2043&pageNo=1&pageSize=20
说明:回复我的列表
HTTP请求方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId：必填 用户id
typeId: 必填 系统消息类型，(typeIds=2043,2045)可传多值，2043表示回复我的，2045表示回复帖子回复
pageNo 可选 默认1
pageSize 可选 默认20
返回结果:
{
total: 1,
pageNo: 1,
pageCount: 1,
pageSize: 5,
data: [
{
status: 状态 1：正常状态，－1：删除状态,
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 赞我的
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/replyPraiseList.xsp?accountId=24998081&typeId=2044&pageNo=1&pageSize=20
说明:回复我的列表
HTTP请求方式:GET
是否需要登录:是
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
accountId：必填 用户id
typeId: 必填 系统消息类型，2044表示赞我的，
pageNo 可选 默认1
pageSize 可选 默认20
返回结果:
{
total: 1,
pageNo: 1,
pageCount: 1,
pageSize: 5,
data: [
{
topicCreateBy: 帖子创建者,
praiseTime: 点赞时间,
topicTitle: 帖子title,
forumId: 板块id,
status: 状态 1：正常状态，－1：删除状态,
tagName: 标签,
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=
说明 : 我的帖子/回帖列表
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 获取最新消息数
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getNewMessage.xsp?accountId=
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:对象缓存
缓存时间:4小时
请求参数:
accountId：必填 用户ID
返回结果:
{
replyCount: 0, //回复我的未读数
praiseCount: 0 //赞我的未读数
}
2.2.5 清空回复我的/赞我的新消息数
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/x/bip.pcauto.com.cn/intf/sysnotice.jsp?act=readAll&siteId=2&typeIds=2043,2044
HTTP请求方式:POST
是否需要登录:是
返回格式:json
缓存方式:
缓存时间:
请求参数:
act: 必填 readAll表示修改所有消息状态为已读
siteId: 必填 2表示汽车网
typeIds: 必填 系统消息类型，可传多值，2043表示回复,2044表示点赞
返回结果:
{"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=
HTTP请求方式:GET
是否需要登录:否
返回格式:HTML
缓存方式:无
缓存时间:无
请求参数:
tid :帖子ID（必填）
sessionId ：登录后拿到的session （选填）
返回结果: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=
说明 : 今日成绩排行榜
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=
说明 : 本周成绩排行榜
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=
说明 : 成绩排行总榜
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)表示最新版本
}
