Changes between Version 3 and Version 4 of pcauto_drive_2.3.0/interface


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

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_drive_2.3.0/interface

    v3 v4  
    6868---------- 
    6969 
    70 === 1.2学分任务列表 === 
    71  
    72 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/TaskList.xsp [[BR]] 
    73 学车后台开发环境:http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getTaskList.do  [[BR]] 
    74 学车后台线上环境:http://task.pcauto.com.cn/driver/appapi/1.0/getTaskList.do [[BR]] 
    75  
    76 **说明** 
    77  
    78 > 获取登录与未登录状态下的学分任务列表,任务列表顺序固定,上到下排序分别是:精华帖、模拟考试首次合格、模拟考试第二次合格、模拟考试第三次合格、模拟考试首次满分、首次分享APP给朋友; 
     70=== 1.2帖子报名功能 === 
     71'''(接口开发中)'''[[BR]] 
     72>mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topicDetail.xsp?tid= [[BR]] 
     73应用后端url:http://bbs.pcauto.com.cn/xcappapi/1/topic/topicDetail.ajax?resp_enc=utf-8&tid=   (获取帖子详情)[[BR]] 
     74                http://xueche.pcauto.com.cn/appapi/1.0/topic/getPraiseCountByTopicId.do?topicId=    (获取帖子赞数)[[BR]] 
     75                http://bbs.pcauto.com.cn/xcappapi/1/topic/photos.do?ajax=true&tid=                (获取主贴图片列表)[[BR]] 
     76 
     77**说明** 
     78 
     79>  
    7980 
    8081**缓存时间** 
     
    9293**数据来源** 
    9394 
    94 >学车后台 
    95  
    96 **参数** 
    97  
    98 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     95>论坛&学车后台 
     96 
     97**参数** 
     98 
     99||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     100||= tid =||= 帖子id =|| string ||=  =||= 是 =||=  =|| 
    99101||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    100102 
    101103**返回** 
    102  
    103 {{{#!java 
    104 { 
    105     data: [ 
    106         { 
    107             application: "driver", 
    108             current: 0, 
    109             done: 0, 
    110             received: 0, 
    111             taskApplogo: "http://www1.pcauto.com.cn/zt/gz20150922/xuefen/1.png", 
    112             taskDesc: "在[圈子]中发帖,被评为精华帖每次奖励20学分,精华帖越多奖励越多。", 
    113             taskId: 41, 
    114             taskLimit: 0, 
    115             taskName: "精华帖", 
    116             taskScore: 20, 
    117             taskType: "可重复任务" 
    118         } 
    119     ], 
    120     message: "ok", 
    121     status: 0, 
    122     tips: "做任务赢学分,可兑换苹果9哦!点此登录", 
    123     version: "v1.0" 
    124 } 
    125 }}} 
    126 **返回参数说明** 
    127 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    128 ||= taskId =||= 任务id =||= taskName =||= 任务名称 =|| 
    129 ||= taskType =||= 任务类型 =||= taskScore =||= 任务奖励 =|| 
    130 ||= taskLimit =||= 完成任务需要的次数 =||= taskDesc =||= 任务描述 =|| 
    131 ||= taskApplogo =||= 图标 =||= done =||= 任务是否已完成(int) =|| 
    132 ||= current =||= 任务当前完成次数(int) =||= =||=  =|| 
    133  
    134 ---------- 
    135  
    136 ==== 1.2.1 判断用户模拟考试的任务完成情况 ==== 
    137 >mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/examTaskStatus.xsp [[BR]] 
    138 学车后台开发环境:http://dev38.pcauto.com.cn:8085/driver/appapi/1.0/getExamTaskStatus.do  [[BR]] 
    139 学车后台线上环境:http://task.pcauto.com.cn/driver/appapi/1.0/getExamTaskStatus.do [[BR]] 
    140  
    141 **说明** 
    142  
    143 > 判断用户学分任务列表完成情况 
    144  
    145 **缓存时间** 
    146  
    147 >0 
    148  
    149 **提交方式** 
    150  
    151 > GET 
    152  
    153 **是否登录** 
    154  
    155 > 是 
    156  
    157 **数据来源** 
    158  
    159 >学车后台 
    160  
    161 **参数** 
    162  
    163 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    164 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    165 ||= userId =||= 用户id =|| string ||=  =||= 是 =||= 用户id =|| 
    166  
    167 **返回** 
    168  
    169 {{{#!java 
    170 { 
    171   "status": "0成功,非0情况为失败或错误" 
    172   "message":"失败原因" 
    173   "version":"版本号" 
    174  
    175   "taskId":"任务id" 
    176   "passingTime":"及格次数" 
    177   "allPass": "是否已得过满分" 
    178 } 
    179 }}} 
    180 **返回参数说明** 
    181 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    182 ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    183 ||= passingTime =||= 已经及格过的次数 =||= allPass =||= 是否已得过满分 =|| 
    184 ||= taskId =||= 任务id =||= =||= =|| 
     104HTML [BR] 
     105 
     106 
     107{{{ 
     108页面内数据说明:在返回的页面里添加了注释数据/*@_HTML_META_START_(数据部分)_HTML_META_END_@*/ 数据内容为  
     109  { 
     110    "title": "学车发帖测试V2",(标题) 
     111    "url": "http://dev11.pcauto.com.cn/bbs7/topic-7809286.html",(分享URL) 
     112    "firstPic": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg"(第一张图) 
     113  } 
     114 
     115页面协议 
     116    pcdrive://reply/floorId  (floorId)楼层id   回复楼层协议 
     117    pcdrive://praise/tid   (tid) 帖子id  点赞协议 
     118    pcdrive://big-photo?data={\"total\":" + total + ",\"currentIndex\":" + currentIndex + ",\"photos\":[" +photos+ "]}  (total)图片总数  (currentIndex)当前图片位置 (photos) 所有图片URL   点击图片协议 
     119}}} 
     120 
     121 
     122---------- 
     123 
     124==== 1.3 启动图接口 ==== 
     125(开发已完成) 
     126>mrobot地址:mrobot.pcauto.com.cn/configs/xueche_qdtdh [[BR]] 
     127后端Url:无 [[BR]] 
     128 
     129**说明** 
     130 
     131> 启动图动画配置 
     132 
     133**缓存时间** 
     134 
     135>0 
     136 
     137**提交方式** 
     138 
     139> GET 
     140 
     141**是否登录** 
     142 
     143> 否 
     144 
     145**数据来源** 
     146 
     147>mrobot后台 
     148 
     149**参数** 
     150 
     151 
     152**返回** 
     153 
     154{{{#!java 
     155{ 
     156    "rule": { 
     157        "delay": 1, 
     158        "interval": 15, 
     159        "age": 3 
     160    }, 
     161    "ad": { 
     162        "img": "http://img0.pcauto.com.cn/pcauto/1508/07/6242801_new.jpg", 
     163        "to-uri": "pcautobrowser://information-article/6840806", 
     164        "vc-uri": "http://192.168.20.6?a=3d", 
     165        "cc-uri": "http://192.168.20.6?a=4d" 
     166    } 
     167} 
     168}}} 
     169**返回参数说明** 
     170||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     171||= delay =||= 延迟显示 =||= interval =||= 间隔显示 =|| 
     172||= age =||= 显示时间 =||= img =||= 图片链接 =|| 
     173||= to-uri =||= 到达页 =||= vc-uri =||= 曝光计数 =|| 
     174||= cc-uri =||= 点击计数 =||= =||= =|| 
    185175 
    186176----------