Changes between Version 14 and Version 15 of pcauto_drive_2.2.0/interface


Ignore:
Timestamp:
09/17/2015 06:51:01 PM (11 years ago)
Author:
lianchijin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_drive_2.2.0/interface

    v14 v15  
    145145**数据来源** 
    146146 
     147>CMS 
     148 
     149**参数** 
     150 
     151||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     152||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
     153 
     154**返回** 
     155 
     156返回HTML页面 
     157 
     158**返回参数说明** 
     159||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
     160 
     161**协议** 
     162> 点击商品图片跳转到帖子页: pcdrivebrowser://topic-detail/?id=1234 [[BR]] 
     163 
     164---------- 
     165 
     166== 1.4每日抽奖 == 
     167 
     168>mrobot地址:  [[BR]] 
     169学车后台开发环境: [[BR]] 
     170学车后台线上环境: [[BR]] 
     171 
     172**说明** 
     173 
     174> 每日抽奖 
     175 
     176**缓存时间** 
     177 
     178>0 
     179 
     180**提交方式** 
     181 
     182> GET 
     183 
     184**是否登录** 
     185 
     186> 登录与未登录都可请求 
     187 
     188**数据来源** 
     189 
     190>学车后台 
     191 
     192**参数** 
     193 
     194||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     195||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
     196 
     197**返回** 
     198 
     199返回HTML页面 
     200 
     201**返回参数说明** 
     202||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
     203 
     204**协议** 
     205> 未登录,点击“开始”跳转至登录协议: pcdrivebrowser://user-login [[BR]] 
     206> 点击我的奖品跳转: pcdrivebrowser://my-prize  
     207 
     208---------- 
     209 
     210=== 1.4.1我的奖品 === 
     211 
     212>mrobot地址:  [[BR]] 
     213学车后台开发环境: [[BR]] 
     214学车后台线上环境: [[BR]] 
     215 
     216**说明** 
     217 
     218> 我的奖品接口,该接口为预留扩展接口,V2.2版本所有用户返回数据都为空数据 
     219 
     220**缓存时间** 
     221 
     222>0 
     223 
     224**提交方式** 
     225 
     226> GET 
     227 
     228**是否登录** 
     229 
     230> 是 
     231 
     232**数据来源** 
     233 
    147234>学车后台 
    148235 
     
    157244{ 
    158245    "code": 0, 
    159     "message": "操作成功", 
    160     "score":5000, 
    161     "tips":"做任务赢学分,可兑换苹果9哦!点此登录", 
    162     "gameTips":"今天又苹果6", 
    163     "recordsTips":"查看囊中物", 
    164     "pageCount": 2, 
    165     "pageNo": 1,  
    166     "pageSize": 20, 
    167     "data": [ 
    168         { 
    169             "resId": 440100, 
    170             "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg", 
    171             "resName": "苹果9", 
    172             "resStatusDesc": "9000分", 
    173             "resStatus": 0 
    174         }, 
    175     ] 
     246    "message": "操作成功" 
    176247} 
    177248}}} 
     
    179250||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    180251||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    181 ||= score =||= 登录用户学分,未登录返回“” =||= tips =||=未登录状态下的提示信息,已登录返回“”=|| 
    182 ||= gameTips =||= 每日抽奖提示文案 =||= recordsTips =||=兑换记录提示文案=|| 
    183 ||= pageCount =||= 总页数 =||= pageNo =||=当前页码=|| 
    184 ||= pageSize =||= 每页条数 =||= resId =||=商品id=|| 
    185 ||= resImage =||= 商品缩略图 =||= resName =||=商品名=|| 
    186 ||= resStatusDesc =||= 兑换商品的状态描述 =||= resStatus =||=商品兑换状态:0需要XXX学分,1正在补货,2已兑换=|| 
    187  
    188 ---------- 
    189  
    190 === 1.3.1商品详情 === 
    191  
    192 >mrobot地址:  [[BR]] 
    193 学车后台开发环境: [[BR]] 
    194 学车后台线上环境: [[BR]] 
    195  
    196 **说明** 
    197  
    198 > 商品详情 
    199  
    200 **缓存时间** 
    201  
    202 >0 
    203  
    204 **提交方式** 
    205  
    206 > GET 
    207  
    208 **是否登录** 
    209  
    210 > 登录与未登录都可请求 
    211  
    212 **数据来源** 
    213  
    214 >学车后台 
    215  
    216 **参数** 
    217  
    218 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    219 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    220 ||= resId =||= 商品id =|| int ||=  =||= 是 =||=  =|| 
    221  
    222 **返回** 
    223  
    224 {{{#!java 
    225 { 
    226     "code": 0, 
    227     "message": "操作成功", 
    228     "resId": 440100, 
    229     "resName":"商品名称", 
    230     "resScore":500分, 
    231     "resCount":2, 
    232     "resStatus": 0, 
    233     "resDesc": "商品详细说明商品详细说明商品详细说明商品详细说明", 
    234     "imgData": [ 
    235             "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg", 
    236             "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg", 
    237             "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg" 
    238     ] 
    239 } 
    240 }}} 
    241 **返回参数说明** 
    242 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    243 ||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    244 ||= resId =||=商品id=||= resName =||=商品名=|| 
    245 ||= resScore =||= 兑换商品所需学分 =||= resCount =||= 剩余商品数 =|| 
    246 ||= resStatus =||= 商品兑换状态:0未兑换,1已兑换 =||= resDesc =||= 商品描述 =|| 
    247 ||= imgData =||= 商品图片,1≤商品图片张数≤5 =||=  =||==|| 
    248  
    249 ---------- 
    250  
    251 === 1.3.2兑换商品 === 
    252 ---------- 
    253  
    254 ==== 1.3.2.1兑换商品(获取商品信息) ==== 
    255  
    256 >mrobot地址:  [[BR]] 
    257 学车后台开发环境: [[BR]] 
    258 学车后台线上环境: [[BR]] 
    259  
    260 **说明** 
    261  
    262 > 商品详情 
    263  
    264 **缓存时间** 
    265  
    266 >0 
    267  
    268 **提交方式** 
    269  
    270 > GET 
    271  
    272 **是否登录** 
    273  
    274 > 否 
    275  
    276 **数据来源** 
    277  
    278 >学车后台 
    279  
    280 **参数** 
    281  
    282 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    283 ||= resId =||= 商品id =|| int ||=  =||= 是 =||=  =|| 
    284  
    285 **返回** 
    286  
    287 {{{#!java 
    288 { 
    289     "code": 0, 
    290     "message": "操作成功", 
    291     "resId": 440100, 
    292     "resName":"商品名称", 
    293     "resScore":500分, 
    294     "resCount":2, 
    295     "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg" 
    296 } 
    297 }}} 
    298 **返回参数说明** 
    299 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    300 ||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| 
    301 ||= resId =||=商品id=||= resName =||=商品名=|| 
    302 ||= resScore =||= 兑换商品所需学分 =||= resCount =||= 剩余商品数 =|| 
    303 ||= resImage =||= 商品缩略图 =||=  =||=  =|| 
    304  
    305 ---------- 
    306  
    307 ==== 1.3.2.2 兑换商品(提交资料) ==== 
    308  
    309 >mrobot地址:  [[BR]] 
    310 学车后台开发环境: [[BR]] 
    311 学车后台线上环境: [[BR]] 
    312  
    313 **说明** 
    314  
    315 > 提交资料,兑换商品 
    316  
    317 **缓存时间** 
    318  
    319 >0 
    320  
    321 **提交方式** 
    322  
    323 > post 
    324  
    325 **是否登录** 
    326  
    327 > 是 
    328  
    329 **数据来源** 
    330  
    331 >学车后台 
    332  
    333 **参数** 
    334  
    335 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    336 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    337 ||= resId =||= 商品id =|| int ||=  =||= 是 =||=  =|| 
    338 ||= resCount =||= 兑换商品数量 =|| int ||=  =||= 是 =||=  =|| 
    339 ||= resScore =||= 兑换商品消耗学分 =|| int ||=  =||= 是 =||=  =|| 
    340 ||= name =||= 用户名 =|| string ||=  =||= 是 =||=  =|| 
    341 ||= phoneNum =||= 手机号码 =|| string ||=  =||= 是 =||=  =|| 
    342 ||= address =||= 用户地址 =|| string ||=  =||= 是 =||=  =|| 
    343 ||= zipCode =||= 用户邮编 =|| string ||=  =||= 是 =||=  =|| 
    344  
    345  
    346 **返回** 
    347  
    348 {{{#!java 
    349 { 
    350     "code": 0, 
    351     "message": "兑换成功", 
    352 } 
    353 }}} 
    354 **返回参数说明** 
    355 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    356 ||= code =||= 接口返回状态码:0成功,非0返回对应错误说明 =||= message =||=接口返回描述信息:兑换成功,商品被抢光,库存不足等=|| 
    357  
    358 ---------- 
    359  
    360 === 1.3.3 兑换成功 === 
    361  
    362 >mrobot地址:  [[BR]] 
    363 学车后台开发环境: [[BR]] 
    364 学车后台线上环境: [[BR]] 
    365  
    366 **说明** 
    367  
    368 > 兑换成功返回信息 
    369  
    370 **缓存时间** 
    371  
    372 >0 
    373  
    374 **提交方式** 
    375  
    376 > get 
    377  
    378 **是否登录** 
    379  
    380 > 是 
    381  
    382 **数据来源** 
    383  
    384 >学车后台 
    385  
    386 **参数** 
    387  
    388 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    389 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    390 ||= resId =||= 商品id =|| int ||=  =||= 是 =||=  =|| 
    391  
    392  
    393 **返回** 
    394  
    395 {{{#!java 
    396 { 
    397     "code": 0, 
    398     "message": "兑换成功", 
    399     "resId": 440100, 
    400     "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg" 
    401     "description":"预计1-3个工作日内安排急送,请耐心等待!", 
    402     "name":"小明", 
    403     "phoneNum":"18815234562", 
    404     "address":"广东省广州市天河区高普路115号", 
    405     "zipCode":510000, 
    406      
    407 } 
    408 }}} 
    409 **返回参数说明** 
    410 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    411 ||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    412 ||= resId =||= 商品id =||= resImage =||= 兑换成功反馈图片 =|| 
    413 ||= description =||= 反馈文案 =||= name =||= 收货人姓名 =|| 
    414 ||= phoneNum =||= 收货人电话 =||= address =||= 收货地址 =|| 
    415 ||= zipCode =||= 邮编 =||=  =||=  =|| 
    416  
    417  
    418 ---------- 
    419  
    420 === 1.3.4兑换记录 === 
    421  
    422 ---------- 
    423  
    424 ==== 1.3.4.1兑换记录列表 ==== 
    425  
    426 >mrobot地址:  [[BR]] 
    427 学车后台开发环境: [[BR]] 
    428 学车后台线上环境: [[BR]] 
    429  
    430 **说明** 
    431  
    432 > 提交资料,兑换商品 
    433  
    434 **缓存时间** 
    435  
    436 >0 
    437  
    438 **提交方式** 
    439  
    440 > GET 
    441  
    442 **是否登录** 
    443  
    444 > 是 
    445  
    446 **数据来源** 
    447  
    448 >学车后台 
    449  
    450 **参数** 
    451  
    452 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    453 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    454  
    455  
    456 **返回** 
    457  
    458 {{{#!java 
    459 { 
    460     "code": 0, 
    461     "message": "操作成功", 
    462     "pageCount": 2, 
    463     "pageNo": 1,  
    464     "pageSize": 20, 
    465     "data": [ 
    466         { 
    467             "resId": 440100, 
    468             "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg", 
    469             "resName": "商品名称商品名称", 
    470             "resStatusDesc": "待发货", 
    471             "resTime": "20150830090000" 
    472         }, 
    473     ] 
    474 }}} 
    475 **返回参数说明** 
    476 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    477 ||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    478 ||= pageCount =||= 总页码 =||= pageNo =||= 当前页数 =|| 
    479 ||= pageSize =||= 每页条数 =||= resId =||= 商品id =|| 
    480 ||= resImage =||= 商品缩略图 =||= resStatusDesc =||= 发货状态 =|| 
    481 ||= resTime =||= 兑换时间 =||=  =||=  =|| 
    482  
    483 ---------- 
    484  
    485 ==== 1.3.4.2 兑换详情 ==== 
    486  
    487 >mrobot地址:  [[BR]] 
    488 学车后台开发环境: [[BR]] 
    489 学车后台线上环境: [[BR]] 
    490  
    491 **说明** 
    492  
    493 > 兑换成功返回信息 
    494  
    495 **缓存时间** 
    496  
    497 >0 
    498  
    499 **提交方式** 
    500  
    501 > GET 
    502  
    503 **是否登录** 
    504  
    505 > 是 
    506  
    507 **数据来源** 
    508  
    509 >学车后台 
    510  
    511 **参数** 
    512  
    513 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    514 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie,放在请求头中 =|| 
    515 ||= resId =||= 商品id =|| int ||=  =||= 是 =||=  =|| 
    516  
    517  
    518 **返回** 
    519  
    520 {{{#!java 
    521 { 
    522     "code": 0, 
    523     "message": "操作成功", 
    524     "resId": 440100, 
    525     "resImage": "http://img0.pcauto.com.cn/pcauto/1508/10/6866928_14_thumb.jpg" 
    526     "resName":"正品iPhone6 Plus", 
    527     "resScore":10000, 
    528     "resCount":1, 
    529     "resTime": "20150830090000", 
    530     "resStatusDesc": "已发货", 
    531     "description":"申通快递:12655458445", 
    532     "name":"小明", 
    533     "phoneNum":"18815234562", 
    534     "address":"广东省广州市天河区高普路115号", 
    535     "zipCode":510000, 
    536      
    537 } 
    538 }}} 
    539 **返回参数说明** 
    540 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    541 ||= code =||= 接口返回状态码:0成功,非0异常 =||= message =||= 接口返回描述信息 =|| 
    542 ||= resId =||= 商品id =||= resImage =||= 商品图片 =|| 
    543 ||= resName =||= 商品名 =||= resScore =||= 兑换商品所消耗学分 =|| 
    544 ||= resCount =||= 兑换商品数 =||= resTime =||= 兑换商品提交时间 =|| 
    545 ||= resStatusDesc =||= 发货状态 =||= description =||= 发货说明 =|| 
    546 ||= name =||= 收货人姓名 =||= phoneNum =||= 收货人电话 =|| 
    547 ||= address =||= 收货地址 =||= zipCode =||= 邮编 =|| 
     252 
     253----------