Changes between Version 2 and Version 3 of pcauto_magazine_interface_3.1.0


Ignore:
Timestamp:
11/20/2015 10:35:39 AM (10 years ago)
Author:
dengyurong
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • pcauto_magazine_interface_3.1.0

    v2 v3  
    11[[TOC]] 
    22 
    3 = 家居杂志iPhone3.1.0 & iPad5.1.0 = 
     3= 汽车杂志iPhone3.1.0 & iPad5.1.0 = 
    44>mrobot代理环境说明：  
    55     192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]]  
    … …  
    99 
    1010      
    11 == 1.cms与论坛 == 
     11== 1.消息中 == 
    1212---------- 
    1313 
    14 === 1.1科目一首页焦点图 === 
    15 '''(开发已完成)'''[[BR]] 
    16 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/topArticle.xsp  [[BR]] 
    17 cms线上环境：http://www.pcauto.com.cn/client/xcbd/1509/intf7851.js [[BR]] 
    18              http://www.pcauto.com.cn/client/xcbd/1511/intf8071.js [[BR]] 
     14=== 1.1系统消息&赞与回复消息 === 
     15'''(开发进行中)'''[[BR]] 
     16 
     17---------- 
     18 
     19== 2.联系杂志君 == 
     20---------- 
     21 
     22=== 2.1 联系杂志君对话内容 === 
     23'''(开发已完成）'''[[BR]] 
     24>mrobot地址：http://dev40.pcauto.com.cn/xsp/s/auto/info/cms/getMessageList.xsp?accountId=863178&pageNo=1&pageSize=10 [[BR]] 
     25联系杂志君后台开发环境：http://dev19.pchouse.com.cn:9090/message/getMessageList.do?accountId=863178&pageNo=1&pageSize=10  [[BR]] 
     26联系杂志君后台线上环境：[[BR]] 
    1927 
    2028**说明** 
    2129 
    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": 440100, 
    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每日抽奖 =|| 
    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  
    86 **说明** 
    87  
    88 >  
    89  
    90 **缓存时间** 
    91  
    92 >0 
    93  
    94 **提交方式** 
    95  
    96 > GET 
    97  
    98 **是否登录** 
    99  
    100 > 登录与未登录都可请求 
    101  
    102 **数据来源** 
    103  
    104 >论坛&学车后台 
    105  
    106 **参数** 
    107  
    108 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    109 ||= topicId =||= 帖子id =|| string ||=  =||= 是 =||=  =|| 
    110 ||= Cookie =||= 用户登录cookie =|| string ||=  =||= 是 =||= 登录用户cookie，放在请求头中 =|| 
    111  
    112 **返回** 
    113 HTML [BR] 
    114  
    115  
    116 {{{ 
    117 页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 数据内容为  
    118   { 
    119     "title": "学车发帖测试V2",(标题) 
    120     "url": "http://dev11.pcauto.com.cn/bbs7/topic-7809286.html",(分享URL) 
    121     "firstPic": "http://dev2.pconline.com.cn:9191/upcfiles/bbs6/1506/24/c0/19020_1435117706182_1024x1024.jpg"(第一张图) 
    122   } 
    123  
    124 页面协议 
    125     pcdrive://reply/floorId  (floorId)楼层id   回复楼层协议 
    126     pcdrive://praise/tid   (tid) 帖子id  点赞协议 
    127     pcdrive://big-photo?data={\"total\":" + total + ",\"currentIndex\":" + currentIndex + ",\"photos\":[" +photos+ "]}  (total)图片总数  (currentIndex)当前图片位置 (photos) 所有图片URL   点击图片协议 
    128 }}} 
    129  
    130  
    131 ---------- 
    132  
    133 === 1.3 启动图接口 === 
    134 '''（开发已完成）'''[[BR]] 
    135 '''安卓版如下'''[[BR]] 
    136 >mrobot地址：mrobot.pcauto.com.cn/configs/xueche_android_qdtdh [[BR]] 
    137 '''ios版如下'''[[BR]] 
    138 >mrobot地址：mrobot.pcauto.com.cn/configs/xueche_ios_qdtdh [[BR]] 
    139 后端Url：无 [[BR]] 
    140  
    141 **说明** 
    142  
    143 > 启动图动画配置 
    144  
    145 **缓存时间** 
    146  
    147 >0 
    148  
    149 **提交方式** 
    150  
    151 > GET 
    152  
    153 **是否登录** 
    154  
    155 > 否 
    156  
    157 **数据来源** 
    158  
    159 >mrobot后台 
    160  
    161 **参数** 
    162 无 
    163  
    164 **返回** 
    165  
    166 {{{#!java 
    167 { 
    168     "rule": { 
    169         "delay": 1, 
    170         "interval": 15, 
    171         "age": 3 
    172     }, 
    173     "ad": { 
    174         "img": "http://img0.pcauto.com.cn/pcauto/1508/07/6242801_new.jpg", 
    175         "to-uri": "pcdrive://bbs-topics/8650721", 
    176         "vc-uri": "http://192.168.20.6?a=3d", 
    177         "cc-uri": "http://192.168.20.6?a=4d", 
    178         "type":"2", 
    179         "id":"8650721", 
    180         "title":"这是一只标题", 
    181         "comment":"type取值---->1：文章页；2：话题详情页；3：专题页面；4：游戏页面；5：每日抽奖；6：专家在线。to-uri---->论坛：pcdrive://bbs-topics/8650721；文章：pcdrive://info-articles/8650721；其他：直接填URL" 
    182     } 
    183 } 
    184 }}} 
    185 **返回参数说明** 
    186 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    187 ||= delay =||= 延迟显示 =||= interval =||= 间隔显示 =|| 
    188 ||= age =||= 显示时间 =||= img =||= 图片链接 =|| 
    189 ||= to-uri =||= 到达页，论坛：pcdrive://bbs-topics/8650721；文章：pcdrive://info-articles/8650721；其他：直接填URL =||= vc-uri =||= 曝光计数 =|| 
    190 ||= cc-uri =||= 点击计数 =||= type =||= 类型，1：文章页；2：话题详情页；3：专题页面；4：游戏页面；5：每日抽奖；6：专家在线。 =|| 
    191 ||= id =||= 帖子或文章id（其它类型没有） =||= title =||= 标题 =|| 
    192  
    193 ---------- 
    194  
    195 === 1.4 新增跳转类型 === 
    196 '''(只需要编辑录入新增类型，接口无改动）'''[[BR]] 
    197 >mrobot地址：[[BR]] 
    198 活动列表：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.0.0/interface#a2.1.6获取活动列表 [[BR]] 
    199 urlType添加专家在线页标记 [[BR]] 
    200 今日推荐：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.2.0/interface#a2.2科目首页今日推荐接口 [[BR]] 
    201 type添加专家在线页标记 [[BR]] 
    202 圈子首页：http://trac.pc.com.cn/iphone/wiki/pcauto_drive_1.2.0/interface#a2.1.3精彩推荐帖子列表 [[BR]] 
    203 type添加专家在线页标记 [[BR]] 
    204  
    205 ---------- 
    206  
    207 === 1.5 科目首页专家在线接口 === 
    208 '''（开发已完成）'''[[BR]] 
    209 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/randomQuestion.xsp  [[BR]] 
    210 cms线上环境：http://www.pcauto.com.cn/client/xcbd/1511/intf8091.js [[BR]] 
    211  
    212 **说明** 
    213  
    214 > 科目首页专家在线接口 
    215  
    216 **缓存时间** 
    217  
    218 >0 
    219  
    220 **提交方式** 
    221  
    222 > GET 
    223  
    224 **是否登录** 
    225  
    226 > 否 
    227  
    228 **数据来源** 
    229  
    230 >CMS 
    231  
    232 **参数** 
    233  
    234 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    235 ||= subjectId =||= 科目id =|| int ||=  =||= 是 =||= 科目id(科目一:22486,科目二：22505,科目三：22487,科目四：22515) =|| 
    236  
    237 **返回** 
    238  
    239 {{{#!java 
    240 { 
    241     "status": 0, 
    242     "message": "操作成功", 
    243     "questionList": [ 
    244         { 
    245             "id": 440100, 
    246             "title": "离合器半联动怎么找？" 
    247         }, 
    248         { 
    249             "id": 434500, 
    250             "title": "科目三怎么踩离合才是正确的？" 
    251         } 
    252     ], 
    253     "questionSpecial": [ 
    254         { 
    255              "id": 31, 
    256              "title": "教练在线解答", 
    257              "activeImg": "http://dev2.pconline.com.cn:9191/upcfiles/driver/1511/03/c0/31433_1446519084528.jpg" 
    258          } 
    259     ] 
    260 } 
    261 }}} 
    262 **返回参数说明** 
    263 ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| 
    264 ||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=|| 
    265 ||= id =||= 帖子id =||= title =||= 问答标题 =|| 
    266 ||= title =||= 专家在线标题 =||= activeImg =||= 专家在线图片 =|| 
    267  
    268  
    269 ---------- 
    270  
    271 == 2.学车后台 == 
    272 ---------- 
    273  
    274 === 2.1 大小压缩中的交通标志列表页 === 
    275 '''(开发已完成）'''[[BR]] 
    276 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listTrafficSign.xsp [[BR]] 
    277 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/traffic/listTrafficSign.do  [[BR]] 
    278 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listTrafficSign.do [[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 ||= typeId =||= 类型 =|| int ||=  =||= 是 =||=  =|| 
    304 ||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
    305 ||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
    306  
    307 **返回** 
    308  
    309 {{{#!java 
    310 { 
    311         code:0成功，-1失败 
    312         message:失败原因 
    313         signCount:总个数 
    314         pageNo:页码 
    315         pageSize:一页个数 
    316         pageCount:总页数 
    317         tracficList:[{ 
    318             img:原图URL 
    319             signName:标志名字 
    320             signDesc:标志描述 
    321         }] 
    322 } 
    323 }}} 
    324 **返回参数说明** 
    325 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    326 ||= img =||= 原图URL =||= signName =||= 标志名字 =|| 
    327 ||= signDesc =||= 标志描述 =||=  =||=  =|| 
    328  
    329 ---------- 
    330  
    331 === 2.2 商品详情 === 
    332 '''(开发已完成）'''[[BR]] 
    333 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getGiftDetailById.xsp [[BR]] 
    334 学车后台开发环境：http://dev38.pcauto.com.cn:8003//appapi/1.0/gift/getGiftDetailById.do  [[BR]] 
    335 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/getGiftDetailById.do [[BR]] 
    336  
    337 **说明** 
    338  
    339 > 获取商品详情 
     30> 联系杂志君对话内容 
    34031 
    34132**缓存时间** 
    … …  
    35344**数据来源** 
    35445 
    355 >学车后台 
     46>联系杂志君后台 
    35647 
    35748**参数** 
    35849 
    35950||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    360 ||= giftId =||= 礼品ID =||= long =||=  =||= 是 =||=  =|| 
    361 ||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
     51||= accountId =||= 账户id =|| int ||=  =||= 是 =||=  =|| 
     52||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
     53||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
    36254 
    36355**返回** 
    … …  
    36557{{{#!java 
    36658{ 
    367         code:0成功，-1失败 
    368         message:失败原因 
    369         date:{ 
    370             name:商口名字 
    371             gold:兑换所需学分 
    372             curNum:剩余库存 
    373             limitNum:兑换上限 
    374             imagePath：礼品详情图片链接 
    375             smallCoverImg:160X120的封面图 
    376             description:商品详细说明 
    377             exchangeStatus:后台判断，0：马上兑换，-5：库存不足，-6：已达兑换上限，-2：分数不足 
     59    "data": [ 
     60        { 
     61            "content": "我的评论被删了", 
     62            "from": "user", 
     63            "messageId": 71, 
     64            "time": 1447756244000 
    37865        } 
     66    ], 
     67    "errorCode": 200, 
     68    "message": "查询成功", 
     69    "pageNo": 1, 
     70    "pageSize": 10, 
     71    "totalPage": 10 
    37972} 
    38073}}} 
    38174**返回参数说明** 
    38275||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    383 ||= name =||= 商口名字 =||= gold =||= 兑换所需学分 =|| 
    384 ||= curNum =||= 剩余库存 =||= limitNum =||= 兑换上限 =|| 
    385 ||= imagePath =||= 礼品详情图片链接 =||= smallCoverImg =||= 160X120的封面图 =|| 
    386 ||= description =||= 商品详细说明 =||= exchangeStatus =||= 后台判断 =|| 
     76||= content =||= 内容 =||= from =||= 消息来源 =|| 
     77||= messageId =||= 消息id =||= time =||= 时间戳 =|| 
    38778 
    38879---------- 
    38980 
    390 === 2.3 兑换记录列表 === 
    391 '''(开发已完成）'''[[BR]] 
    392 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listRecord.xsp [[BR]] 
    393 学车后台开发环境：http://dev38.pcauto.com.cn:8003//appapi/1.0/gift/listRecord.do  [[BR]] 
    394 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listRecord.do [[BR]] 
     81=== 2.2 发送消息 === 
     82'''(非mrobot接口）'''[[BR]] 
     83> 学车后台开发环境：http://dev19.pchouse.com.cn:9090/message/addUserMessage.do?accountId=863178&content=%E6%88%91%E7%9A%84%E8%AF%84%E8%AE%BA%E8%A2%AB%E5%88%A0%E4%BA%86&image=http://img.pchouse.com.cn/images/upload/upc/tx/coin/1511/11/c0/15115638_15115638_1447210609718_500x500.jpg  [[BR]] 
    39584 
    396 **说明** 
    397  
    398 > 兑换记录列表 
    399  
    400 **缓存时间** 
    401  
    402 >0 
    40385 
    40486**提交方式** 
    40587 
    406 > GET 
     88> Post 
    40789 
    408 **是否登录** 
    409  
    410 > 是 
    411  
    412 **数据来源** 
    413  
    414 >学车后台 
    41590 
    41691**参数** 
    … …  
    41893||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    41994||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
    420 ||= pageNo =||= 页码 =||= int =||=  =||= 否 =||=  =|| 
    421 ||= pageSize =||= 页数 =||= int =||=  =||= 否 =||=  =|| 
     95||= content =||= 消息内容 =||= long =||=  =||= 是 =||=  =|| 
     96||= image =||= 图片 =||= long =||=  =||= 是 =||=  =|| 
    42297 
    423 **返回** 
     98---------- 
    42499 
    425 {{{#!java 
    426 { 
    427         code:0成功，-1失败 
    428         message:失败原因 
    429         pageNo:页码 
    430         pageSize:一页个数 
    431         pageCount:总页数 
    432         recordList:[{ 
    433             giftId:商品ID 
    434             conversionId:兑换的ID 
    435             giftImg:商品160X120地址 
    436             name:商品名字 
    437             status:0未发货，1已发货，2待付款，-1驳回(失败) 
    438             createAt:创建时间 
    439         }] 
    440 } 
    441 }}} 
    442 **返回参数说明** 
    443 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    444 ||= giftId =||= 商品ID =||= conversionId =||= 兑换的ID =|| 
    445 ||= giftImg =||= 商品160X120地址 =||= name =||= 商品名字 =|| 
    446 ||= status =||= 0未发货，1已发货，2待付款，-1驳回(失败) =||= createAt =||= 创建时间 =|| 
    447  
    448 === 2.4 兑换商品 === 
    449 1.通过[http://trac.pc.com.cn/iphone/wiki/pcauto_drive_2.3.0/interface#a2.2商品详情]拿到数据显示； [[BR]] 
    450 2.通过[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.3.礼品兑换接口2.3]提交数据 [[BR]] 
    451 ----------- 
    452  
    453 === 2.5 兑换成功 === 
    454 1.通过[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.3.礼品兑换接口2.3]返回的id拼接跳转链接 [[BR]] 
    455 ----------- 
    456  
    457 === 2.6 兑换详情 === 
    458 1.学车后台提供前缀，app用id拼接详情页链接 [[BR]] 
    459 ----------- 
    460  
    461 === 2.7 用户摇一摇今日剩余次数 === 
     100=== 2.3 更新杂志君消息已读状态 === 
    462101'''(开发已完成）'''[[BR]] 
    463 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/getLeftShakeCount.xsp [[BR]] 
    464 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/shake/getLeftShakeCount.do [[BR]] 
    465 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/shake/getLeftShakeCount.do [[BR]] 
     102>mrobot地址：http://dev40.pcauto.com.cn/xsp/s/auto/info/cms/updateIsReaded.xsp?accountId=863178 [[BR]] 
     103杂志君开发环境：http://dev19.pchouse.com.cn:9090/message/updateIsReaded.do?accountId=863178 [[BR]] 
     104杂志君线上环境： [[BR]] 
    466105 
    467106**说明** 
    468107 
    469 > 获取用户摇一摇今天的剩余次数 
     108> 更新杂志君消息已读状态 
    470109 
    471110**缓存时间** 
    472111 
    473 > 
     112>0 
    474113 
    475114**提交方式** 
    … …  
    494133{{{#!java 
    495134{ 
    496         code:0成功，-1失败，-2未登录 
    497         message:失败原因 
    498         shakeCount:今天还剩的摇一摇次数 
     135    "errorCode": 200, 
     136    "message": "查询成功" 
    499137} 
    500138}}} 
    501139**返回参数说明** 
    502140||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    503 ||= code =||= 状态码 =||= message =||= 描述 =|| 
    504 ||= shakeCount =||= 今天还剩的摇一摇次数 =||=  =||=  =|| 
     141||= errorCode =||= 返回码 =||= message =||= 信息 =|| 
    505142 
    506 ----------- 
     143---------- 
    507144 
    508 === 2.8 摇一摇出题 === 
     145=== 2.4 获取消息数 === 
    509146'''(开发已完成）'''[[BR]] 
    510 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/shakeAShake.xsp [[BR]] 
    511 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/shake/shakeAShake.do [[BR]] 
    512 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/shake/shakeAShake.do [[BR]] 
     147>mrobot地址：http://dev40.pcauto.com.cn/xsp/s/auto/info/cms/getMessageNum.xsp?accountId=25018537 [[BR]] 
     148杂志君开发环境：http://dev19.pchouse.com.cn:9090/message/getMessageNum.do?accountId=25018537 [[BR]] 
     149杂志君线上环境： [[BR]] 
    513150 
    514151**说明** 
    515152 
    516 > 摇一摇出题目，注意：总次数是2次，但根据不同的subjcetID出题 
     153> 获取消息数 
    517154 
    518155**缓存时间** 
    519156 
    520 > 
     157>0 
    521158 
    522159**提交方式** 
    … …  
    530167**数据来源** 
    531168 
    532 >学车后台 
     169>杂志君后台 
    533170 
    534171**参数** 
    … …  
    536173||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    537174||= accountId =||= 用户ID =||= long =||=  =||= 是 =||=  =|| 
    538 ||= subjectId =||= 科目ID =||= long =||=  =||= 是 =||=  =|| 
    539 **返回** 
    540  
    541 {{{#!java 
    542 { 
    543         code:0成功，-1失败，-2未登录 
    544         message:失败原因 
    545         shakeCount:今天还剩的摇一摇次数 
    546         questionId: 
    547 } 
    548 }}} 
    549 **返回参数说明** 
    550 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    551 ||= code =||= 状态码 =||= message =||= 描述 =|| 
    552 ||= shakeCount =||= 今天还剩的摇一摇次数 =||= questionId =||= 题目id =|| 
    553 ----------- 
    554  
    555 === 2.9 摇一摇加分接口 === 
    556 1.后端接口猛戳[http://rdtrac.pc.com.cn/xueche/wiki/appapi/2.3#a1.7.摇一摇加分接口2.3] [[BR]] 
    557 ----------- 
    558  
    559 === 2.10 消息列表 === 
    560 '''(开发已完成）'''[[BR]] 
    561 >mrobot地址：http://dev40.pcauto.com.cn/xsp/s/auto/info/xueChe/expertMessage.xsp [[BR]] 
    562 bip开发环境： [[BR]] 
    563 bip线上环境：http://bip.pcauto.com.cn/intf/sysnotice.jsp?act=find&siteId=2&typeIds=2071 [[BR]] 
    564  
    565 **说明** 
    566  
    567 > 获取消息列表 
    568  
    569 **缓存时间** 
    570  
    571 > 
    572  
    573 **提交方式** 
    574  
    575 > GET 
    576  
    577 **是否登录** 
    578  
    579 > 是 
    580  
    581 **数据来源** 
    582  
    583 >BIP 
    584  
    585 **参数** 
    586  
    587 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    588 ||= pageNo =||= 页码 =||= int =||= 1 =||= 否 =||=  =|| 
    589 ||= pageSize =||= 分页大小 =||= int =||= 20 =||= 否 =||=  =|| 
    590 **返回** 
    591 {{{#!java 
    592 { 
    593         "total":55,  总记录数 
    594         "pageNo":1,  当前第几页 
    595         "pageCount":3,  一共有多少页 
    596         "pageSize":20,  每页多少条记录 
    597         "resultList":  消息列表 
    598         [ 
    599            { 
    600              "id":249723334,  消息ID 
    601              "type":{"name":"官方活动","id":0,"templateId":0,"siteId":0,"groupType":1},  消息类型信息 
    602              "content":"有问必答福利来了，现开通两个与车相关话题#车主来帮忙",  消息内容 
    603              "createTime":1434540046000,  消息创建时间 
    604              "status":1,  消息状态 0未读  1已读 
    605              "accountId":7072562,  接收者ID 
    606              "typeId":69,  消息类型Id 
    607              "siteId":2,  消息属于那个网站 
    608              "groupSend":1,  是否群发消息 
    609              "groupType":0,  消息分组ID 
    610              "senderId":0  发送者ID 
    611             } 
    612          ] 
    613     }   
    614 }}} 
    615 **返回参数说明** 
    616 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    617 ||= id =||= 消息ID =||= type =||= 消息类型信息 =|| 
    618 ||= content =||= 消息内容 =||= createTime =||= 消息创建时间 =|| 
    619 ||= status =||= 消息状态 =||= accountId =||= 接收者ID =|| 
    620 ||= typeId =||= 消息类型Id =||= siteId =||= 消息属于那个网站 =|| 
    621 ||= groupSend =||= 是否群发消息 =||= groupType =||= 消息分组ID =|| 
    622 ||= senderId =||= 发送者ID =||= =||= =|| 
    623  
    624 ----------- 
    625  
    626 === 2.11 专题列表 === 
    627 '''(开发已完成）'''[[BR]] 
    628 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listActive.xsp [[BR]] 
    629 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/active/listActive.do  [[BR]] 
    630 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/active/listActive.do [[BR]] 
    631  
    632 **说明** 
    633  
    634 > 获取专题列表 
    635  
    636 **缓存时间** 
    637  
    638 > 
    639  
    640 **提交方式** 
    641  
    642 > GET 
    643  
    644 **是否登录** 
    645  
    646 > 否 
    647  
    648 **数据来源** 
    649  
    650 >学车后台 
    651  
    652 **参数** 
    653  
    654 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    655 ||= pageNo =||= 页码 =||= int =||=  =||= 否 =||=  =|| 
    656 ||= pageSize =||= 每页条数 =||= int =||=  =||= 否 =||=  =|| 
    657 **返回** 
    658  
    659 {{{#!java 
    660 { 
    661         code:0成功，-1失败 
    662         message:失败原因 
    663         pageNo:页码 
    664         pageSize:一页个数 
    665         pageCount:总页数 
    666         activeList:[{ 
    667             id:专题ID 
    668             periods:期数 
    669             title:标题 
    670             coach:教练 
    671             schoolName:驾校名 
    672             timestart:开始时间 
    673             timeEnd:活动结束时间 
    674             status:0:进行中 ，1：未开始  ，-1：已结束 
    675         }] 
    676 } 
    677 }}} 
    678 **返回参数说明** 
    679 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    680 ||= id =||= 专题ID =||= periods =||= 期数 =|| 
    681 ||= title =||= 标题 =||= coach =||= 教练 =|| 
    682 ||= schoolName =||= 驾校名 =||= timestart =||= 开始时间 =|| 
    683 ||= timeEnd =||= 活动结束时间 =||= status =||= 0:进行中 ，1：未开始  ，-1：已结束 =|| 
    684  
    685 ----------- 
    686 === 2.12 单个专题页 & 教练主页  HTML === 
    687 1.根据原型，该部分使用wap版。 [[BR]] 
    688 ----------- 
    689  
    690 === 2.13 获取省市 === 
    691 '''(开发已完成）'''[[BR]] 
    692 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/jsonProvinceAndCity.xsp [[BR]] 
    693 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/area/jsonProvinceAndCity.do  [[BR]] 
    694 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/area/jsonProvinceAndCity.do [[BR]] 
    695  
    696 **说明** 
    697  
    698 > 获取最新专题 
    699  
    700 **缓存时间** 
    701  
    702 > 
    703  
    704 **提交方式** 
    705  
    706 > GET 
    707  
    708 **是否登录** 
    709  
    710 > 否 
    711  
    712 **数据来源** 
    713  
    714 >学车后台 
    715  
    716 **参数** 
    717  
    718 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    719175 
    720176**返回** 
    … …  
    722178{{{#!java 
    723179{ 
    724         code:0成功，-1失败 
    725         message:失败原因 
    726         addressList:[{ 
    727             provincepy:省的首字母拼音 
    728             provinceId:省ID 
    729             province:省名 
    730             cityId:城市ID 
    731             city：城市名 
    732         }] 
     180    "contactNum": 0, 
     181    "errorCode": 200, 
     182    "message": "查询成功", 
     183    "sysNum": 7 
    733184} 
    734185}}} 
    735186**返回参数说明** 
    736187||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    737 ||= provincepy =||= 省的首字母拼音 =||= provinceId =||= 省ID =|| 
    738 ||= province =||= 省名 =||= cityId =||= 城市ID =|| 
    739 ||= city =||= 城市名 =||= =||= =|| 
    740  
    741 ----------- 
    742  
    743 === 2.14 交通标志类型列表页接口 === 
    744 '''(开发已完成）'''[[BR]] 
    745 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/listTrafficType.xsp [[BR]] 
    746 学车后台开发环境：http://dev38.pcauto.com.cn:8003/appapi/1.0/traffic/listTrafficType.do  [[BR]] 
    747 学车后台线上环境：http://xueche.pcauto.com.cn/appapi/1.0/traffic/listTrafficType.do [[BR]] 
    748  
    749 **说明** 
    750  
    751 > 交通标志类型列表页 
    752  
    753 **缓存时间** 
    754  
    755 >0 
    756  
    757 **提交方式** 
    758  
    759 > GET 
    760  
    761 **是否登录** 
    762  
    763 > 否 
    764  
    765 **数据来源** 
    766  
    767 >学车后台 
    768  
    769 **参数** 
    770  
    771 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    772 ||= typeId =||= 类型 =|| int ||=  =||= 是 =||= 父类(type=0时，查询一级分类,type>0时，是查询该类型的下一级分类) =|| 
    773 ||= pageNo =||= 页码 =|| string ||=  =||= 否 =||=  =|| 
    774 ||= pageSize =||= 每页条数 =|| string ||=  =||= 否 =||=  =|| 
    775  
    776 **返回** 
    777  
    778 {{{#!java 
    779 { 
    780         code:0成功，-1失败 
    781         message:失败原因 
    782         pageNo:页码 
    783         pageSize:一页个数 
    784         pageCount:总页数 
    785         tracficTypeList:[{ 
    786             id:类型的ID 
    787             name:标志名字 
    788             description:标志描述 
    789             hasChild:是否含有子结点 
    790             totalImg:总图片数 
    791         }] 
    792 } 
    793 }}} 
    794 **返回参数说明** 
    795 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    796 ||= id =||= 类型的ID =||= name =||= 标志名字 =|| 
    797 ||= description =||= 标志描述 =||= hasChild =||= 是否含有子结点 =|| 
    798 ||= totalImg =||= 总图片数 =||=  =||=  =|| 
     188||= contactNum =||= 联系杂志君数目 =||= sysNum =||= 消息中心数目 =|| 
    799189 
    800190---------- 
    801  
    802 == 3.活动 == 
    803 === 3.1 获取实物奖品记录 === 
    804 '''(开发已完成）'''[[BR]] 
    805 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/activityPrizeList.xsp [[BR]] 
    806 活动后台开发环境：http://v39.pcauto.com.cn:8003/action/getRecord.jsp  [[BR]] 
    807 活动后台线上环境：http://activity.pcauto.com.cn/auto151019/action/getRecord.jsp [[BR]] 
    808  
    809 **说明** 
    810  
    811 > 获取实物奖品记录 
    812  
    813 **缓存时间** 
    814  
    815 > 
    816  
    817 **提交方式** 
    818  
    819 > GET 
    820  
    821 **是否登录** 
    822  
    823 > 是 
    824  
    825 **数据来源** 
    826  
    827 >活动后台 
    828  
    829 **参数** 
    830  
    831 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    832 ||= pageSize =||= 每页显示数 =||= int =||= 5 =||= 否 =||=  =|| 
    833 ||= pageNo =||= 页码 =||= int =||= 1 =||= 否 =||=  =|| 
    834 **返回** 
    835  
    836 {{{#!java 
    837 {"code":-1,"msg":"活动已结束,感谢您的参与"} 
    838 {"code":-2,"msg":"请登陆后查看中奖记录"} 
    839 {"code":-3,"msg":"获取中奖记录失败"} 
    840 {"code":1,"msg":"获取中奖记录成功","count":"用户中奖次数","list":[{"awardLogId":中奖记录id,"userId":用户id,"accountName":用户名,"realName":真实姓名,"phone":手机号,"address":地址,"zipCode":邮编,"useCredit":抽奖消耗的学分,"awardId":奖品id,"awardName":奖品名,"awardType":奖品类型,"awardStatus":发奖信息,"createAt":中奖时间,"updateAt":更新时间}]}                 
    841 }}} 
    842 **返回参数说明** 
    843 ||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
    844 ||= awardLogId =||= 中奖记录id =||= userId =||= 用户id =|| 
    845 ||= accountName =||= 用户名 =||= realName =||= 真实姓名 =|| 
    846 ||= phone =||= 手机号 =||= address =||= 地址 =|| 
    847 ||= zipCode =||= 邮编 =||= useCredit =||= 抽奖消耗的学分 =|| 
    848 ||= awardId =||= 奖品id =||= awardName =||= 奖品名 =|| 
    849 ||= awardType =||= 奖品类型 =||= awardStatus =||= 发奖信息 =|| 
    850 ||= createAt =||= 中奖时间 =||= updateAt =||= 更新时间 =|| 
    851 ||= count =||= 用户中奖次数 =||=  =||=  =|| 
    852  
    853 ----------- 
    854  
    855 === 3.2 奖品详情页 === 
    856 '''(开发已完成）'''[[BR]] 
    857 >mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/info/xueChe/activityPrizeDetail.xsp [[BR]] 
    858 活动后台开发环境：http://v39.pcauto.com.cn:8003/detail.jsp  [[BR]] 
    859 活动后台线上环境：http://activity.pcauto.com.cn/auto151019/detail.jsp [[BR]] 
    860  
    861 **说明** 
    862  
    863 > 获取实物奖品记录 
    864  
    865 **缓存时间** 
    866  
    867 > 
    868  
    869 **提交方式** 
    870  
    871 > GET 
    872  
    873 **是否登录** 
    874  
    875 > 是 
    876  
    877 **数据来源** 
    878  
    879 > 活动后台 
    880  
    881 **参数** 
    882  
    883 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| 
    884 ||= awardLogId =||= 抽奖记录的id =||= long =||=  =||= 是 =||=  =|| 
    885  
    886 **返回** 
    887 > HTML 
    888  
    889 **返回参数说明** 
    890  
    891  
    892 -----------