Changes between Version 2 and Version 3 of pcauto_4.7.1/interface


Ignore:
Timestamp:
05/06/2015 03:26:05 PM (11 years ago)
Author:
liguokai
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_4.7.1/interface

    v2 v3  
    99{{{ 
    1010   (接口已上线) 
    11     请求url:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=4.5.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 
     11    请求url:http://mrobot.pcauto.com.cn/v3/cms/articles/6087599?articleTemplate=4.5.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 
    1212    HTTP请求方式:GET 
    1313    是否需要登录:true 
     
    1616    缓存时间:60分钟 
    1717    请求参数: 
    18 common_session_id:登录后的session,Cookies传值 
    19 articleTemplate:版本号,当值为4.5.0时才能显示文章标签与最热评论 
    20     说明:点击整块热门评论部分,都是触发评论跳转 
     18    与旧版一致,无更改。 
     19     
    2120    返回结果: 
    22 增加文章标签协议:pcautobrowser://article-tag/id 
    23 增加评论跳转协议: pcautobrowser://comment/topicId 
    24  
    25 热门评论直接从mrobot出,不需要再调用addComments(jsonArray), 
    26 当有数据时以jsonArray中前两条(有可能是一条)评论显示为热门评论部分 
    27 当数据为空时,不显示热门评论部分 
     21    页面增加投票表单。 
    2822 
    2923}}} 
    3024 
    31 === 2.2 [=#point2.2 直播改版] === 
    32 ==== 2.2.1 [=#point2.2.1 首页栏目] ==== 
    33 (接口已上线) 
    34 [[BR]]新接口:http://mrobot.pcauto.com.cn/configs/pcauto_v4_cms_iphone_channel_tree(IOS) 
    35 [[BR]]新接口:http://mrobot.pcauto.com.cn/configs/pcauto_v4_cms_android_channel_tree(Android) 
    36 [[BR]]原接口:http://mrobot.pcauto.com.cn/configs/pcauto_v3_cms_iphone_channel_tree(IOS) 
    37 [[BR]]原接口:http://mrobot.pcauto.com.cn/configs/pcauto_v3_cms_android_channel_tree(Android) 
    38 [[BR]]HTTP请求方式:get 
    39 [[BR]]是否需要登录:false 
    40 [[BR]]返回格式:json 
    41 [[BR]]缓存方式: 
    42 [[BR]]缓存时间: 
    43 [[BR]]说明:V4.7.0需要新增“直播”栏目,同时旧版本屏蔽该栏目 
    44 [[BR]]返回数据结构 
    45 {{{ 
    46 { 
    47 news: [ 
    48 [ 
    49 "1", 
    50 "首页", 
    51 "696" 
    52 ], 
    53 [ 
    54 "2", 
    55 "新车", 
    56 "296" 
    57 ], 
    58 [ 
    59 "55555", 
    60 "行情", 
    61 "297" 
    62 ], 
    63 [ 
    64 "3", 
    65 "导购", 
    66 "298" 
    67 ], 
    68 ... 
    69 [ 
    70 "18", 
    71 "直播", 
    72 "723" 
    73 ] 
    74 ],... 
    75 }}} 
    76 ==== 2.2.2 [=#point2.2.2 直播栏目列表] ==== 
    77 (接口已上线) 
    78 [[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v2/cms/channels/18?v=4.0.0&pageNo=1&pageSize=2 
    79 [[BR]]后台接口:http://www.pcauto.com.cn/app/000082762/000082782/1503/intf6607.js# 
    80 [[BR]]HTTP请求方式:get 
    81 [[BR]]是否需要登录:false 
    82 [[BR]]返回格式:json 
    83 [[BR]]缓存方式: 
    84 [[BR]]缓存时间: 
    85 [[BR]]说明:需分页;一个直播内容包含banner图、标题、直播状态、时间、评论数/回复数共5个要素 
    86 [[BR]]请求参数:[[BR]] 
    87 ||参数名||类型||必须||说明|| 
    88 ||v||String||可选||版本号,v=4.0.0表示4.0以后的版本|| 
    89 ||pageNo||int||必须||页码(默认为1)|| 
    90 ||pageSize||int||必须||每页大小(默认为200)|| 
    91 [[BR]]返回数据结构 
    92 {{{ 
    93 { 
    94  data: [ 
    95  { 
    96   banner(图片): "http://img0.pcauto.com.cn/pcauto/app/000082762/000082782/1503/00002.png", 
    97   count(评论数): 0, 
    98   titile(标题): "【跑男来助阵】 售价14.59-21.39万 凌渡上市直播回顾", 
    99   zbId: "6433050", 
    100   zbState(直播状态:1表示正在直播,0表示已结束): "1", 
    101   zbTime: "2015-02-03 15:02:00", 
    102   zbType(type=1表示直播文章,0表示论坛帖子): "0", 
    103   zbUrl: "http://bbs.pcauto.com.cn/topic-6433050.html" 
    104   }, 
    105  { 
    106   banner: "http://img0.pcauto.com.cn/pcauto/app/000082762/000082782/1503/0011.jpg", 
    107   count: 386, 
    108   titile: "2015日内瓦车展现场直播", 
    109   zbId: "151", 
    110   zbState: "1", 
    111   zbTime: "2015-06-02 13:05:00", 
    112   zbType: "1", 
    113   zbUrl: "http://live.pcauto.com.cn/broadRecord.jsp?broadcastId=151" 
    114  } 
    115  ], 
    116  pageNo: 1, 
    117  pageSize: 2, 
    118  total: 2 
    119 } 
    120 }}} 
    121 ==== 2.2.3 [=#point2.2.3 直播内容详情页] ==== 
    122 (接口已上线) 
    123 [[BR]]mrobot接口:mrobot接口:http://mrobot.pcauto.com.cn/v3/zbDetail?broadcastId=191&size=18 
    124 [[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/_ajaxRecord.jsp?broadcastId=191&pageNo=1&pageSize=20 
    125 [[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/getBroadcast.jsp?broadcastId=191 
    126 [[BR]]协议(评论节点内容):pcaction://writeComment/partId?zbUrl=&recordId= 
    127 [[BR]]协议(回复评论): pcaction://replyComment/partId?zbUrl=&&floor=&recordId= 
    128 [[BR]]协议(点击更多):pcaction://loadMoreComment/partId?zbUrl=&pageNo=1&pageSize=20&recordId= 
    129 [[BR]]协议(个人中心):pcaction://user-center/userId 
    130 [[BR]]HTTP请求方式:get 
    131 [[BR]]是否需要登录:false 
    132 [[BR]]返回格式:html 
    133 [[BR]]缓存方式: 
    134 [[BR]]缓存时间: 
    135 [[BR]]说明:页面源码中_HTML_META_START_需提供以下数据: 
    136 [[BR]]title——直播标题 
    137 [[BR]]status——0表示已结束,1表示正在直播,2表示其他 
    138 [[BR]]anchorImg——主播头像 
    139 [[BR]]anchor——主播名称 
    140 [[BR]]abstract——直播简介(这个需要保留a标签) 
    141 [[BR]]contentNum——该页的内容数量 
    142 [[BR]]url——PC端地址 
    143 [[BR]]firstPic——用于分享的图片地址 
    144 [[BR]]thumbPic——用于分享的图片地址 
    145 [[BR]] 
    146 [[BR]]刷新评论区函数:function commentShow(reqUrl,reqPartId,reqRecordId){} 
    147 [[BR]]reqUrl:直播地址 
    148 [[BR]]reqPartId:直播节点评论id 
    149 [[BR]]reqRecordId:直播节点内容id 
    150 [[BR]] 
    151 [[BR]]manGetRecord()  获取最新直播内容函数 
    152 [[BR]] 
    153 [[BR]]请求参数:[[BR]] 
    154 ||参数名||类型||必须||说明|| 
    155 ||broadcastId||String||必须||直播id|| 
    156 ||order||String||可选||按时间排序,1升序,0降序,默认为0 || 
    157 ||size||String||可选||设置字体大小(16小/18中/20大)|| 
    158 ps:(size参数限制字号选择范围在16--21) 
    159 ==== 2.2.4 [=#point2.2.4 直播节点查看更多页] ==== 
    160 (接口已上线) 
    161 [[BR]]mrobot接口:http://mrobot.pcauto.com.cn/v3/zbCommentDetail?recordId=1511&broadcastId=151&pageNo=1&pageSize=20&partId=1425267845000 
    162 [[BR]]后台接口:http://dev33.pcauto.com.cn:8001/intf/newApp/getRecordByID.jsp?recordId=1511 
    163 [[BR]]后台接口:http://cmt.pcauto.com.cn/templates/pcauto/getPartList.jsp?url=http://live.pcauto.com.cn/broadRecord.jsp?broadcastId=151&pageNo=1&pageSize=20&partId=1425267845000 
    164 [[BR]]HTTP请求方式:get 
    165 [[BR]]是否需要登录:false 
    166 [[BR]]返回格式:html 
    167 [[BR]]缓存方式: 
    168 [[BR]]缓存时间: 
    169 [[BR]]说明: 
    170 [[BR]] 
    171 [[BR]]刷新评论区函数:function commentShow(reqUrl,reqPartId,reqRecordId){} 
    172 [[BR]]reqUrl:直播地址 
    173 [[BR]]reqPartId:直播节点评论id 
    174 [[BR]]reqRecordId:直播节点内容id 
    175 [[BR]] 
    176 [[BR]]请求参数:[[BR]] 
    177 ||参数名||类型||必须||说明|| 
    178 ||recordId||String||必须||直播节点id|| 
    179 ||broadcastId||String||必须||直播id|| 
    180 ||pageNo||String||可选||页码|| 
    181 ||pageSize||String||可选||页面大小|| 
    182 ||partId||String||必须||节点评论id|| 
    183 ==== 2.2.5 [=#point2.2.5 直播文章分节点评论] ==== 
    184 (接口已上线) 
    185 [[BR]]cmt接口:http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp (由于mrobot线上接口会出现获取不了用户外网ip问题,请客户端使用cmt接口,参数不变) 
    186 [[BR]]HTTP请求方式:post 
    187 [[BR]]是否需要登录:false 
    188 [[BR]]返回格式:json 
    189 [[BR]]缓存方式: 
    190 [[BR]]缓存时间: 
    191 [[BR]]说明:当存在[[BR]] 
    192 请求参数:[[BR]] 
    193 ||参数名||类型||必须||说明|| 
    194 ||id/url||String||必须|| 二选一,必填 
    195 ||content||String||必须||评论内容|| 
    196 ||title||String||选填||主题|| 
    197 ||replyFloor2||String||选填||回复楼层(若有)|| 
    198 ||windowname||String||选填||选填,默认为0|| 
    199 ||anonymous||String||选填||选填,1为匿名|| 
    200 ||partId||String||选填||选填,分段落评论的段落id|| 
    201 ||client||String||选填||选填(最好按实际情况给参)|| 
    202 [[BR]]返回数据结构 
    203 {{{ 
    204 { 
    205         "brief": "A57EWEW", 
    206         "commentCount": 1, 
    207         "commentId": 28545421, 
    208         "createTime": "2015-03-20 10:43:07", 
    209         "floor": 9, 
    210         "ip": "59.42.240.7", 
    211         "resultCode": 0, 
    212         "resultMsg": "您的评论已经成功发表。注:评论在审核后才能出现在列表中,谢谢!", 
    213         "showName": "广东省广州市网友", 
    214         "status": 0, 
    215         "topicId": 13272513, 
    216         "userId": -1 
    217 } 
    218 }}} 
     25=== 2.2 [=#point2.2 违章查询] === 
     26==== 2.2.1 [=#point2.2.1 查询首页] ==== 
    21927 
    220 === 2.3 [=#point2.3 违章查询] === 
    221 ==== 2.3.1 [=#point2.3.1 平安的违章查询页面] ==== 
    222 新页面url: 
    223 [[BR]]原url:http://cha.wcar.net.cn/taipingyang 
    224 ==== 2.3.2 [=#point2.3.2 发送用户的查询信息到调查系统] ==== 
    225 接口:http://survey.pcauto.com.cn/auto/submit.jsp 
    226 [[BR]]HTTP请求方式:post 
    227 [[BR]]是否需要登录:false 
    228 [[BR]]返回格式:无 
    229 [[BR]]缓存方式和时间:无 
    230 [[BR]]请求参数:[[BR]] 
    231 ||参数名||类型||必须||说明|| 
    232 ||req_enc||string||必须||编码(固定值):utf-8|| 
    233 ||q_45329||string||必须||查询地区|| 
    234 ||q_45330||string||必须||车牌号|| 
    235 ||q_45331||string||必须||发动机号|| 
    236 ||q_45332||string||必须||车架号|| 
    237 ||q_45333||string||必须||手机号码|| 
    238 ||q_45334||string||必须||购车日期|| 
    239 ||id||string||必须||固定值:12884|| 
    240 ||ver||string||必须||固定值:-1|| 
    241 ||questions||string||必须||固定值:空|| 
    242 [[BR]]说明:当用户进行违章查询,获取页面这些用户信息发送到调查系统;用户再次查询如查询信息不变则不需要再调用,如有变化需要再次调用此接口发送新的信息;不需要处理请求结果 
     28==== 2.2.2 [=#point2.2.2 查询详细页] ==== 
    24329 
    244  
    245 === 2.4 [=#point2.4 关于车系/车型图片] === 
    246 ==== 2.4.1 [=#point2.4.1 车系车型全部type分类图片信息] ==== 
    247 (接口已上线) 
    248 [[BR]]mrobot旧接口:http://mrobot.pcauto.com.cn/v2/price/nav_pictures?serialGroupId=4457&modelId=0 
    249 [[BR]]mrobot新接口:http://mrobot.pcauto.com.cn/v2/price/nav_picturesv47?serialGroupId=4457&modelId=0 
    250 [[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/photo_category_list.jsp 
    251 [[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?mIds= 
    252 [[BR]]HTTP请求方式:get 
    253 [[BR]]是否需要登录:false 
    254 [[BR]]返回格式:json 
    255 [[BR]]缓存方式: 
    256 [[BR]]缓存时间: 
    257 [[BR]]请求参数:[[BR]] 
    258 ||参数名||类型||必须||说明|| 
    259 ||serialGroupId||String||必须||车系id|| 
    260 ||modelId||String||必须||车型id|| 
    261 [[BR]]返回数据结构 
    262 {{{ 
    263 { 
    264 sections: [ 
    265 { 
    266 photos: [ 
    267 { 
    268 bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416688748_400x300.jpg", 
    269 modelId: "36737", 
    270 modelName: "凌渡 2015款 280TSI DSG豪华版 ", 
    271 price: "19.99", 
    272 sellState: 0,  (0:在售,1:即将上市,2:其它) 
    273 smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416688748_120x90.jpg" 
    274 }, 
    275 { 
    276 bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416692674_400x300.jpg", 
    277 modelId: "36737", 
    278 modelName: "凌渡 2015款 280TSI DSG豪华版 ", 
    279 price: "19.99", 
    280 sellState: 0, 
    281 smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1501/28/c12/2443284_2443284_1422416692674_120x90.jpg" 
    282 }, 
    283 ... 
    284 } 
    285 }}} 
    286 ==== 2.4.2 [=#point2.4.2 车系车型图片] ==== 
    287 (接口已上线) 
    288 [[BR]]mrobot旧接口:http://mrobot.pcauto.com.cn/v2/price/pictures?serialGroupId=4457&pageSize=99999&v=4.7.0&modelId=0&typeId=1&colorId=0 
    289 [[BR]]mrobot新接口:http://mrobot.pcauto.com.cn/v2/price/picturesv47?serialGroupId=4457&pageSize=99999&v=4.7.0&modelId=0&typeId=1&colorId=0 
    290 [[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp 
    291 [[BR]]后台接口:http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?mIds= 
    292 [[BR]]HTTP请求方式:get 
    293 [[BR]]是否需要登录:false 
    294 [[BR]]返回格式:json 
    295 [[BR]]缓存方式: 
    296 [[BR]]缓存时间: 
    297 [[BR]]请求参数:[[BR]] 
    298 ||参数名||类型||必须||说明|| 
    299 ||serialGroupId||String||必须||车系id|| 
    300 ||modelId||String||必须||车型id|| 
    301 ||pageNo||int||可选||页码|| 
    302 ||pageSize||int||可选||页面大小|| 
    303 ||v||int||必须||v=4.7.0出4.7版本后的数据|| 
    304 ||typeId||int||可选||分类|| 
    305 ||colorId||int||可选||颜色|| 
    306 [[BR]]返回数据结构 
    307 {{{ 
    308 { 
    309 pageCount: "1", 
    310 pageNo: 1, 
    311 pageSize: 99999, 
    312 sections: [ 
    313 { 
    314 photos: [ 
    315 { 
    316 bigPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_400x300.jpg", 
    317 modelId: "36339", 
    318 modelName: "奥迪Q5 2015款 40 TFSI 技术型 ", 
    319 price: "43.16", 
    320 sellState: 0, 
    321 smallPath: "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_120x90.jpg" 
    322 },... 
    323 } 
    324 }}} 
     30==== 2.2.3 [=#point2.2.3 查询空白页] ====