Changes between Version 5 and Version 6 of pcauto_drive_2.3.0/interface


Ignore:
Timestamp:
11/10/2015 12:17:49 PM (10 years ago)
Author:
liguokai
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_drive_2.3.0/interface

    v5 v6  
    88     制作地址:[http://zzb.pcauto.com.cn/tools/gongdan/plan.php?id=122] [[BR]]  
    99     应用后端接口trac:[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2] 
     10 
    1011== 1.cms与论坛 == 
    1112---------- 
    12  
    1313 
    1414=== 1.1科目一首页焦点图 === 
     
    123123 
    124124=== 1.3 启动图接口 === 
    125 (开发已完成) 
     125(开发已完成)[[BR]] 
    126126>mrobot地址:mrobot.pcauto.com.cn/configs/xueche_qdtdh [[BR]] 
    127127后端Url:无 [[BR]] 
     
    176176---------- 
    177177 
    178 ==== 1.2.2 判断用户是否已首次分享 ==== 
    179 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/shareAppTaskStatus.xsp [[BR]] 
    180 学车后台开发环境:http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getSharedAppTaskStatus.do  [[BR]] 
    181 学车后台线上环境:http://task.pcauto.com.cn/driver/appapi/1.0/getSharedAppTaskStatus.do [[BR]] 
    182  
    183 **说明** 
    184  
    185 > 判断用户是否已首次分享 
    186  
    187 **缓存时间** 
    188  
    189 >0 
    190  
    191 **提交方式** 
    192  
    193 > GET 
    194  
    195 **是否登录** 
    196  
    197 > 是 
     178== 2.学车后台 == 
     179---------- 
     180 
     181=== 2.1 大小压缩中的交通标志列表页 === 
     182(接口开发中)[[BR]] 
     183>mrobot地址: [[BR]] 
     184学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/traffic/listTrafficSign.do  [[BR]] 
     185学车后台线上环境:http://xueche.pcauto.com.cn/appapi/1.0/traffic/listTrafficSign.do [[BR]] 
     186 
     187**说明** 
     188 
     189> 获取交通标志 
     190 
     191**缓存时间** 
     192 
     193>0 
     194 
     195**提交方式** 
     196 
     197> GET 
     198 
     199**是否登录** 
     200 
     201> 否 
    198202 
    199203**数据来源** 
     
    204208 
    205209||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    206 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    207 ||= userId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =|| 
     210||= typeId =||= 类型 =|| int ||=  =||= 是 =||=  =|| 
     211||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
     212||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
    208213 
    209214**返回** 
     
    211216{{{#!java 
    212217{ 
    213   "status": "0成功,非0情况为失败或错误" 
    214   "message:"失败原因" 
    215   "version":"版本号" 
    216  
    217   "taskId":"任务id" 
    218   "haveShare":"是否已分享" 
     218        code:0成功,-1失败 
     219        message:失败原因 
     220        signCount:总个数 
     221        pageNo:页码 
     222        pageSize:一页个数 
     223        pageCount:总页数 
     224        tracficList:[{ 
     225            img:原图URL 
     226            signName:标志名字 
     227            signDesc:标志描述 
     228        }] 
    219229} 
    220230}}} 
    221231**返回参数说明** 
    222232||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    223 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    224 ||= haveShare =||= 是否已首次分享过 =||= taskId =||= 任务id =|| 
    225  
    226 ---------- 
    227  
    228 ==== 1.2.3 用户赚取学分 ==== 
    229 >非mrobot接口[[BR]] 
    230 学车后台开发环境:http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a2.3.考试及格上传分数接口 [[BR]] 
    231 学车后台线上环境: [[BR]] 
    232  
    233 **说明** 
    234  
    235 > 用户赚取学分接口 
    236  
    237 **缓存时间** 
    238  
    239 >0 
    240  
    241 **提交方式** 
    242  
    243 > POST 
    244  
    245 **是否登录** 
    246  
    247 > 是 
    248  
    249 **数据来源** 
    250  
    251 >学车后台 
    252  
    253 **参数** 
    254  
    255 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    256 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    257 ||= userId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =|| 
    258 ||= score =||= 模拟考试分数 =|| int ||=  =||= 是 =||=  =|| 
    259  
    260 **返回** 
    261  
    262 {{{#!java 
    263 { 
    264     "status": 0, 
    265     "message": "操作成功" 
    266 } 
    267 }}} 
    268 **返回参数说明** 
    269 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    270 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    271  
    272 ---------- 
    273  
    274 === 1.3学分商城 === 
    275  
    276 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/scoreMarket.xsp?score=156158  [[BR]] 
    277 学车后台开发环境: [[BR]] 
    278 学车后台线上环境: [[BR]] 
    279  
    280 **说明** 
    281  
    282 > 学分商城列表 
    283  
    284 **缓存时间** 
    285  
    286 >0 
    287  
    288 **提交方式** 
    289  
    290 > GET 
    291  
    292 **是否登录** 
    293  
    294 >  
    295  
    296 **数据来源** 
    297  
    298 > 
    299  
    300 **参数** 
    301  
    302 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    303 ||= score =||= 用户学分 =|| string ||=  =||= 否 =||= 用户学分  =|| 
    304  
    305 **返回** 
    306  
    307 返回HTML页面 
    308  
    309 **返回参数说明** 
    310 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    311  
    312 **协议** 
    313 > 点击商品图片跳转到帖子页: pcdrivebrowser://topic-detail/?id=1234 [[BR]] 
    314 > 点击登录跳转协议:pcdrivebrowser://user-login  [[BR]] 
    315 > 点击跳转至游戏抽奖页: pcdrivebrowser://game 
    316  
    317 ---------- 
    318  
    319 === 1.4每日抽奖 === 
    320  
    321 游戏后台开发环境: [[BR]] 
    322 游戏后台线上环境:http://activity.pcauto.com.cn/auto151019/index.jsp [[BR]] 
    323  
    324 **说明** 
    325  
    326 > 每日抽奖 
    327   我的学分/我的奖品 
    328   a. 未登录,不显示学分,点击“开始”,跳转到登录页面; 
    329   b. 已登录,显示实时学分,点击“我的奖品”进入奖品列表页(奖品列表页由客户端原生) 
    330  
    331 **缓存时间** 
    332  
    333 >0 
    334  
    335 **提交方式** 
    336  
    337 > GET 
    338  
    339 **是否登录** 
    340  
    341 > 登录与未登录都可请求 
    342  
    343 **数据来源** 
    344  
    345 > 
    346  
    347 **参数** 
    348  
    349 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    350 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    351 ||= score =||= 用户学分 =|| string ||=  =||= 否 =||= 用户学分,未登录不传  =|| 
    352 ||= dev_id =||=  =|| ||=  =||=  =||=   =|| 
    353 ||= open_udid =||=  =|| ||=  =||=  =||=   =|| 
    354 ||= app_ver =||=  =|| ||=  =||=  =||=   =|| 
    355  
    356 **返回** 
    357  
    358 返回HTML页面 
    359  
    360 **返回参数说明** 
    361 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    362  
    363 **协议** 
    364 > 未登录,点击“开始”跳转至登录协议: pcdrivebrowser://user-login [[BR]] 
    365 > 点击我的奖品跳转: pcdrivebrowser://my-prize  
    366  
    367 ---------- 
    368  
    369 ==== 1.4.1我的奖品 ==== 
    370  
    371 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/myPrize.xsp  [[BR]] 
    372 学车后台开发环境: [[BR]] 
    373 学车后台线上环境: [[BR]] 
    374  
    375 **说明** 
    376  
    377 > 我的奖品接口,该接口为预留扩展接口,V2.2版本所有用户返回数据都为空数据 
    378  
    379 **缓存时间** 
    380  
    381 >0 
    382  
    383 **提交方式** 
    384  
    385 > GET 
    386  
    387 **是否登录** 
    388  
    389 > 是 
    390  
    391 **数据来源** 
    392  
    393 >学车后台 
    394  
    395 **参数** 
    396  
    397 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    398  
    399  
    400 **返回** 
    401  
    402 {{{#!java 
    403 {} 
    404 }}} 
    405 **返回参数说明** 
    406 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    407  
    408  
    409 ---------- 
    410  
    411 == 2.科目三 == 
    412 ---------- 
    413  
    414 === 2.1科目首页问答接口 === 
    415  
    416 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/randomQuestion.xsp  [[BR]] 
    417 cms线上环境:http://www.pcauto.com.cn/client/xcbd/1507/intf7331.js [[BR]] 
    418  
    419 **说明** 
    420  
    421 > 科目首页问答接口 
    422  
    423 **缓存时间** 
    424  
    425 >0 
    426  
    427 **提交方式** 
    428  
    429 > GET 
    430  
    431 **是否登录** 
    432  
    433 > 否 
    434  
    435 **数据来源** 
    436  
    437 >CMS 
    438  
    439 **参数** 
    440  
    441 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    442 ||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二:22505,科目三:22487,科目四:22515) =|| 
    443  
    444 **返回** 
    445  
    446 {{{#!java 
    447 { 
    448     "status": 0, 
    449     "message": "操作成功", 
    450     "questionList": [ 
    451         { 
    452             "id": 440100, 
    453             "title": "离合器半联动怎么找?" 
    454         }, 
    455         { 
    456             "id": 434500, 
    457             "title": "科目三怎么踩离合才是正确的?" 
    458         } 
    459     ] 
    460 } 
    461 }}} 
    462 **返回参数说明** 
    463 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    464 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    465 ||= id =||= 帖子id =||= title =||= 问答标题 =|| 
    466  
    467 ---------- 
    468  
    469 === 2.2科目首页今日推荐接口 === 
    470  
    471 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topArticle.xsp  [[BR]] 
    472 cms线上环境:http://www.pcauto.com.cn/client/xcbd/1509/intf7851.js [[BR]] 
    473  
    474 **说明** 
    475  
    476 > 科目首页今日推荐接口 
    477  
    478 **缓存时间** 
    479  
    480 >0 
    481  
    482 **提交方式** 
    483  
    484 > GET 
    485  
    486 **是否登录** 
    487  
    488 > 否 
    489  
    490 **数据来源** 
    491  
    492 >CMS 
    493  
    494 **参数** 
    495  
    496 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    497 ||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二:22505,科目三:22487,科目四:22515,拿本:22695) =|| 
    498  
    499 **返回** 
    500  
    501 {{{#!java 
    502 { 
    503     "status": 0, 
    504     "message": "操作成功", 
    505     "datas": [ 
    506         { 
    507             "title": "文章", 
    508             "id": 440100, 
    509             "type": 1, 
    510             "img": "http://img0.pcauto.com.cn/pcauto/1507/14/g_6728785_1436863917510_240x160.jpg", 
    511             "url": "http://m.pcauto.com.cn/x/679/6790726.html" 
    512         }, 
    513     ] 
    514 } 
    515 }}} 
    516 **返回参数说明** 
    517 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    518 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    519 ||= id =||= 文章id,帖子id =||= type =||= 跳转类型:1文章页,2话题详情页,3专题页面,4游戏页面,5每日抽奖 =|| 
    520 ||= tag =||= 只有第一位出,标签 =||= title =||= 标题 =|| 
    521  
    522 ---------- 
    523  
    524 === 2.3 考场实拍,考场列表 === 
    525  
    526 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/x/xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]] 
    527 学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]] 
    528 学车后台线上环境:http://xueche.pcauto.com.cn/appapi/1.0/examArea/listExamAreaByCity.do?cityId=440100 [[BR]] 
    529  
    530 **说明** 
    531  
    532 > 获取某个城市下的考场列表 
    533  
    534 **缓存时间** 
    535  
    536 >0 
    537  
    538 **提交方式** 
    539  
    540 > GET 
    541  
    542 **是否登录** 
    543  
    544 > 否 
    545  
    546 **数据来源** 
    547  
    548 >学车后台 
    549  
    550 **参数** 
    551  
    552 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    553 ||= cityId =||= 城市id =||= int =||= 无 =||= 是 =||= =|| 
    554 ||= subjectId  =||= 课目ID =||= int =||= 2 =||= 否 =||= (考场是科目二(subjectId=2),路拍是科目三(subjectId=3)),默认subjectId=2 =|| 
    555  
    556 **返回** 
    557  
    558 {{{#!java 
    559 { 
    560     "code": 0, 
    561     "data": [ 
    562         { 
    563             "cityId": 440100, 
    564             "id": 160, 
    565             "name": "秀全驾校", 
    566             "provinceId": 440000, 
    567             "introduction":"", 
    568             "shrinkTagram": [ 
    569                 { 
    570                     "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/07/c0/10835360_1438940428057_&1&.jpg" 
    571                 } 
    572             ], 
    573             "subjectId":2, 
    574             "py":"X", 
    575             "isGeneral":0 
    576         }, 
    577         { 
    578             "cityId": 440100, 
    579             "id": 161, 
    580             "name": "2222", 
    581             "provinceId": 440000, 
    582             "subjectId":2, 
    583             "py":"X", 
    584             "isGeneral":0 
    585         }, 
    586         { 
    587             "cityId": 440100, 
    588             "id": 241, 
    589             "name": "测试考场一", 
    590             "provinceId": 440000, 
    591             "introduction":"", 
    592             "shrinkTagram": [ 
    593                 { 
    594                     "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047652_1439347981183.jpg" 
    595                 }, 
    596                 { 
    597                     "url": "http://img.pcauto.com.cn/images/upload/upc/tx/driver/1508/12/c0/11047636_1439347990058.jpg" 
    598                 } 
    599             ], 
    600             "subjectId":2, 
    601             "py":"X", 
    602             "isGeneral":0 
    603         } 
    604     ], 
    605     "message": "操作成功", 
    606     "version": "v1.0(latest)" 
    607 } 
    608 }}} 
    609 **返回参数说明** 
    610 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    611 ||= cityId =||= 城市id =||=id=||=考场id=|| 
    612 ||= name =||= 考场名称 =||=provinceId=||=省份id=|| 
    613 ||= shrinkTagram =||= 图片 =||= introduction =||= 描述 =|| 
    614 ||= subjectId =||= 科目id =||= isGeneral =||= 是否公用 =|| 
    615  
    616 ---------- 
    617  
    618 === 2.4 考场详情页(web页) === 
    619  
    620 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examAreaDetail.xsp?id=241&resVer=21000&platform=iphone&isShare=1 [[BR]] 
    621 学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]] 
    622 学车后台线上环境: http://xueche.pcauto.com.cn/appapi/1.0/examArea/getExamAreaById.do?id= [[BR]] 
    623  
    624 **说明** 
    625  
    626 > 获取学车后台录入的考场详情。 
    627  
    628 **缓存时间** 
    629  
    630 >0 
    631  
    632 **提交方式** 
    633  
    634 > GET 
    635  
    636 **是否登录** 
    637  
    638 > 否 
    639  
    640 **数据来源** 
    641  
    642 >学车后台 
    643  
    644 **资源包存放路径** 
    645 > http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]] 
    646 > http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_examAreaDetail.json [[BR]] 
    647 > http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_examAreaDetail.json [[BR]] 
    648   
    649 **参数** 
    650  
    651 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    652 ||= id =||= 考场id =||= int =||=  =||= 是 =||=  =|| 
    653 ||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =|| 
    654 ||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事定 =|| 
    655 ||= isShare =||= 是否分享 =||= int =||=  =||= 是 =||= 1:出分享页;0:出详情页 =|| 
    656  
    657 **返回** 
    658  
    659 返回HTML页面 
    660  
    661 注释: 
    662         /*@_HTML_META_START_ 
    663         {"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"} 
    664         _HTML_META_END_@*/ 
    665  
    666 **返回参数说明** 
    667 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    668 ||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=|| 
    669 ||= firstImg =||= 第一张图片 =||==||==|| 
    670  
    671 **协议** 
    672 > 图片跳转: pcdrive://big-photo?url= [[BR]] 
    673 ---------- 
    674  
    675 === 2.5基础知识 === 
    676  
    677 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/basicKnowledge.xsp?id=6483971 [[BR]] 
    678 cms开发环境:http://test2.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]] 
    679 cms线上环境:http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v5.jsp?id=6483971 [[BR]] 
    680  
    681 **说明** 
    682  
    683 > 获取基础知识主页 
    684  
    685 **缓存时间** 
    686  
    687 >分钟 
    688  
    689 **提交方式** 
    690  
    691 > GET 
    692  
    693 **是否登录** 
    694  
    695 > 否 
    696  
    697 **数据来源** 
    698  
    699 >cms 
    700  
    701 **参数** 
    702  
    703 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
    704 ||= id =||= 文章id =||= int=||=  =||= 是 =|| 
    705  
    706 **返回** 
    707  
    708 {{{#!java 
    709 { 
    710     "author": "moyingchao", 
    711     "id": "6483971", 
    712     "image": "", 
    713     "image2": "", 
    714     "pageNum": 7, 
    715     "preView": "各位都知道,科目二是需要上车实操的,到了考试时,考员有必要提前调节好车内的东西,", 
    716     "pubDate": 1439369785713, 
    717     "tagWords": [], 
    718     "tags": [ 
    719         { 
    720             "pageNo": 2, 
    721             "picText": [ 
    722                 { 
    723                     "pic": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg", 
    724                     "text": "● 车门开关  将后视镜调整到自己日常练车的位置,以便自己找到熟悉的感觉。    啊岁的老将阿隆索大家啊三季度刻录机啊斯达康洛吉拉斯简单快乐" 
    725                 } 
    726             ], 
    727             "tagName": "车门开关" 
    728         } 
    729      ], 
    730     "title": "科目二基础操作测试用", 
    731     "url": "http://www.pcauto.com.cn/techtest/648/6483971.html", 
    732     "wapUrl": "http://m.pcauto.com.cn/x/648/6483971.html" 
    733  
    734 } 
    735  
    736 }}} 
    737  
    738 **返回参数说明** 
    739 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    740 ||= author =||= 作者 =||=id=||=文章id=|| 
    741 ||= pageNum =||= 页数 =||=image=||=图片=|| 
    742 ||= preView =||= 概述 =||=pubDate=||=发布日期=|| 
    743 ||= pageNo =||= 页码 =||=pic=||=文章图=|| 
    744 ||= text =||= 文章内容 =||=tagName=||=标签=|| 
    745 ||= title =||= 标题 =||=url=||=pc端链接=|| 
    746 ||= wapUrl =||= wap链接 =||==||==|| 
    747  
    748  
    749 ---------- 
    750  
    751 === 2.6 夜考、完整版 === 
    752  
    753 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/articles.xsp?id=6483971&resVer=21000&platform=iphone&type=1 [[BR]] 
    754 cms开发环境:http://test1.pcauto.com.cn:8002/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]] 
    755 cms线上环境:http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=6483971 [[BR]] 
    756  
    757 **说明** 
    758  
    759 > 获取cms录入的考试文章[[BR]] 
    760  
    761 **缓存时间** 
    762  
    763 >分钟 
    764  
    765 **提交方式** 
    766  
    767 > GET 
    768  
    769 **是否登录** 
    770  
    771 > 否 
    772  
    773 **数据来源** 
    774  
    775 > cms 
    776  
    777 **资源包存放路径** 
    778 > http://dev40.pcauto.com.cn:8002/configs.jsp [[BR]] 
    779 > http://dev40.pcauto.com.cn/configs/pcauto_iphone_xueche_articles.json [[BR]] 
    780 > http://dev40.pcauto.com.cn/configs/pcauto_android_xueche_articles.json [[BR]] 
    781  
    782 **参数** 
    783  
    784 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
    785 ||= pageNo =||= 页数 =||int||= 1 =||= 否 =||=  =|| 
    786 ||= allText =||= 是否出全文 =||int||= 0 =||= 否 =||= 为1时返回全文内容 =|| 
    787 ||= id =||=文章ID =||= string =||=  =||= 是 =||= 应用端需要 =|| 
    788 ||= platform =||=设备类型 =||= string =||=  =||= 是 =||= iphone,android =|| 
    789 ||= resVer =||=资源包版本 =||= string =||=  =||= 是 =||= 版本号由app同事配置 =|| 
    790 ||= type =||=页面类型 =||= string =||=  =||= 是 =||= 1:文章终端页,2:倒车入库,3:必过版(除倒车入库) =|| 
    791 ||= isTarget =||= 跳转难点攻克 =||int||=  =||= 否 =||= 为1时跳转到难点攻克 =|| 
    792 **返回** 
    793  
    794 返回HTML页面 
    795  
    796 注释: 
    797         /*@_HTML_META_START_ 
    798         {"resVer":"21001","shareUrl":"","firstImg":"http://img0.pcauto.com.cn/pcauto/1508/06/6502326_4_thumb.jpg"} 
    799         _HTML_META_END_@*/ 
    800  
    801 **返回参数说明** 
    802 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    803 ||= resVer =||= 资源包版本号 =||=shareUrl =||=分享url=|| 
    804 ||= firstImg =||= 第一张图片 =||==||==|| 
    805  
    806 **协议** 
    807 > 图片跳转: pcdrive://big-photo?url= [[BR]] 
    808 > 小游戏: pcdrive://game 
    809  
    810  
    811 ---------- 
    812  
    813 == 3.0 邀请码 == 
    814 ---------- 
    815  
    816 === 3.1 注册设备号 === 
    817 >非mrobot接口  [[BR]] 
    818 学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/registerDevice.do [[BR]] 
    819 学车后台线上环境:http://xueche.pcauto.com.cn/appapi/1.0/invite/registerDevice.do [[BR]] 
    820  
    821 **说明** 
    822  
    823 > 注册设备号接口,app启动后将设备id传至学车后台,post成功后不再请求 
    824  
    825 **缓存时间** 
    826  
    827 >0 
    828  
    829 **提交方式** 
    830  
    831 > POST 
    832  
    833 **是否登录** 
    834  
    835 > 否 
    836  
    837 **数据来源** 
    838  
    839 >学车后台 
    840  
    841 **参数** 
    842  
    843 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    844 ||= deviceCode =||= 设备id =|| string ||=  =||= 是 =||= 设备id =|| 
    845 ||= timeStamp =||= 时间戳 =|| string ||=  =||= 是 =||= 时间戳 =|| 
    846 ||= token =||= md5加密 =|| string ||=  =||= 是 =||= md5(密钥+时间戳+密钥+设备ID) =|| 
    847  
    848 **返回** 
    849  
    850 {{{#!java 
    851 { 
    852     "status": 0, 
    853     "message": "操作成功" 
    854 } 
    855 }}} 
    856 **返回参数说明** 
    857 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    858 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    859  
    860 ---------- 
    861  
    862 === 3.2 获取邀请码页面 === 
    863 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/inputInvitation.xsp  [[BR]] 
    864 学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/getInvite.do [[BR]] 
    865                   http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/getMyInviteCount.do [[BR]] 
    866 学车后台线上环境:http://xueche.pcauto.com.cn/appapi/1.0/invite/getInvite.do [[BR]] 
    867                   http://xueche.pcauto.com.cn/appapi/1.0/invite/getMyInviteCount.do [[BR]] 
    868 **说明** 
    869  
    870 > 获取邀请码页面 
    871  
    872 **缓存时间** 
    873  
    874 >0 
    875  
    876 **提交方式** 
    877  
    878 > GET 
    879  
    880 **是否登录** 
    881  
    882 > 是 
    883  
    884 **数据来源** 
    885  
    886 > 学车后台 
    887  
    888 **参数** 
    889  
    890 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    891 ||= accountId =||= 用户id =|| string ||=  =||= 是 =||=  =|| 
    892  
    893 **返回** 
    894  
    895 {{{#!java 
    896 { 
    897     "code": 0, 
    898     "message": "操作成功", 
    899     "thisMonthInviteCount": 0, 
    900     "totalInviteCount": 0, 
    901     "totalInviterAmount":0, 
    902     "version": "v1.0(latest)", 
    903     "inviteId": 11, 
    904     "shareUrl": "http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getInvitation.xsp?code=11" 
    905 } 
    906 }}} 
    907  
    908 **返回参数说明** 
    909 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    910 ||= thisMonthInviteCount =||= 本月邀请人数 =||= totalInviteCount =||= 累计邀请人数 =|| 
    911 ||= inviteId =||= 邀请码 =||= shareUrl =||= 分享链接 =|| 
    912 ||= totalInviterAmount =||= 总共获得邀请的学分 =|| 
    913  
    914 ---------- 
    915  
    916 === 3.3 填写邀请码 === 
    917 >非mrobot接口  [[BR]] 
    918 学车后台开发环境:http://dev38.pcauto.com.cn:8003/appapi/1.0/invite/inviteUser.do  [[BR]] 
    919 学车后台线上环境:http://xueche.pcauto.com.cn/appapi/1.0/invite/inviteUser.do  [[BR]] 
    920  
    921 **说明** 
    922  
    923 > 填写邀请码接口 
    924  
    925 **缓存时间** 
    926  
    927 >0 
    928  
    929 **提交方式** 
    930  
    931 > POST 
    932  
    933 **是否登录** 
    934  
    935 > 是 
    936  
    937 **数据来源** 
    938  
    939 >学车后台 
    940  
    941 **参数** 
    942  
    943 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    944 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    945 ||= deviceCode =||= 设备id =|| string ||=  =||= 是 =||= 设备id =|| 
    946 ||= inviteId =||= 邀请码 =|| string ||=  =||= 是 =||= 邀请码 =|| 
    947 ||= agent =||= 来自平台 =|| int ||=  =||= 是 =||= 来自平台:2iOS,3安卓 =|| 
    948 ||= accountId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =|| 
    949  
    950 **返回** 
    951  
    952 {{{#!java 
    953 { 
    954     "status": 0, 
    955     "message": "邀请成功" 
    956 } 
    957 }}} 
    958 **返回参数说明** 
    959 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    960 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||= 邀请成功与否的提示信息 =|| 
    961  
    962 ---------- 
    963  
    964 == 4.0 优化点 == 
    965 ---------- 
    966  
    967 === 4.1 点赞接口 === 
    968 >非mrobot接口  [[BR]] 
    969 学车后台开发环境: http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2#a4.1点赞 [[BR]] 
    970 学车后台线上环境: [[BR]] 
    971  
    972 **说明** 
    973  
    974 > 如果不是那8个学车论坛的帖子,是不能点赞的。 
    975  
    976 **缓存时间** 
    977  
    978 >0 
    979  
    980 **提交方式** 
    981  
    982 > POST 
    983  
    984 **是否登录** 
    985  
    986 > 是 
    987  
    988 **数据来源** 
    989  
    990 >学车后台 
    991  
    992 **参数** 
    993  
    994 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    995 ||= Cookie =||= 用户登录cookie =||= string =||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    996 ||= topicId  =||= 帖子id =||= LONG =||=  =||= 是 =||=  =|| 
    997  
    998 **返回** 
    999  
    1000 {{{#!java 
    1001 { 
    1002     "code" : 0, 
    1003     "message": "操作成功", 
    1004     "version": 1.0, 
    1005 } 
    1006 }}} 
    1007 **返回参数说明** 
    1008 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    1009 ||= code =||= 0成功,-1失败,-2未登录,-3贴子不存在(学车找不到贴子,就是不属于学车8个板块) =||= message =||= 接口返回描述信息 =|| 
    1010 ||= version =||= 接口版本号如1.0,1.0(latest)表示最新版本 =||=  =||=  =|| 
    1011  
    1012 ---------- 
    1013  
    1014 === 4.2 取消点赞接口 === 
    1015 >非mrobot接口  [[BR]] 
    1016 学车后台开发环境: http://rdtrac.pc.com.cn/xueche/wiki/appapi/1.2#a1.2.6取消点赞 [[BR]] 
    1017 学车后台线上环境: [[BR]] 
    1018  
    1019 **说明** 
    1020  
    1021 > 如果不是那8个学车论坛的帖子,是不能取消点赞的。1.2取消点赞接口新增字段判断是否属于8个论坛的帖子 
    1022  
    1023 **缓存时间** 
    1024  
    1025 >0 
    1026  
    1027 **提交方式** 
    1028  
    1029 > POST 
    1030  
    1031 **是否登录** 
    1032  
    1033 > 是 
    1034  
    1035 **数据来源** 
    1036  
    1037 >学车后台 
    1038  
    1039 **参数** 
    1040  
    1041 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    1042 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    1043 ||= =||= 用户id =|| string ||=  =||= 是 =||= 用户id =|| 
    1044  
    1045 **返回** 
    1046  
    1047 {{{#!java 
    1048 { 
    1049     "status": 0, 
    1050     "message": "操作成功", 
    1051     "version": 1.0, 
    1052     "fromForum": true 
    1053 } 
    1054 }}} 
    1055 **返回参数说明** 
    1056 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    1057 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    1058 ||= version =||= 接口版本号如1.0,1.0(latest)表示最新版本 =||= fromForum =||= 新增字段,判断是否来自8个论坛 =|| 
    1059  
    1060 ---------- 
     233 
     234----------