[[TOC]]

= 学车2.2.0接口文档 =
>mrobot代理环境说明： 
     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]] 
     192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] 
     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]] 
     制作地址： [[BR]] 
     应用后端接口trac：
== 1.学分任务与商城 ==
----------


=== 1.1我的 ===
'''(V1.1版本 2.7获取个人信息接口增加返回用户学分字段)'''[[BR]]
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getPersonalinf.xsp [[BR]]

**说明**

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

**缓存时间**

>分钟

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

> 

**参数**

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

**返回**

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

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= score =||= 用户学分（新增字段） =||= =||==||

----------

== 1.2学分任务列表 ==

>mrobot地址：  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 获取登录与未登录状态下的学分任务列表，任务列表顺序固定，上到下排序分别是：精华帖、模拟考试首次合格、模拟考试第二次合格、模拟考试第三次合格、模拟考试首次满分、首次分享APP给朋友；

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "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地址：  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 学分商场列表

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "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地址：  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 商品详情

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "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地址：  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 商品详情

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "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 =||= 商品缩略图 =||=  =||=  =||