![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 23 (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,
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,
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,
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,
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"
]
}
}
注意：数据从mrobot后台录入，配置名称为：pcauto_xueche_authimg
2.1.3 精彩推荐帖子列表
请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/recommendList.xsp?userId=
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:userId 必填
返回结果:
{
data: [
{
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表示普通帖子
isPraise: 是否点赞
}
]
}
2.1.4 论坛帖子列表
请求url: http://mrobot.pcauto.com.cn/xsp/s/auto/buy/xueChe/getTopicList.xsp?forumId=&userId=
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数: forumId (必填)
pageNo （选填）
pageSize（选填）
tagName(选填)
userId (必填)
返回结果:
{
"code": 0,
"message": "操作成功",
"pageCount": 1,
"pageNo": 1,
"pageSize": 20,
"topicList": [
{
"createBy": 826717,
"createDate": 1435206506000,
"forumId": 22486,
"forumName": "科目一",
"imageList": [
{
"height": 200,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
"width": 200
},
{
"height": 200,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
"width": 200
},
{
"height": 29,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17556_1433756675100_1024x1024.jpg",
"width": 38
},
{
"height": 200,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg",
"width": 200
},
{
"height": 29,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17546_1433753457103_1024x1024.jpg",
"width": 38
},
{
"height": 29,
"qua": 0,
"url": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/08/c0/17552_1433756601180_1024x1024.jpg",
"width": 38
}
],
"isPick": 0,
"nickName": "fit10",
"postCount": 0,
"praiseCount": 0,
"title": "学车1.2发帖",
"topicId": 7809273,
"isPraise": 0,
"userName": "测试注册2",
"userId": "129",
"userPhoto": "http://dev2.pcauto.com.cn:9191/upchead/12/9/129_100x100"
},
],
"total": 4,
"version": "v1.0(latest)"
}
2.2 我的圈子
2.2.1 回复我的
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/listReplyToMe.do?userId=&sessionId=&pageNo=&pageSize=
说明:回复我的列表
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
userId：必填
pageNo:选填
pageSize:选填
sessionId 必填 登录后拿到的session
返回结果:
{"code":-1,"message":"登录后才能操作！"}
{"code":-1,"message":"参数错误"}
{
“data” : [
{
回复id,
回复用户id,
回复用户昵称,
回复用户头像,
回复时间,
主帖id,
主帖标题,
标签
是否精华
回复内容
}
]
“total”:
“pageSize”:
“pageNo”:
}
2.2.2 赞我的
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/listPraiseToMe.do?userId=&sessionId=&pageNo=&pageSize=
说明：赞我的列表
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
userId：必填
pageNo:选填
pageSize:选填
sessionId 必填 登录后拿到的session
返回结果:
{"code":-1,"message":"登录后才能操作！"}
{"code":-1,"message":"参数错误"}
{
“data” : [
{
回复id,
回复用户id,
回复用户昵称,
回复用户头像,
回复时间,
主帖id,
主帖标题,
标签
是否精华
回复内容
}
]
“total”:
“pageSize”:
“pageNo”:
}
2.2.3 我的帖子
（开发已完成，测试请连开发机代理）
请求url:http://mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/getMyTopicList.do
说明 : 我的帖子/回帖列表
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请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
无
返回结果:
2.3 话题详情
请求url:
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:无
缓存时间:无
请求参数:
无
返回结果:
3.1 成绩排行
3.1.1今日成绩排行榜列表
（开发已完成，测试请连开发机代理）
请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListToday.do
说明 : 今日成绩排行榜
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成功，-1失败，-2未登录
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
3.1.2本周成绩排行榜列表
（开发已完成，测试请连开发机代理）
请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankListWeek.do
说明 : 本周成绩排行榜
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成功，-1失败，-2未登录
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
3.1.3总排行榜列表
（开发已完成，测试请连开发机代理）
请求url:mrobot.pcauto.com.cn/xsp/x/dev38.pcauto.com.cn:8009/appapi/1.0/topic/rankList.do
说明 : 成绩排行总榜
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成功，-1失败，-2未登录
message : 提示信息
version : 接口版本号如1.0，1.0（latest)表示最新版本
}
