Changes between Version 4 and Version 5 of pcauto_4.8.0/interface


Ignore:
Timestamp:
10/23/2015 03:20:42 PM (10 years ago)
Author:
liguokai
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_4.8.0/interface

    v4 v5  
    1212 
    1313 
    14 === 1.1车系页-优惠 === 
    15 '''(mrobot开发中)'''[[BR]] 
    16 >mrobot地址:http://mrobot.pcauto.com.cn/v3/price/promotionDetailv45/10424206?modelId=33314&type=1 [[BR]] 
    17 price开发环境:暂无 [[BR]] 
    18 price线上环境:http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId=10424206&modelId=33314 [[BR]] 
    19              http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId=10424206 [[BR]] 
     14=== 1.1车系页-优惠列表 === 
     15'''(开发已完成,调试请连开发机代理)'''[[BR]] 
     16>mrobot地址:http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=discountRange&serialId=3544 [[BR]] 
     17price开发环境:http://dev3.pcauto.com.cn:8001/dealer/interface/app/market_json.jsp?pageNo=1&pageSize=20&areaId=1&serialId=3544&orderBy=discountRange [[BR]] 
     18price线上环境:http://price.pcauto.com.cn/dealer/interface/app/market_json.jsp?pageNo=1&pageSize=20&areaId=1&serialId=3544&orderBy=discountRange [[BR]] 
    2019 
    2120**说明** 
    2221 
    23 > 获取车系页-优惠[[BR]] 
     22> 获取车系页-优惠列表[[BR]] 
    2423 
    2524**缓存时间** 
    2625 
    27 > 
     26>1小时 
    2827 
    2928**提交方式** 
     
    3938> 车型库 
    4039 
    41 **参数** 
     40**请求参数** 
    4241 
    43 ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
    44 ||= pageNo =||= 页数 =||int||= 1 =||= 否 =||=  =|| 
    45 ||= pageSize=||= 每页条数 =||int||= 20 =||= 否 =||=  =|| 
    46 ||= topicId =||=挂评论的话题id =||= string =||=  =||= 是 =||= 应用端需要 =|| 
    47 ||= articleId=||=文章id=||= string =||=  =||= 否 =||=  =|| 
    48 ||= reverse=||=是否倒序 =||= string =||=  =||= 否 =||=  =|| 
     42与旧版本一致 
    4943**返回** 
    50  
     44增加礼包返回字段,下面说明只列出增加返回参数 
    5145 
    5246 
    5347**返回参数说明** 
    54 ||= 参数名 =||= 参数含义 =|| 
    55 ||= =||= =|| 
     48||= 参数名 =||= 参数含义 =||= 参数名 =||= 参数含义 =|| 
     49||= giftPrice =||= 礼包价值 =||= haveGift =||= 是否有礼包 =|| 
    5650 
    5751== 2.资讯 == 
     
    6155=== 2.1文章终端页 === 
    6256'''(mrobot开发中)'''[[BR]] 
    63 >mrobot地址:http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0 [[BR]] 
    64 例如:http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0 [[BR]] 
    65 cmt开发环境:http://test2.pcauto.com.cn:8002/app/json/ [[BR]] 
    66 cmt线上环境:http://www.pcauto.com.cn/app/21json [[BR]] 
     57>mrobot地址:http://mrobot.pcauto.com.cn/v3/cms/articles/7095069?articleTemplate=4.8.0&app=pcautobrowser&channelId=55555&serialId=0&size=18&picRule=2 [[BR]] 
     58cms开发环境:暂无 [[BR]] 
     59cms线上环境:http://192.168.10.74:8003/interface/pcauto/mrobot_articles_v3.jsp?id=7095069 [[BR]] 
    6760 
    6861**说明** 
    6962 
    70 > 此接口为资讯客户端15个栏目集合,涉及参数以及各种情景太多,实在不能穷举,以下只列出新增内容。[[BR]] 
    71 > '''对于客户端逻辑,此版本只需要新增一个pageNo的返回值处理,当接口返回JSONObject为文章类型,并且返回pageNo时,打开文章页且跳到对应的pageNo页'''[[BR]] 
     63> 以下只列出差异、新增内容。[[BR]] 
    7264 
    7365**缓存时间** 
    7466 
    75 >首页列表5分钟,其余栏目30分钟 
     67>1小时 
    7668 
    7769**提交方式** 
     
    8577**数据来源** 
    8678 
    87 > cms、快搜、cmt、直播后台等等 
     79> cms、cmt、车型库等等 
    8880 
    8981**参数** 
    9082 
    91 请参照客户端旧逻辑,此版本对传入参数无修改。[[BR]]  
     83'''articleTemplate=4.8.0,其余参数无更改。'''[[BR]]  
    9284**返回** 
    93 {{{#!java 
    94 { 
    95     "data": [ 
    96         { 
    97             "articleType": "y", 
    98             "channelId": 1, 
    99             "channelName": "头条", 
    100             "count": 0, 
    101             "downs": 0, 
    102             "id": "6929470", 
    103             "image": "http://img0.pcauto.com.cn/pcauto/1509/14/g_6959543_1442223329657_240x160.jpg", 
    104             "pageNo": 3, 
    105             "pubDate": "2013-01-01", 
    106             "title": "测试旧文章", 
    107             "type": 1, 
    108             "ups": 0, 
    109             "url": "http://www.pcauto.com.cn/teach/692/6929470_2.html" 
    110         } 
    111     ], 
    112     "focus": [  
    113         { 
    114             "articleType": "n", 
    115             "id": "1623455", 
    116             "image": "http://img0.pcauto.com.cn/pcauto/app/daogou/1108/201108311.jpg", 
    117             "pubDate": "2011-08-31", 
    118             "title": "哈弗H6挑战比亚迪S6/瑞虎/海马骑士", 
    119             "topicUrl": "http://www.pcauto.com.cn/teach/1108/1622411.html", 
    120             "url": "http://www.pcauto.com.cn/app/daogou/1108/1623455.html" 
    121         } 
    122     ], 
    123     "pageNo": 1, 
    124     "pageSize": 1, 
    125     "topData": [ 
    126         { 
    127             "cc-uri": "http://count.imofan.com/count?url=http://www.pcauto.com.cn/nation/669/6690671.html&ad=132", 
    128             "channelId": 0, 
    129             "channelName": "", 
    130             "count": 0, 
    131             "downs": 0, 
    132             "id": "161", 
    133             "image": "http://img0.pcauto.com.cn/pcauto/1503/15/6055040_567.jpg", 
    134             "isExtend": "0", 
    135             "preView": "央视3·15晚会正在直播 消费在阳光下", 
    136             "pubDate": "2015-03-15", 
    137             "seq": 1, 
    138             "title": "央视3·15晚会直播回顾 消费在阳光下", 
    139             "to-uri": "pcautobrowser://information-article/161?template=live", 
    140             "type": 4, 
    141             "updateAt": 1436284800000, 
    142             "ups": 0 
    143         } 
    144     ], 
    145     "topFocus": [ 
    146         { 
    147             "image": "http://www1.pcauto.com.cn/test/qwegf3wrefgvazv.jpg", 
    148             "seq": 1, 
    149             "title": "驾名爵锐腾1.5T四驱豪华版", 
    150             "to-uri": "http://m.pcauto.com.cn/x/guangzhou/?type=zt&FromApp=1&browser=commonwebview&v=4.5.0", 
    151             "updateAt": 1437408000000 
    152         } 
    153     ], 
    154     "total": 150 
    155 } 
    156 }}} 
     85只增加一个询底价协议返回:pcautobrowser://auto-ask-price/?serialId=3224&serialName=%E9%A3%9E%E5%BA%A6[[BR]]  
    15786 
    158  
    159 **返回参数说明** 
    160 [[BR]] 在data与focus数组内的每一个JSONOject增加以下参数返回[[BR]] 
    161 注意:'''pageNo是此版本客户端要新增的处理,客户端同事特别注意。'''[[BR]] 
     87**增加返回协议说明** 
    16288||= 参数名 =||= 参数含义 =|| 
    163 ||= type =||= 1文章,2帖子,3图集,4直播,5专题,6活动,0其他 =|| 
    164 ||= to-uri =||= 论坛版块pcautobrowser://bbs-topics/,图库图片pcautobrowser://album-photo/,车系界面pcautobrowser://serial/,车型界面pcautobrowser://model/ =|| 
    165 ||= pageNo =||= 当type等于1(文章)时,假如有返回pageNo,要跳转到文章相应的pageNo页 =|| 
    166 ||= articleType =||= 值为y表示旧文章 =|| 
     89||= serialId=||= 车系id =|| 
     90||= serialName =||= 车系名称 =||