学车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我的

(V1.1版本 2.7获取个人信息接口增加返回用户学分字段)

mrobot地址： http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getPersonalinf.xsp

说明

获取个人信息接口增加返回用户学分字段

缓存时间

分钟

提交方式

GET

是否登录

是

数据来源

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中

返回

{
      "code": 0,
      "gender": 0,
      "message": "成功",
      "address": "",
      "drivingSchool": "未报考驾校",
      "drivingSchoolId": -2,
      "nickName": "hahahahahaha",
      "userId": 31836836,
      "cityName": "",
      "cityId": 0
      "score":用户学分（新增字段）
}

返回参数说明

参数名	参数含义	参数名	参数含意
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.3学分商场

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

学分商场列表

缓存时间

0

提交方式

GET

是否登录

登录与未登录都可请求

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中

返回

{
    "code": 0,
    "message": "操作成功",
    "score":5000,
    "tips":"做任务赢学分，可兑换苹果9哦！点此登录",
    "gameTips":"今天又苹果6",
    "recordsTips":"查看囊中物",
    "pageCount": 2,
    "pageNo": 1, 
    "pageSize": 20,
    "data": [
        {
            "resId": 440100,
            "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
            "resName": "苹果9",
            "resStatusDesc": "9000分",
            "resStatus": 0
        },
    ]
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
score	登录用户学分，未登录返回“”	tips	未登录状态下的提示信息，已登录返回“”
gameTips	每日抽奖提示文案	recordsTips	兑换记录提示文案
pageCount	总页数	pageNo	当前页码
pageSize	每页条数	resId	商品id
resImage	商品缩略图	resName	商品名
resStatusDesc	兑换商品的状态描述	resStatus	商品兑换状态：0需要XXX学分，1正在补货，2已兑换

---

1.3.1商品详情

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

商品详情

缓存时间

0

提交方式

GET

是否登录

登录与未登录都可请求

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中
resId	商品id	int		是

返回

{
    "code": 0,
    "message": "操作成功",
    "resId": 440100,
    "resName":"商品名称",
    "resScore":500分,
    "resCount":2,
    "resStatus": 0，
    "resDesc": "商品详细说明商品详细说明商品详细说明商品详细说明",
    "imgData": [
            "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
            "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
            "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg"
    ]
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
resId	商品id	resName	商品名
resScore	兑换商品所需学分	resCount	剩余商品数
resStatus	商品兑换状态：0未兑换，1已兑换	resDesc	商品描述
imgData	商品图片，1≤商品图片张数≤5

---

1.3.2兑换商品

---

1.3.2.1兑换商品（获取商品信息）

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

商品详情

缓存时间

0

提交方式

GET

是否登录

否

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
resId	商品id	int		是

返回

{
    "code": 0,
    "message": "操作成功",
    "resId": 440100,
    "resName":"商品名称",
    "resScore":500分,
    "resCount":2,
    "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg"
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
resId	商品id	resName	商品名
resScore	兑换商品所需学分	resCount	剩余商品数
resImage	商品缩略图

---

1.3.2.2 兑换商品（提交资料）

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

提交资料，兑换商品

缓存时间

0

提交方式

post

是否登录

是

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中
resId	商品id	int		是
resCount	兑换商品数量	int		是
resScore	兑换商品消耗学分	int		是
name	用户名	string		是
phoneNum	手机号码	string		是
address	用户地址	string		是
zipCode	用户邮编	string		是

返回

{
    "code": 0,
    "message": "兑换成功",
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0返回对应错误说明	message	接口返回描述信息：兑换成功，商品被抢光，库存不足等

---

1.3.3 兑换成功

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

兑换成功返回信息

缓存时间

0

提交方式

get

是否登录

是

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中
resId	商品id	int		是

返回

{
    "code": 0,
    "message": "兑换成功",
    "resId": 440100,
    "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg"
    "description":"预计1-3个工作日内安排急送，请耐心等待！",
    "name":"小明",
    "phoneNum":"18815234562",
    "address":"广东省广州市天河区高普路115号",
    "zipCode":510000,
    
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
resId	商品id	resImage	兑换成功反馈图片
description	反馈文案	name	收货人姓名
phoneNum	收货人电话	address	收货地址
zipCode	邮编

---

1.3.4兑换记录

---

1.3.4.1兑换记录列表

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

提交资料，兑换商品

缓存时间

0

提交方式

GET

是否登录

是

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中

返回

{
    "code": 0,
    "message": "操作成功",
    "pageCount": 2,
    "pageNo": 1, 
    "pageSize": 20,
    "data": [
        {
            "resId": 440100,
            "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
            "resName": "商品名称商品名称",
            "resStatusDesc": "待发货",
            "resTime": "20150830090000"
        },
    ]

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
pageCount	总页码	pageNo	当前页数
pageSize	每页条数	resId	商品id
resImage	商品缩略图	resStatusDesc	发货状态
resTime	兑换时间

---

1.3.4.2 兑换详情

mrobot地址：

学车后台开发环境：
学车后台线上环境：

说明

兑换成功返回信息

缓存时间

0

提交方式

GET

是否登录

是

数据来源

学车后台

参数

参数名	参数含义	类型	默认值	是否必须	说明
Cookie	用户登录cookie	string		是	登录用户cookie，放在请求头中
resId	商品id	int		是

返回

{
    "code": 0,
    "message": "操作成功",
    "resId": 440100,
    "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg"
    "resName":"正品iPhone6 Plus",
    "resScore":10000,
    "resCount":1,
    "resTime": "20150830090000",
    "resStatusDesc": "已发货",
    "description":"申通快递：12655458445",
    "name":"小明",
    "phoneNum":"18815234562",
    "address":"广东省广州市天河区高普路115号",
    "zipCode":510000,
    
}

返回参数说明

参数名	参数含义	参数名	参数含义
code	接口返回状态码：0成功，非0异常	message	接口返回描述信息
resId	商品id	resImage	商品图片
resName	商品名	resScore	兑换商品所消耗学分
resCount	兑换商品数	resTime	兑换商品提交时间
resStatusDesc	发货状态	description	发货说明
name	收货人姓名	phoneNum	收货人电话
address	收货地址	zipCode	邮编