[[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我的 === '''(获取用户学分接口)'''[[BR]] >mrobot地址： [[BR]] **说明** > 获取用户学分接口[[BR]] **缓存时间** >分钟 **提交方式** > GET **是否登录** > 是 **数据来源** > **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= Cookie =||= 用户登录cookie =|| string ||= =||= 是 =||= 登录用户cookie，放在请求头中 =|| **返回** {{{#!java { "code": 0, "gender": 0, "message": "成功", "score":4000 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= 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 **是否登录** > 登录与未登录都可请求 **数据来源** >CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= Cookie =||= 用户登录cookie =|| string ||= =||= 是 =||= 登录用户cookie，放在请求头中 =|| **返回** 返回HTML页面 **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| **协议** > 点击商品图片跳转到帖子页： pcdrivebrowser://topic-detail/?id=1234 [[BR]] ---------- === 1.4每日抽奖 === >mrobot地址： [[BR]] 学车后台开发环境： [[BR]] 学车后台线上环境： [[BR]] **说明** > 每日抽奖 **缓存时间** >0 **提交方式** > GET **是否登录** > 登录与未登录都可请求 **数据来源** >学车后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= Cookie =||= 用户登录cookie =|| string ||= =||= 是 =||= 登录用户cookie，放在请求头中 =|| **返回** 返回HTML页面 **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| **协议** > 未登录，点击“开始”跳转至登录协议： pcdrivebrowser://user-login [[BR]] > 点击我的奖品跳转： pcdrivebrowser://my-prize ---------- ==== 1.4.1我的奖品 ==== >mrobot地址： [[BR]] 学车后台开发环境： [[BR]] 学车后台线上环境： [[BR]] **说明** > 我的奖品接口，该接口为预留扩展接口，V2.2版本所有用户返回数据都为空数据 **缓存时间** >0 **提交方式** > GET **是否登录** > 是 **数据来源** >学车后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= Cookie =||= 用户登录cookie =|| string ||= =||= 是 =||= 登录用户cookie，放在请求头中 =|| **返回** {{{#!java { "code": 0, "message": "操作成功" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| ||= code =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=|| ---------- == 2.科目三 == ---------- === 2.1科目首页问答接口 === >mrobot地址： [[BR]] 学车后台开发环境： [[BR]] 学车后台线上环境： [[BR]] **说明** > 科目首页问答接口 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= subjectId =||= 科目id =|| int ||= =||= 是 =||= 科目id =|| **返回** {{{#!java { "code": 0, "message": "操作成功", "questionList": [ { "id": 440100, "title": "离合器半联动怎么找？" }, { "id": 434500, "title": "科目三怎么踩离合才是正确的？" } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| ||= code =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=|| ||= id =||= 帖子id =||= title =||= 问答标题 =|| ---------- === 2.2科目首页今日推荐接口 === >mrobot地址： [[BR]] 学车后台开发环境： [[BR]] 学车后台线上环境： [[BR]] **说明** > 科目首页今日推荐接口 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= subjectId =||= 科目id =|| int ||= =||= 是 =||= 科目id =|| **返回** {{{#!java { "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地址： [[BR]] 学车后台开发环境：http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.2.根据城市ID获取考场2.2 [[BR]] 学车后台线上环境： [[BR]] **说明** > 考场实拍，考场列表。V2.2科目三考场只出广州的数据，请求参数cityId由接口端定义（建议不传或给默认值），按首字的首字母顺序排序 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >学车后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= cityId =||= 城市id =|| int ||= =||= 否 =||= V2.2科目三考场只出广州的数据，城市id由接口端定义（建议不传或给默认值） =|| ||= subjectId =||= 科目id =|| int ||= =||= 是 =||= 考场是科目二(subjectId=2),路拍是科目三(subjectId=3) =|| **返回** {{{#!java { "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地址： [[BR]] 学车后台开发环境：http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.3.根据考场ID获取考场详情2.1 [[BR]] 学车后台线上环境： [[BR]] **说明** > 参照V2.1考场详情接口http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.1.0/interface#a2.3考场详情页web页 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >学车后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| **返回** 返回HTML页面 **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| ----------