![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif){kind=logo}
| Version 25 (modified by lianchijin, 11 years ago) (diff) |
|---|
Table of Contents
学车2.2.0接口文档
mrobot代理环境说明：
192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。
制作地址：
应用后端接口trac：
1.学分任务与商城
1.1我的
(获取用户学分接口)
mrobot地址：
说明
获取用户学分接口
缓存时间
分钟
提交方式
GET
是否登录
是
数据来源
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "成功",
"score":4000
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| score | 用户学分 |
1.2学分任务列表
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
获取登录与未登录状态下的学分任务列表，任务列表顺序固定，上到下排序分别是：精华帖、模拟考试首次合格、模拟考试第二次合格、模拟考试第三次合格、模拟考试首次满分、首次分享APP给朋友；
缓存时间
0
提交方式
GET
是否登录
登录与未登录都可请求
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功",
"score":5000,
"tips":"做任务赢学分，可兑换苹果9哦！点此登录",
"data": [
{
"taskId": 440100,
"taskType": 0,
"taskTimes": 2,
"taskImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
"taskName": "分享APP给朋友",
"taskDesc": "被评为精华帖可每次可获得20学分，获取机会无限次。",
"taskScore": 10
},
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| score | 登录用户学分，未登录返回“” | tips | 未登录状态下的提示信息，已登录返回“” |
| taskId | 任务id | taskType | 登录下返回各任务状态：0未完成，1已完成，2可多次完成的任务；未登录该字段返回“” |
| taskTimes | 已完成的任务次数，针对可多次完成的任务 | taskImage | 任务缩略图 |
| taskName | 任务名称 | taskDesc | 任务描述 |
| taskScore | 完成任务可获得的学分 |
1.2.1 判断用户完成情况
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
判断用户学分任务列表完成情况
缓存时间
0
提交方式
GET
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功",
"passingTime": 1,
"allPass": true,
"haveShare": true
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| passingTime | 已经及格过的次数 | allPass | 是否已得过满分 |
| haveShare | 是否已首次分享过 |
1.2.2 用户赚取学分
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
用户赚取学分接口
缓存时间
0
提交方式
POST
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 | |
| passingTime | 第几次模拟考及格 | int | 是 | 第几次模拟考及格 | |
| allPass | 是否首次满分 | bool | 是 | 是否首次满分 | |
| haveShare | 是否首次分享 | bool | 是 | 是否首次分享 | |
| score | 用户赚取的学分 | int | 是 | 用户赚取的学分 |
返回
{
"code": 0,
"message": "操作成功"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
1.3学分商场
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
学分商场列表
缓存时间
0
提交方式
GET
是否登录
登录与未登录都可请求
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| score | 用户学分 | string | 否 | 用户学分，未登录不传 |
返回
返回HTML页面
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|
协议
点击商品图片跳转到帖子页： pcdrivebrowser://topic-detail/?id=1234
点击登录跳转协议：pcdrivebrowser://user-login
点击跳转至游戏抽奖页: pcdrivebrowser://game
1.4每日抽奖
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
每日抽奖
缓存时间
0
提交方式
GET
是否登录
登录与未登录都可请求
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
返回HTML页面
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|
协议
未登录，点击“开始”跳转至登录协议： pcdrivebrowser://user-login
点击我的奖品跳转： pcdrivebrowser://my-prize
1.4.1我的奖品
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
我的奖品接口，该接口为预留扩展接口，V2.2版本所有用户返回数据都为空数据
缓存时间
0
提交方式
GET
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
2.科目三
2.1科目首页问答接口
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
科目首页问答接口
缓存时间
0
提交方式
GET
是否登录
否
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| subjectId | 科目id | int | 是 | 科目id |
返回
{
"code": 0,
"message": "操作成功",
"questionList": [
{
"id": 440100,
"title": "离合器半联动怎么找？"
},
{
"id": 434500,
"title": "科目三怎么踩离合才是正确的？"
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| id | 帖子id | title | 问答标题 |
2.2科目首页今日推荐接口
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
科目首页今日推荐接口
缓存时间
0
提交方式
GET
是否登录
否
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| subjectId | 科目id | int | 是 | 科目id |
返回
{
"code": 0,
"message": "操作成功",
"datas": [
{
"id": 440100,
"type": 1,
"img": "http://img0.pcauto.com.cn/pcauto/1507/14/g_6728785_1436863917510_240x160.jpg",
"url": "http://m.pcauto.com.cn/x/679/6790726.html",
"content": "今天落地13w买回家"
},
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| id | 文章id，帖子id | type | 跳转类型：1文章页，2话题详情页，3专题页面，4游戏页面，5每日抽奖 |
2.3 考场实拍，考场列表
mrobot地址：
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.2.根据城市ID获取考场2.2
学车后台线上环境：
说明
考场实拍，考场列表。V2.2科目三考场只出广州的数据，请求参数cityId由接口端定义（建议不传或给默认值），按首字的首字母顺序排序
缓存时间
0
提交方式
GET
是否登录
否
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| cityId | 城市id | int | 否 | V2.2科目三考场只出广州的数据，城市id由接口端定义（建议不传或给默认值） | |
| subjectId | 科目id | int | 是 | 考场是科目二(subjectId=2),路拍是科目三(subjectId=3) |
返回
{
"code": 0,
"message": "操作成功",
"datas": [
{
"cityId": 440100,
"id": 160,
"name": "秀全驾校",
"provinceId": 440000,
"content": "路段的简介文案，字数不超过3行，超过三行在第三行末尾省略号结束",
"shrinkTagram": [
{
"url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/07/c0/10835360_1438940428057_&1&.jpg"
}
]
},
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| id | 考场id | cityId | 城市id |
| name | 考场名 | provinceId | 省份id |
| content | 考场简介 | url | 缩略图 |
2.4 考场详情页（web页）
mrobot地址：
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.3.根据考场ID获取考场详情2.1
学车后台线上环境：
说明
参照V2.1考场详情接口 http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a2.3考场详情页web页
缓存时间
0
提交方式
GET
是否登录
否
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|
返回
返回HTML页面
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|
2.5基础知识
mrobot地址： http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a3.1基础知识主页[[BR]]
学车后台开发环境：
学车后台线上环境：
说明
沿用V2.1的接口，增加一个subjectId请求参数
缓存时间
0
提交方式
GET
是否登录
否
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| subjectId | 科目id | int | 是 | 科目id |
返回
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|
2.6 夜考、完整版
mrobot地址： http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a4.3五大必过版[[BR]]
学车后台开发环境：
学车后台线上环境：
说明
沿用V2.1科目二必过版的文章模板，文章ID后续由编辑给到。
缓存时间
0
提交方式
GET
是否登录
否
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| subjectId | 科目id | int | 是 | 科目id |
返回
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|
3.0 邀请码
3.1 注册设备号
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
注册设备号接口，app启动后将设备id传至学车后台，post成功后不再请求
缓存时间
0
提交方式
POST
是否登录
否
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| deviceId | 设备id | string | 是 | 设备id |
返回
{
"code": 0,
"message": "操作成功"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
3.2 获取邀请码页面
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
获取邀请码页面
缓存时间
0
提交方式
GET
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功",
"currentNum": 58,
"totalNum": 100,
"score": 10000,
"shareUrl": "http://m.pcauto.com.cn/x/679/6790726.html"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| currentNum | 当月已邀请人数 | totalNum | 累计邀请人数 |
| score | 获得学分 | shareUrl | 分享页面url |
3.3 填写邀请码
mrobot地址：
学车后台开发环境：
学车后台线上环境：
说明
填写邀请码接口，登录用户cookie与设备id是否需要加密，怎么加密由接口端再确认
缓存时间
0
提交方式
POST
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 | |
| deviceId | 设备id | string | 是 | 设备id | |
| invitationCode | 邀请码 | string | 是 | 邀请码 |
返回
{
"code": 0,
"message": "邀请成功"
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 邀请成功与否的提示信息 |
4.0 优化点
4.1 点赞接口
mrobot地址：
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/1.2#a1.2.5点赞[[BR]]
学车后台线上环境：
说明
如果不是那8个学车论坛的帖子，是不能点赞的。1.2点赞接口新增字段判断是否属于8个论坛的帖子
缓存时间
0
提交方式
POST
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功",
"version": 1.0,
"fromForum": true
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| version | 接口版本号如1.0，1.0（latest)表示最新版本 | fromForum | 新增字段，判断是否来自8个论坛 |
4.2 取消点赞接口
mrobot地址：
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/1.2#a1.2.6取消点赞[[BR]]
学车后台线上环境：
说明
如果不是那8个学车论坛的帖子，是不能取消点赞的。1.2取消点赞接口新增字段判断是否属于8个论坛的帖子
缓存时间
0
提交方式
POST
是否登录
是
数据来源
学车后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| Cookie | 用户登录cookie | string | 是 | 登录用户cookie，放在请求头中 |
返回
{
"code": 0,
"message": "操作成功",
"version": 1.0,
"fromForum": true
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含义 |
|---|---|---|---|
| code | 接口返回状态码：0成功，非0异常 | message | 接口返回描述信息 |
| version | 接口版本号如1.0，1.0（latest)表示最新版本 | fromForum | 新增字段，判断是否来自8个论坛 |
