Changes between Initial Version and Version 1 of interface/pcauto_BuyAuto_1.4.0


Ignore:
Timestamp:
12/02/2015 09:17:42 AM (10 years ago)
Author:
xushengde
Comment:

报价1.4接口文档预览

Legend:

Unmodified
Added
Removed
Modified

  • interface/pcauto_BuyAuto_1.4.0

    v1 v1  
     1[[TOC]] 
     2 
     3= 学车2.3.0接口文档 (已完成接口开发机可测)= 
     4>mrobot代理环境说明：  
     5     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]]  
     6     192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]]  
     7     '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口，mrobot仅作代理，没有任何逻辑处理。''' [[BR]]  
     8     制作地址：[http://zzb.pcauto.com.cn/tools/gongdan/plan.php?id=122] [[BR]]  
     9     应用后端接口trac：[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.2] 
     10 
     11== 1.cms与论坛 == 
     12---------- 
     13 
     14=== 1.1科目一首页焦点图 === 
     15'''(开发已完成)'''[[BR]] 
     16>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topArticle.xsp  [[BR]] 
     17cms线上环境：http://www.pcauto.com.cn/client/xcbd/1509/intf7851.js [[BR]] 
     18             http://www.pcauto.com.cn/client/xcbd/1511/intf8071.js [[BR]] 
     19 
     20**说明** 
     21 
     22> 科目首页今日推荐接口 
     23 
     24**缓存时间** 
     25 
     26>0 
     27 
     28**提交方式** 
     29 
     30> GET 
     31 
     32**是否登录** 
     33 
     34> 否 
     35 
     36**数据来源** 
     37 
     38>CMS 
     39 
     40**参数** 
     41 
     42||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     43||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二：22505,科目三：22487,科目四：22515,拿本：22695) =|| 
     44 
     45**返回** 
     46 
     47{{{#!java 
     48{ 
     49    "status": 0, 
     50    "message": "操作成功", 
     51    "datas": [ 
     52        { 
     53            "title": "文章", 
     54            "id": "6790726", 
     55            "type": 1, 
     56            "img": "http://img0.pcauto.com.cn/pcauto/1507/14/g_6728785_1436863917510_240x160.jpg", 
     57            "url": "http://m.pcauto.com.cn/x/679/6790726.html" 
     58        }, 
     59    ], 
     60   bannerData: [ 
     61        { 
     62            "title": "教练在线问答回顾", 
     63            "url: "http://bbs.pcauto.com.cn/topic-8771174.html", 
     64            "imagePath": "http://img0.pcauto.com.cn/pcauto/client/xcbd/recommend/1511/00.jpg", 
     65            "type": "2", 
     66            "id": "8771174" 
     67         } 
     68    ] 
     69} 
     70}}} 
     71**返回参数说明** 
     72||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
     73||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=|| 
     74||= id =||= 文章id，帖子id =||= type =||= 跳转类型：1文章页，2话题详情页，3专题页面，4游戏页面，5每日抽奖,6专家在线 =|| 
     75||= tag =||= 只有第一位出,标签 =||= title =||= 标题 =|| 
     76 
     77---------- 
     78 
     79=== 1.2帖子报名功能 === 
     80'''(开发已完成)'''[[BR]] 
     81>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topicDetail.xsp [[BR]] 
     82应用后端url：http://bbs.pcauto.com.cn/xcappapi/1/topic/topicDetail.ajax?resp_enc=utf-8&tid=   (获取帖子详情)[[BR]] 
     83                http://xueche.pcauto.com.cn/appapi/1.0/topic/getPraiseCountByTopicId.do?topicId=    （获取帖子赞数）[[BR]] 
     84                http://bbs.pcauto.com.cn/xcappapi/1/topic/photos.do?ajax=true&tid=                （获取主贴图片列表）[[BR]] 
     85                http://xueche.pcauto.com.cn/appapi/1.0/topic/isPraiseByUserId.do?userId=&topicIds=  (是否已点赞) [[BR]] 
     86                http://passport3.pcauto.com.cn/passport3/client/api/recognize.jsp （获取用户登录状态） [[BR]] 
     87                http://bbs.pcauto.com.cn/activity/viewWap.ajax?tid=&type=all  （获取报名用户列表） [[BR]] 
     88 
     89**说明** 
     90 
     91>  
     92 
     93**缓存时间** 
     94 
     95>0 
     96 
     97**提交方式** 
     98 
     99> GET 
     100 
     101**是否登录** 
     102 
     103> 登录与未登录都可请求 
     104 
     105**数据来源** 
     106 
     107>论坛&学车后台 
     108 
     109**参数** 
     110 
     111||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     112||= topicId =||= 帖子id =|| string ||=  =||= 是 =||=  =|| 
     113||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =|| 
     114 
     115**返回** 
     116HTML [BR] 
     117 
     118 
     119{{{ 
     120页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 数据内容为  
     121  { 
     122    "title": "学车发帖测试V2",(标题) 
     123    "url": "http://dev11.pcauto.com.cn/bbs7/topic-7809286.html",(分享URL) 
     124    "firstPic": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg"(第一张图) 
     125  } 
     126 
     127页面协议 
     128    pcdrive://reply/floorId  (floorId)楼层id   回复楼层协议 
     129    pcdrive://praise/tid   (tid) 帖子id  点赞协议 
     130    pcdrive://big-photo?data={\"total\":" + total + ",\"currentIndex\":" + currentIndex + ",\"photos\":[" +photos+ "]}  (total)图片总数  (currentIndex)当前图片位置 (photos) 所有图片URL   点击图片协议 
     131    pcdrive://enroll  我要报名协议 
     132    pcdrive://submitEnroll  提交报名协议 
     133}}} 
     134 
     135 
     136---------- 
     137 
     138=== 1.3 启动图接口 === 
     139'''（开发已完成）'''[[BR]] 
     140'''安卓版如下'''[[BR]] 
     141>mrobot地址：mrobot.pcauto.com.cn/configs/xueche_android_qdtdh [[BR]] 
     142'''ios版如下'''[[BR]] 
     143>mrobot地址：mrobot.pcauto.com.cn/configs/xueche_ios_qdtdh [[BR]] 
     144后端Url：无 [[BR]] 
     145 
     146**说明** 
     147 
     148> 启动图动画配置 
     149 
     150**缓存时间** 
     151 
     152>0 
     153 
     154**提交方式** 
     155 
     156> GET 
     157 
     158**是否登录** 
     159 
     160> 否 
     161 
     162**数据来源** 
     163 
     164>mrobot后台 
     165 
     166**参数** 
     167无 
     168 
     169**返回** 
     170 
     171{{{#!java 
     172{ 
     173    "rule": { 
     174        "delay": 1, 
     175        "interval": 15, 
     176        "age": 3 
     177    }, 
     178    "ad": { 
     179        "img": "http://img0.pcauto.com.cn/pcauto/1508/07/6242801_new.jpg", 
     180        "to-uri": "pcdrive://bbs-topics/8650721", 
     181        "vc-uri": "http://192.168.20.6?a=3d", 
     182        "cc-uri": "http://192.168.20.6?a=4d", 
     183        "type":"2", 
     184        "id":"8650721", 
     185        "title":"这是一只标题", 
     186        "comment":"type取值---->1：文章页；2：话题详情页；3：专题页面；4：游戏页面；5：每日抽奖；6：专家在线。to-uri---->论坛：pcdrive://bbs-topics/8650721；文章：pcdrive://info-articles/8650721；其他：直接填URL" 
     187    } 
     188} 
     189}}} 
     190**返回参数说明** 
     191||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     192||= delay =||= 延迟显示 =||= interval =||= 间隔显示 =|| 
     193||= age =||= 显示时间 =||= img =||= 图片链接 =|| 
     194||= to-uri =||= 到达页，论坛：pcdrive://bbs-topics/8650721；文章：pcdrive://info-articles/8650721；其他：直接填URL =||= vc-uri =||= 曝光计数 =|| 
     195||= cc-uri =||= 点击计数 =||= type =||= 类型，1：文章页；2：话题详情页；3：专题页面；4：游戏页面；5：每日抽奖；6：专家在线。 =|| 
     196||= id =||= 帖子或文章id（其它类型没有） =||= title =||= 标题 =|| 
     197 
     198---------- 
     199 
     200=== 1.4 新增跳转类型 === 
     201'''(只需要编辑录入新增类型，接口无改动）'''[[BR]] 
     202>mrobot地址：[[BR]] 
     203活动列表：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.0.0/interface#a2.1.6获取活动列表 [[BR]] 
     204urlType添加专家在线页标记 [[BR]] 
     205今日推荐：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.2.0/interface#a2.2科目首页今日推荐接口 [[BR]] 
     206type添加专家在线页标记 [[BR]] 
     207圈子首页：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_1.2.0/interface#a2.1.3精彩推荐帖子列表 [[BR]] 
     208type添加专家在线页标记 [[BR]] 
     209消息列表:http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.3.0/interface#a2.10消息列表 [[BR]] 
     210type添加专家在线页标记 [[BR]] 
     211 
     212---------- 
     213 
     214=== 1.5 科目首页专家在线接口 === 
     215'''（开发已完成）'''[[BR]] 
     216>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/randomQuestion.xsp  [[BR]] 
     217cms线上环境：http://www.pcauto.com.cn/client/xcbd/1511/intf8091.js [[BR]] 
     218学车线上环境：http://xueche.pcauto.com.cn/appapi/1.0/active/lastActive.do  [[BR]] 
     219  
     220**说明** 
     221 
     222> 科目首页专家在线接口 
     223 
     224**缓存时间** 
     225 
     226>0 
     227 
     228**提交方式** 
     229 
     230> GET 
     231 
     232**是否登录** 
     233 
     234> 否 
     235 
     236**数据来源** 
     237 
     238>CMS 
     239 
     240**参数** 
     241 
     242||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     243||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二：22505,科目三：22487,科目四：22515) =|| 
     244 
     245**返回** 
     246 
     247{{{#!java 
     248{ 
     249    "status": 0, 
     250    "message": "操作成功", 
     251    "questionList": [ 
     252        { 
     253            "id": 440100, 
     254            "title": "离合器半联动怎么找？" 
     255        }, 
     256        { 
     257            "id": 434500, 
     258            "title": "科目三怎么踩离合才是正确的？" 
     259        } 
     260    ], 
     261    "questionSpecial": [ 
     262        { 
     263             "id": 31, 
     264             "title": "教练在线解答", 
     265             "activeImg": "http://dev2.pconline.com.cn:9191/upcfiles/driver/1511/03/c0/31433_1446519084528.jpg" 
     266         } 
     267    ] 
     268} 
     269}}} 
     270**返回参数说明** 
     271||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
     272||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=|| 
     273||= id =||= 帖子id =||= title =||= 问答标题 =|| 
     274||= title =||= 专家在线标题 =||= activeImg =||= 专家在线图片 =|| 
     275 
     276 
     277---------- 
     278 
     279== 2.学车后台 == 
     280---------- 
     281 
     282=== 2.1 大小压缩中的交通标志列表页 === 
     283'''(开发已完成）'''[[BR]] 
     284>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listTrafficSign.xsp [[BR]] 
     285学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/traffic/listTrafficSign.do  [[BR]] 
     286学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listTrafficSign.do [[BR]] 
     287 
     288**说明** 
     289 
     290> 获取交通标志 
     291 
     292**缓存时间** 
     293 
     294>0 
     295 
     296**提交方式** 
     297 
     298> GET 
     299 
     300**是否登录** 
     301 
     302> 否 
     303 
     304**数据来源** 
     305 
     306>学车后台 
     307 
     308**参数** 
     309 
     310||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     311||= typeId =||= 类型 =|| int ||=  =||= 是 =||=  =|| 
     312||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
     313||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
     314 
     315**返回** 
     316 
     317{{{#!java 
     318{ 
     319        code:0成功，-1失败 
     320        message:失败原因 
     321        signCount:总个数 
     322        pageNo:页码 
     323        pageSize:一页个数 
     324        pageCount:总页数 
     325        tracficList:[{ 
     326            img:原图URL 
     327            signName:标志名字 
     328            signDesc:标志描述 
     329        }] 
     330} 
     331}}} 
     332**返回参数说明** 
     333||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     334||= img =||= 原图URL =||= signName =||= 标志名字 =|| 
     335||= signDesc =||= 标志描述 =||=  =||=  =|| 
     336 
     337---------- 
     338 
     339=== 2.2 商品详情 === 
     340'''(开发已完成）'''[[BR]] 
     341>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getGiftDetailById.xsp [[BR]] 
     342学车后台开发环境：http://dev38.pcauto.com.cn:8003//appapi/1.0/gift/getGiftDetailById.do  [[BR]] 
     343学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/getGiftDetailById.do [[BR]] 
     344 
     345**说明** 
     346 
     347> 获取商品详情 
     348 
     349**缓存时间** 
     350 
     351>0 
     352 
     353**提交方式** 
     354 
     355> GET 
     356 
     357**是否登录** 
     358 
     359> 否 
     360 
     361**数据来源** 
     362 
     363>学车后台 
     364 
     365**参数** 
     366 
     367||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     368||= giftId =||= 礼品ID =||= long =||=  =||= 是 =||=  =|| 
     369||= accountId =||= 用户ID =||= long =||=  =||= 登陆后必须 =||=  =|| 
     370 
     371**返回** 
     372 
     373{{{#!java 
     374{ 
     375        code:0成功，-1失败 
     376        message:失败原因 
     377        date:{ 
     378            name:商口名字 
     379            gold:兑换所需学分 
     380            curNum:剩余库存 
     381            limitNum:兑换上限 
     382            imagePath：礼品详情图片链接 
     383            smallCoverImg:160X120的封面图 
     384            description:商品详细说明 
     385            exchangeStatus:后台判断，0：马上兑换，-5：库存不足，-6：已达兑换上限，-2：分数不足 
     386        } 
     387} 
     388}}} 
     389**返回参数说明** 
     390||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     391||= name =||= 商口名字 =||= gold =||= 兑换所需学分 =|| 
     392||= curNum =||= 剩余库存 =||= limitNum =||= 兑换上限 =|| 
     393||= imagePath =||= 礼品详情图片链接 =||= smallCoverImg =||= 160X120的封面图 =|| 
     394||= description =||= 商品详细说明 =||= exchangeStatus =||= 后台判断 =|| 
     395 
     396---------- 
     397 
     398=== 2.3 兑换记录列表 === 
     399'''(开发已完成）'''[[BR]] 
     400>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listRecord.xsp [[BR]] 
     401学车后台开发环境：http://dev38.pcauto.com.cn:8003//appapi/1.0/gift/listRecord.do  [[BR]] 
     402学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listRecord.do [[BR]] 
     403 
     404**说明** 
     405 
     406> 兑换记录列表 
     407 
     408**缓存时间** 
     409 
     410>0 
     411 
     412**提交方式** 
     413 
     414> GET 
     415 
     416**是否登录** 
     417 
     418> 是 
     419 
     420**数据来源** 
     421 
     422>学车后台 
     423 
     424**参数** 
     425 
     426||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     427||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
     428||= pageNo =||= 页码 =||= int =||=  =||= 否 =||=  =|| 
     429||= pageSize =||= 页数 =||= int =||=  =||= 否 =||=  =|| 
     430 
     431**返回** 
     432 
     433{{{#!java 
     434{ 
     435        code:0成功，-1失败 
     436        message:失败原因 
     437        pageNo:页码 
     438        pageSize:一页个数 
     439        pageCount:总页数 
     440        recordList:[{ 
     441            giftId:商品ID 
     442            conversionId:兑换的ID 
     443            giftImg:商品160X120地址 
     444            name:商品名字 
     445            status:0未发货，1已发货，2待付款，-1驳回(失败) 
     446            createAt:创建时间 
     447        }] 
     448} 
     449}}} 
     450**返回参数说明** 
     451||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     452||= giftId =||= 商品ID =||= conversionId =||= 兑换的ID =|| 
     453||= giftImg =||= 商品160X120地址 =||= name =||= 商品名字 =|| 
     454||= status =||= 0未发货，1已发货，2待付款，-1驳回(失败) =||= createAt =||= 创建时间 =|| 
     455 
     456=== 2.4 兑换商品 === 
     4571.通过[http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.3.0/interface#a2.2商品详情]拿到数据显示； [[BR]] 
     4582.通过[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.3.礼品兑换接口2.3]提交数据 [[BR]] 
     459----------- 
     460 
     461=== 2.5 兑换成功 === 
     4621.通过[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.3.礼品兑换接口2.3]返回的id拼接跳转链接 [[BR]] 
     463----------- 
     464 
     465=== 2.6 兑换详情 === 
     4661.学车后台提供前缀，app用id拼接详情页链接 [[BR]] 
     467----------- 
     468 
     469=== 2.7 用户摇一摇今日剩余次数 === 
     470'''(开发已完成）'''[[BR]] 
     471>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getLeftShakeCount.xsp [[BR]] 
     472学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/shake/getLeftShakeCount.do  [[BR]] 
     473学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/shake/getLeftShakeCount.do [[BR]] 
     474 
     475**说明** 
     476 
     477> 获取用户摇一摇今天的剩余次数 
     478 
     479**缓存时间** 
     480 
     481> 
     482 
     483**提交方式** 
     484 
     485> GET 
     486 
     487**是否登录** 
     488 
     489> 是 
     490 
     491**数据来源** 
     492 
     493>学车后台 
     494 
     495**参数** 
     496 
     497||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     498||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
     499 
     500**返回** 
     501 
     502{{{#!java 
     503{ 
     504        code:0成功，-1失败，-2未登录 
     505        message:失败原因 
     506        shakeCount:今天还剩的摇一摇次数 
     507} 
     508}}} 
     509**返回参数说明** 
     510||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     511||= code =||= 状态码 =||= message =||= 描述 =|| 
     512||= shakeCount =||= 今天还剩的摇一摇次数 =||=  =||=  =|| 
     513 
     514----------- 
     515 
     516=== 2.8 摇一摇出题 === 
     517'''(开发已完成）'''[[BR]] 
     518>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/shakeAShake.xsp [[BR]] 
     519学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/shake/shakeAShake.do  [[BR]] 
     520学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/shake/shakeAShake.do [[BR]] 
     521 
     522**说明** 
     523 
     524> 摇一摇出题目，注意：总次数是2次，但根据不同的subjcetID出题 
     525 
     526**缓存时间** 
     527 
     528> 
     529 
     530**提交方式** 
     531 
     532> GET 
     533 
     534**是否登录** 
     535 
     536> 是 
     537 
     538**数据来源** 
     539 
     540>学车后台 
     541 
     542**参数** 
     543 
     544||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     545||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
     546||= subjectId =||= 科目ID =||= long =||=  =||= 是 =||=  =|| 
     547**返回** 
     548 
     549{{{#!java 
     550{ 
     551        code:0成功，-1失败，-2未登录 
     552        message:失败原因 
     553        shakeCount:今天还剩的摇一摇次数 
     554        questionId: 
     555} 
     556}}} 
     557**返回参数说明** 
     558||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     559||= code =||= 状态码 =||= message =||= 描述 =|| 
     560||= shakeCount =||= 今天还剩的摇一摇次数 =||= questionId =||= 题目id =|| 
     561----------- 
     562 
     563=== 2.9 摇一摇加分接口 === 
     5641.后端接口猛戳[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.7.摇一摇加分接口2.3] [[BR]] 
     565----------- 
     566 
     567=== 2.10 消息列表 === 
     568'''(开发已完成）'''[[BR]] 
     569>mrobot地址：http://dev40.pcauto.com.cn/xsp/s/auto/info/xueChe/expertMessage.xsp [[BR]] 
     570bip开发环境： [[BR]] 
     571bip线上环境：http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&typeIds=2071 [[BR]] 
     572 
     573**说明** 
     574 
     575> 获取消息列表 
     576 
     577**缓存时间** 
     578 
     579> 
     580 
     581**提交方式** 
     582 
     583> GET 
     584 
     585**是否登录** 
     586 
     587> 是 
     588 
     589**数据来源** 
     590 
     591>BIP 
     592 
     593**参数** 
     594 
     595||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     596||= pageNo =||= 页码 =||= int =||= 1 =||= 否 =||=  =|| 
     597||= pageSize =||= 分页大小 =||= int =||= 20 =||= 否 =||=  =|| 
     598**返回** 
     599{{{#!java 
     600{ 
     601        "total":55,  总记录数 
     602        "pageNo":1,  当前第几页 
     603        "pageCount":3,  一共有多少页 
     604        "pageSize":20,  每页多少条记录 
     605        "resultList":  消息列表 
     606        [ 
     607           { 
     608             "id":249723334,  消息ID 
     609             "type":{"name":"官方活动","id":0,"templateId":0,"siteId":0,"groupType":1},  消息类型信息 
     610             "content":{"content":"活动内容","activeId":12},  消息内容 
     611             "createTime":1434540046000,  消息创建时间 
     612             "status":1,  消息状态 0未读  1已读 
     613             "accountId":7072562,  接收者ID 
     614             "typeId":69,  消息类型Id 
     615             "siteId":2,  消息属于那个网站 
     616             "groupSend":1,  是否群发消息 
     617             "groupType":0,  消息分组ID 
     618             "senderId":0  发送者ID 
     619            } 
     620         ] 
     621    }   
     622}}} 
     623**返回参数说明** 
     624||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     625||= id =||= 消息ID =||= type =||= 消息类型信息 =|| 
     626||= content =||= 消息内容 =||= createTime =||= 消息创建时间 =|| 
     627||= status =||= 消息状态 =||= accountId =||= 接收者ID =|| 
     628||= typeId =||= 消息类型Id =||= siteId =||= 消息属于那个网站 =|| 
     629||= groupSend =||= 是否群发消息 =||= groupType =||= 消息分组ID =|| 
     630||= senderId =||= 发送者ID =||= activeId =||= 专家问答id =|| 
     631 
     632----------- 
     633 
     634=== 2.11 专题列表 === 
     635'''(开发已完成）'''[[BR]] 
     636>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listActive.xsp [[BR]] 
     637学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/active/listActive.do  [[BR]] 
     638学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/active/listActive.do [[BR]] 
     639 
     640**说明** 
     641 
     642> 获取专题列表 
     643 
     644**缓存时间** 
     645 
     646> 
     647 
     648**提交方式** 
     649 
     650> GET 
     651 
     652**是否登录** 
     653 
     654> 否 
     655 
     656**数据来源** 
     657 
     658>学车后台 
     659 
     660**参数** 
     661 
     662||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     663||= pageNo =||= 页码 =||= int =||=  =||= 否 =||=  =|| 
     664||= pageSize =||= 每页条数 =||= int =||=  =||= 否 =||=  =|| 
     665**返回** 
     666 
     667{{{#!java 
     668{ 
     669        code:0成功，-1失败 
     670        message:失败原因 
     671        pageNo:页码 
     672        pageSize:一页个数 
     673        pageCount:总页数 
     674        activeList:[{ 
     675            id:专题ID 
     676            periods:期数 
     677            title:标题 
     678            coach:教练 
     679            schoolName:驾校名 
     680            timestart:开始时间 
     681            timeEnd:活动结束时间 
     682            status:0:进行中 ，1：未开始  ，-1：已结束 
     683        }] 
     684} 
     685}}} 
     686**返回参数说明** 
     687||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     688||= id =||= 专题ID =||= periods =||= 期数 =|| 
     689||= title =||= 标题 =||= coach =||= 教练 =|| 
     690||= schoolName =||= 驾校名 =||= timestart =||= 开始时间 =|| 
     691||= timeEnd =||= 活动结束时间 =||= status =||= 0:进行中 ，1：未开始  ，-1：已结束 =|| 
     692 
     693----------- 
     694=== 2.12 单个专题页 & 教练主页  HTML === 
     6951.根据原型，该部分使用wap版。 [[BR]] 
     696----------- 
     697 
     698=== 2.13 获取省市 === 
     699'''(开发已完成）'''[[BR]] 
     700>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/jsonProvinceAndCity.xsp [[BR]] 
     701学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/area/jsonProvinceAndCity.do  [[BR]] 
     702学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/area/jsonProvinceAndCity.do [[BR]] 
     703 
     704**说明** 
     705 
     706> 获取最新专题 
     707 
     708**缓存时间** 
     709 
     710> 
     711 
     712**提交方式** 
     713 
     714> GET 
     715 
     716**是否登录** 
     717 
     718> 否 
     719 
     720**数据来源** 
     721 
     722>学车后台 
     723 
     724**参数** 
     725 
     726||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     727 
     728**返回** 
     729 
     730{{{#!java 
     731{ 
     732        code:0成功，-1失败 
     733        message:失败原因 
     734        addressList:[{ 
     735            provincepy:省的首字母拼音 
     736            provinceId:省ID 
     737            province:省名 
     738            cityId:城市ID 
     739            city：城市名 
     740        }] 
     741} 
     742}}} 
     743**返回参数说明** 
     744||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     745||= provincepy =||= 省的首字母拼音 =||= provinceId =||= 省ID =|| 
     746||= province =||= 省名 =||= cityId =||= 城市ID =|| 
     747||= city =||= 城市名 =||= =||= =|| 
     748 
     749----------- 
     750 
     751=== 2.14 交通标志类型列表页接口 === 
     752'''(开发已完成）'''[[BR]] 
     753>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listTrafficType.xsp [[BR]] 
     754学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/traffic/listTrafficType.do  [[BR]] 
     755学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listTrafficType.do [[BR]] 
     756 
     757**说明** 
     758 
     759> 交通标志类型列表页 
     760 
     761**缓存时间** 
     762 
     763>0 
     764 
     765**提交方式** 
     766 
     767> GET 
     768 
     769**是否登录** 
     770 
     771> 否 
     772 
     773**数据来源** 
     774 
     775>学车后台 
     776 
     777**参数** 
     778 
     779||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     780||= typeId =||= 类型 =|| int ||=  =||= 是 =||= 父类(type=0时，查询一级分类,type>0时，是查询该类型的下一级分类) =|| 
     781||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
     782||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
     783 
     784**返回** 
     785 
     786{{{#!java 
     787{ 
     788        code:0成功，-1失败 
     789        message:失败原因 
     790        pageNo:页码 
     791        pageSize:一页个数 
     792        pageCount:总页数 
     793        tracficTypeList:[{ 
     794            id:类型的ID 
     795            name:标志名字 
     796            description:标志描述 
     797            hasChild:是否含有子结点 
     798            totalImg:总图片数 
     799        }] 
     800} 
     801}}} 
     802**返回参数说明** 
     803||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     804||= id =||= 类型的ID =||= name =||= 标志名字 =|| 
     805||= description =||= 标志描述 =||= hasChild =||= 是否含有子结点 =|| 
     806||= totalImg =||= 总图片数 =||=  =||=  =|| 
     807 
     808---------- 
     809 
     810== 3.活动 == 
     811=== 3.1 获取实物奖品记录 === 
     812'''(开发已完成）'''[[BR]] 
     813>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/activityPrizeList.xsp [[BR]] 
     814活动后台开发环境：http://v39.pcauto.com.cn:8003/action/getRecord.jsp  [[BR]] 
     815活动后台线上环境：http://activity.pcauto.com.cn/auto151019/action/getRecord.jsp [[BR]] 
     816 
     817**说明** 
     818 
     819> 获取实物奖品记录 
     820 
     821**缓存时间** 
     822 
     823> 
     824 
     825**提交方式** 
     826 
     827> GET 
     828 
     829**是否登录** 
     830 
     831> 是 
     832 
     833**数据来源** 
     834 
     835>活动后台 
     836 
     837**参数** 
     838 
     839||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     840||= pageSize =||= 每页显示数 =||= int =||= 5 =||= 否 =||=  =|| 
     841||= pageNo =||= 页码 =||= int =||= 1 =||= 否 =||=  =|| 
     842**返回** 
     843 
     844{{{#!java 
     845{"code":-1,"msg":"活动已结束,感谢您的参与"} 
     846{"code":-2,"msg":"请登陆后查看中奖记录"} 
     847{"code":-3,"msg":"获取中奖记录失败"} 
     848{"code":1,"msg":"获取中奖记录成功","count":"用户中奖次数","list":[{"awardLogId":中奖记录id,"userId":用户id,"accountName":用户名,"realName":真实姓名,"phone":手机号,"address":地址,"zipCode":邮编,"useCredit":抽奖消耗的学分,"awardId":奖品id,"awardName":奖品名,"prizeStatus":领奖状态(0:未领奖,1:已领奖),"awardType":奖品类型,"awardStatus":发奖信息,"createAt":中奖时间,"updateAt":更新时间}]}                 
     849}}} 
     850**返回参数说明** 
     851||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     852||= awardLogId =||= 中奖记录id =||= userId =||= 用户id =|| 
     853||= accountName =||= 用户名 =||= realName =||= 真实姓名 =|| 
     854||= phone =||= 手机号 =||= address =||= 地址 =|| 
     855||= zipCode =||= 邮编 =||= useCredit =||= 抽奖消耗的学分 =|| 
     856||= awardId =||= 奖品id =||= awardName =||= 奖品名 =|| 
     857||= awardType =||= 奖品类型 =||= awardStatus =||= 发奖信息 =|| 
     858||= createAt =||= 中奖时间 =||= updateAt =||= 更新时间 =|| 
     859||= count =||= 用户中奖次数 =||= prizeStatus =||= 领奖状态(0:未领奖,1:已领奖) =|| 
     860 
     861----------- 
     862 
     863=== 3.2 奖品详情页 === 
     864'''(开发已完成）'''[[BR]] 
     865>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/activityPrizeDetail.xsp [[BR]] 
     866活动后台开发环境：http://v39.pcauto.com.cn:8003/detail.jsp  [[BR]] 
     867活动后台线上环境：http://activity.pcauto.com.cn/auto151019/detail.jsp [[BR]] 
     868 
     869**说明** 
     870 
     871> 获取实物奖品记录 
     872 
     873**缓存时间** 
     874 
     875> 
     876 
     877**提交方式** 
     878 
     879> GET 
     880 
     881**是否登录** 
     882 
     883> 是 
     884 
     885**数据来源** 
     886 
     887> 活动后台 
     888 
     889**参数** 
     890 
     891||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     892||= awardLogId =||= 抽奖记录的id =||= long =||=  =||= 是 =||=  =|| 
     893 
     894**返回** 
     895> HTML 
     896 
     897**返回参数说明** 
     898 
     899 
     900----------- 
     901 
     902 
     903=== 3.3 每日抽奖页 === 
     904'''(开发已完成）'''[[BR]] 
     905>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/dailyActivity.xsp [[BR]] 
     906活动后台开发环境：http://v39.pcauto.com.cn:8003/index.jsp  [[BR]] 
     907活动后台线上环境：http://activity.pcauto.com.cn/auto151019/index.jsp [[BR]] 
     908 
     909**说明** 
     910 
     911> 每日抽奖 
     912 
     913**缓存时间** 
     914 
     915> 
     916 
     917**提交方式** 
     918 
     919> GET 
     920 
     921**是否登录** 
     922 
     923> 是 
     924 
     925**数据来源** 
     926 
     927> 活动后台 
     928 
     929**参数** 
     930 
     931||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
     932 
     933**返回** 
     934> HTML 
     935 
     936**返回参数说明**