[[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]] 
     制作地址：[http://zzb.pcauto.com.cn/tools/gongdan/plan.php?id=122] [[BR]] 
     应用后端接口trac：[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2]
== 1.学分任务与商城 ==
----------


=== 1.1我的 ===
'''(接口已完成，请连开发机测试)'''[[BR]]
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/myScore.xsp [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getUserScore.do  [[BR]]
学车后台线上环境：http://task.pcauto.com.cn/driver/appapi/1.0/getUserScore.do [[BR]]

**说明**

> 获取用户学分接口[[BR]]

**缓存时间**

>分钟

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

> 学车后台

**参数**

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

**返回**

{{{#!java
{
      "status": 0,
      "message": "成功",
      "version"："版本号",
      "userId": "用户id",
      "score":4000
}
}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=||
||= score =||= 用户学分 =||= userId =||= 用户id =||
||= version =||= 版本号 =||= =||= =||

----------

=== 1.2学分任务列表 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/TaskList.xsp [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getTaskList.do  [[BR]]
学车后台线上环境：http://task.pcauto.com.cn/driver/appapi/1.0/getTaskList.do [[BR]]

**说明**

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

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    data: [
        {
            application: "driver",
            current: 0,
            done: 0,
            received: 0,
            taskApplogo: "http://www1.pcauto.com.cn/zt/gz20150922/xuefen/1.png",
            taskDesc: "在[圈子]中发帖，被评为精华帖每次奖励20学分，精华帖越多奖励越多。",
            taskId: 41,
            taskLimit: 0,
            taskName: "精华帖",
            taskScore: 20,
            taskType: "可重复任务"
        }
    ],
    message: "ok",
    status: 0,
    tips: "做任务赢学分，可兑换苹果9哦！点此登录",
    version: "v1.0"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= taskId =||= 任务id =||= taskName =||= 任务名称 =||
||= taskType =||= 任务类型 =||= taskScore =||= 任务奖励 =||
||= taskLimit =||= 完成任务需要的次数 =||= taskDesc =||= 任务描述 =||
||= taskApplogo =||= 图标 =||= done =||= 任务是否已完成(int) =||
||= current =||= 任务当前完成次数(int) =||= =||=  =||

----------

==== 1.2.1 判断用户模拟考试的任务完成情况 ====
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examTaskStatus.xsp [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getExamTaskStatus.do  [[BR]]
学车后台线上环境：http://task.pcauto.com.cn/driver/appapi/1.0/getExamTaskStatus.do [[BR]]

**说明**

> 判断用户学分任务列表完成情况

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
  "status": "0成功，非0情况为失败或错误"
  "message"："失败原因"
  "version"："版本号"

  "taskId"："任务id"
  "passingTime"："及格次数"
  "allPass": "是否已得过满分"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||= 接口返回描述信息 =||
||= passingTime =||= 已经及格过的次数 =||= allPass =||= 是否已得过满分 =||
||= taskId =||= 任务id =||= =||= =||

----------

==== 1.2.2 判断用户是否已首次分享 ====
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/shareAppTaskStatus.xsp [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getSharedAppTaskStatus.do  [[BR]]
学车后台线上环境：http://task.pcauto.com.cn/driver/appapi/1.0/getSharedAppTaskStatus.do [[BR]]

**说明**

> 判断用户是否已首次分享

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
  "status": "0成功，非0情况为失败或错误"
  "message："失败原因"
  "version"："版本号"

  "taskId"："任务id"
  "haveShare"："是否已分享"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||= 接口返回描述信息 =||
||= haveShare =||= 是否已首次分享过 =||= taskId =||= 任务id =||

----------

==== 1.2.3 用户赚取学分 ====
>非mrobot接口[[BR]]
学车后台开发环境：http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.3.考试及格上传分数接口 [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 用户赚取学分接口

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =||
||= userId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =||
||= score =||= 模拟考试分数 =|| int ||=  =||= 是 =||=  =||

**返回**

{{{#!java
{
    "status": 0,
    "message": "操作成功"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||= 接口返回描述信息 =||

----------

=== 1.3学分商城 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/scoreMarket.xsp?score=156158  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 学分商城列表

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 

**数据来源**

>

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= score =||= 用户学分 =|| string ||=  =||= 否 =||= 用户学分  =||

**返回**

返回HTML页面

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||

**协议**
> 点击商品图片跳转到帖子页： pcdrivebrowser://topic-detail/?id=1234 [[BR]]
> 点击登录跳转协议：pcdrivebrowser://user-login  [[BR]]
> 点击跳转至游戏抽奖页: pcdrivebrowser://game

----------

=== 1.4每日抽奖 ===

游戏后台开发环境： [[BR]]
游戏后台线上环境：http://activity.pcauto.com.cn/auto151019/index.jsp [[BR]]

**说明**

> 每日抽奖
  我的学分/我的奖品
  a. 未登录，不显示学分，点击“开始”，跳转到登录页面；
  b. 已登录，显示实时学分，点击“我的奖品”进入奖品列表页（奖品列表页由客户端原生）

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =||
||= score =||= 用户学分 =|| string ||=  =||= 否 =||= 用户学分，未登录不传  =||
||= dev_id =||=  =|| ||=  =||=  =||=   =||
||= open_udid =||=  =|| ||=  =||=  =||=   =||
||= app_ver =||=  =|| ||=  =||=  =||=   =||

**返回**

返回HTML页面

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||

**协议**
> 未登录，点击“开始”跳转至登录协议： pcdrivebrowser://user-login [[BR]]
> 点击我的奖品跳转： pcdrivebrowser://my-prize 

----------

==== 1.4.1我的奖品 ====

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/myPrize.xsp  [[BR]]
学车后台开发环境： [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 我的奖品接口，该接口为预留扩展接口，V2.2版本所有用户返回数据都为空数据

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||


**返回**

{{{#!java
{}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||


----------

== 2.科目三 ==
----------

=== 2.1科目首页问答接口 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/randomQuestion.xsp  [[BR]]
cms线上环境：http://www.pcauto.com.cn/client/xcbd/1507/intf7331.js [[BR]]

**说明**

> 科目首页问答接口

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>CMS

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二：22505,科目三：22487,科目四：22515) =||

**返回**

{{{#!java
{
    "status": 0,
    "message": "操作成功",
    "questionList": [
        {
            "id": 440100,
            "title": "离合器半联动怎么找？"
        },
        {
            "id": 434500,
            "title": "科目三怎么踩离合才是正确的？"
        }
    ]
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=||
||= id =||= 帖子id =||= title =||= 问答标题 =||

----------

=== 2.2科目首页今日推荐接口 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topArticle.xsp  [[BR]]
cms线上环境：http://www.pcauto.com.cn/client/xcbd/1509/intf7851.js [[BR]]

**说明**

> 科目首页今日推荐接口

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>CMS

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二：22505,科目三：22487,科目四：22515,拿本：22695) =||

**返回**

{{{#!java
{
    "status": 0,
    "message": "操作成功",
    "datas": [
        {
            "title": "文章",
            "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"
        },
    ]
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=||
||= id =||= 文章id，帖子id =||= type =||= 跳转类型：1文章页，2话题详情页，3专题页面，4游戏页面，5每日抽奖 =||
||= tag =||= 只有第一位出,标签 =||= title =||= 标题 =||

----------

=== 2.3 考场实拍，考场列表 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]
学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]]

**说明**

> 获取某个城市下的考场列表

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= cityId =||= 城市id =||= int =||= 无 =||= 是 =||= =||
||= subjectId  =||= 课目ID =||= int =||= 2 =||= 否 =||= （考场是科目二(subjectId=2),路拍是科目三(subjectId=3)）,默认subjectId=2 =||

**返回**

{{{#!java
{
    "code": 0,
    "data": [
        {
            "cityId": 440100,
            "id": 160,
            "name": "秀全驾校",
            "provinceId": 440000,
            "introduction":"",
            "shrinkTagram": [
                {
                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/07/c0/10835360_1438940428057_&1&.jpg"
                }
            ],
            "subjectId":2,
            "py":"X",
            "isGeneral":0
        },
        {
            "cityId": 440100,
            "id": 161,
            "name": "2222",
            "provinceId": 440000,
            "subjectId":2,
            "py":"X",
            "isGeneral":0
        },
        {
            "cityId": 440100,
            "id": 241,
            "name": "测试考场一",
            "provinceId": 440000,
            "introduction":"",
            "shrinkTagram": [
                {
                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047652_1439347981183.jpg"
                },
                {
                    "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047636_1439347990058.jpg"
                }
            ],
            "subjectId":2,
            "py":"X",
            "isGeneral":0
        }
    ],
    "message": "操作成功",
    "version": "v1.0(latest)"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= cityId =||= 城市id =||=id=||=考场id=||
||= name =||= 考场名称 =||=provinceId=||=省份id=||
||= shrinkTagram =||= 图片 =||= introduction =||= 描述 =||
||= subjectId =||= 科目id =||= isGeneral =||= 是否公用 =||

----------

=== 2.4 考场详情页（web页） ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?id=241&resVer=21000&platform=iphone&isShare=1 [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]]
学车后台线上环境： http://xueche.pcauto.com.cn/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]]

**说明**

> 获取学车后台录入的考场详情。

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>学车后台

**资源包存放路径**
> http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]]
> http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_examAreaDetail.json [[BR]]
> http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_examAreaDetail.json [[BR]]
 
**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= id =||= 考场id =||= int =||=  =||= 是 =||=  =||
||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事定 =||
||= isShare =||= 是否分享 =||= int =||=  =||= 是 =||= 1：出分享页；0：出详情页 =||

**返回**

返回HTML页面

注释：
        /*@_HTML_META_START_
        {"resVer":"21001","shareUrl":"http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?         id=241&resVer=21000&platform=iphone&isShare=1","firstImg":"http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047637_1439348002343_600x450.jpg"}
        _HTML_META_END_@*/

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=||
||= firstImg =||= 第一张图片 =||==||==||

**协议**
> 图片跳转： pcdrive://big-photo?url= [[BR]]
----------

=== 2.5基础知识 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/basicKnowledge.xsp?id=6483971 [[BR]]
cms开发环境：http://test2.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]]
cms线上环境：http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]]

**说明**

> 获取基础知识主页

**缓存时间**

>分钟

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>cms

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||= id =||= 文章id =||= int=||=  =||= 是 =||

**返回**

{{{#!java
{
    "author": "moyingchao",
    "id": "6483971",
    "image": "",
    "image2": "",
    "pageNum": 7,
    "preView": "各位都知道，科目二是需要上车实操的，到了考试时，考员有必要提前调节好车内的东西，",
    "pubDate": 1439369785713,
    "tagWords": [],
    "tags": [
        {
            "pageNo": 2,
            "picText": [
                {
                    "pic": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg",
                    "text": "● 车门开关　　将后视镜调整到自己日常练车的位置，以便自己找到熟悉的感觉。    啊岁的老将阿隆索大家啊三季度刻录机啊斯达康洛吉拉斯简单快乐"
                }
            ],
            "tagName": "车门开关"
        }
     ],
    "title": "科目二基础操作测试用",
    "url": "http://www.pcauto.com.cn/techtest/648/6483971.html",
    "wapUrl": "http://m.pcauto.com.cn/x/648/6483971.html"

}

}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= author =||= 作者 =||=id=||=文章id=||
||= pageNum =||= 页数 =||=image=||=图片=||
||= preView =||= 概述 =||=pubDate=||=发布日期=||
||= pageNo =||= 页码 =||=pic=||=文章图=||
||= text =||= 文章内容 =||=tagName=||=标签=||
||= title =||= 标题 =||=url=||=pc端链接=||
||= wapUrl =||= wap链接 =||==||==||


----------

=== 2.6 夜考、完整版 ===

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/articles.xsp?id=6483971&resVer=21000&platform=iphone&type=1 [[BR]]
cms开发环境：http://test1.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]]
cms线上环境：http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]]

**说明**

> 获取cms录入的考试文章[[BR]]

**缓存时间**

>分钟

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

> cms

**资源包存放路径**
> http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]]
> http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_articles.json [[BR]]
> http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_articles.json [[BR]]

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||= pageNo =||= 页数 =||int||= 1 =||= 否 =||=  =||
||= allText =||= 是否出全文 =||int||= 0 =||= 否 =||= 为1时返回全文内容 =||
||= id =||=文章ID =||= string =||=  =||= 是 =||= 应用端需要 =||
||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =||
||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事配置 =||
||= type =||=页面类型 =||= string =||=  =||= 是 =||= 1：文章终端页，2：倒车入库，3：必过版（除倒车入库） =||
||= isTarget =||= 跳转难点攻克 =||int||=  =||= 否 =||= 为1时跳转到难点攻克 =||
**返回**

返回HTML页面

注释：
        /*@_HTML_META_START_
        {"resVer":"21001","shareUrl":"","firstImg":"http://img0.pcauto.com.cn/pcauto/1508/06/6502326_4_thumb.jpg"}
        _HTML_META_END_@*/

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=||
||= firstImg =||= 第一张图片 =||==||==||

**协议**
> 图片跳转： pcdrive://big-photo?url= [[BR]]
> 小游戏： pcdrive://game


----------

== 3.0 邀请码 ==
----------

=== 3.1 注册设备号 ===
>非mrobot接口  [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/registerDevice.do [[BR]]
学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/invite/registerDevice.do [[BR]]

**说明**

> 注册设备号接口，app启动后将设备id传至学车后台，post成功后不再请求

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 否

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= deviceCode =||= 设备id =|| string ||=  =||= 是 =||= 设备id =||
||= timeStamp =||= 时间戳 =|| string ||=  =||= 是 =||= 时间戳 =||
||= token =||= md5加密 =|| string ||=  =||= 是 =||= md5(密钥+时间戳+密钥+设备ID) =||

**返回**

{{{#!java
{
    "status": 0,
    "message": "操作成功"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=||

----------

=== 3.2 获取邀请码页面 ===
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/inputInvitation.xsp  [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/getInvite.do [[BR]]
                  http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/getMyInviteCount.do [[BR]]
学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/invite/getInvite.do [[BR]]
                  http://xueche.pcauto.com.cn/appapi/1.0/invite/getMyInviteCount.do [[BR]]
**说明**

> 获取邀请码页面

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 是

**数据来源**

> 学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= accountId =||= 用户id =|| string ||=  =||= 是 =||=  =||

**返回**

{{{#!java
{
    "code": 0,
    "message": "操作成功",
    "thisMonthInviteCount": 0,
    "totalInviteCount": 0,
    "totalInviterAmount":0,
    "version": "v1.0(latest)",
    "inviteId": 11,
    "shareUrl": "http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getInvitation.xsp?code=11"
}
}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= thisMonthInviteCount =||= 本月邀请人数 =||= totalInviteCount =||= 累计邀请人数 =||
||= inviteId =||= 邀请码 =||= shareUrl =||= 分享链接 =||
||= totalInviterAmount =||= 总共获得邀请的学分 =||

----------

=== 3.3 填写邀请码 ===
>非mrobot接口  [[BR]]
学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/inviteUser.do  [[BR]]
学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/invite/inviteUser.do  [[BR]]

**说明**

> 填写邀请码接口

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =||
||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =||
||= deviceCode =||= 设备id =|| string ||=  =||= 是 =||= 设备id =||
||= inviteId =||= 邀请码 =|| string ||=  =||= 是 =||= 邀请码 =||
||= agent =||= 来自平台 =|| int ||=  =||= 是 =||= 来自平台：2iOS，3安卓 =||
||= accountId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =||

**返回**

{{{#!java
{
    "status": 0,
    "message": "邀请成功"
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||= 邀请成功与否的提示信息 =||

----------

== 4.0 优化点 ==
----------

=== 4.1 点赞接口 ===
>非mrobot接口  [[BR]]
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a4.1点赞 [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 如果不是那8个学车论坛的帖子，是不能点赞的。

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "code" : 0,
    "message": "操作成功",
    "version": 1.0,
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= code =||= 0成功，-1失败，-2未登录,-3贴子不存在（学车找不到贴子，就是不属于学车8个板块） =||= message =||= 接口返回描述信息 =||
||= version =||= 接口版本号如1.0，1.0（latest)表示最新版本 =||=  =||=  =||

----------

=== 4.2 取消点赞接口 ===
>非mrobot接口  [[BR]]
学车后台开发环境： http://rdtrac.pc.com.cn/xueche/wiki/appapi/1.2#a1.2.6取消点赞 [[BR]]
学车后台线上环境： [[BR]]

**说明**

> 如果不是那8个学车论坛的帖子，是不能取消点赞的。1.2取消点赞接口新增字段判断是否属于8个论坛的帖子

**缓存时间**

>0

**提交方式**

> POST

**是否登录**

> 是

**数据来源**

>学车后台

**参数**

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

**返回**

{{{#!java
{
    "status": 0,
    "message": "操作成功",
    "version": 1.0,
    "fromForum": true
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||= 接口返回描述信息 =||
||= version =||= 接口版本号如1.0，1.0（latest)表示最新版本 =||= fromForum =||= 新增字段，判断是否来自8个论坛 =||

----------