wiki:pcauto_drive_2.2.0/interface

Version 9 (modified by lianchijin, 11 years ago) (diff)

--

学车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兑换商品(获取商品信息)

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 商品缩略图