Changes between Version 42 and Version 43 of pcauto_4.8.2/interface


Ignore:
Timestamp:
01/06/2016 03:09:36 PM (10 years ago)
Author:
lanzhenhua
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_4.8.2/interface

    v42 v43  
    351351||= =||=  =|| 
    352352 
    353 === 1.5首页列表接口 === 
    354 '''(mrobot已完成,请连开发机进行测试)'''[[BR]] 
    355 >mrobot地址:http://mrobot.pcauto.com.cn/v2/cms/channels/{id}?pageNo=1&pageSize=20&v=4.0.0 [[BR]] 
    356 例如:http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&v=4.0.0 [[BR]] 
    357 cmt开发环境:http://test2.pcauto.com.cn:8002/app/json/ [[BR]] 
    358 cmt线上环境:http://www.pcauto.com.cn/app/21json [[BR]] 
    359  
    360 **说明** 
    361  
    362 > 此接口为资讯客户端15个栏目集合,涉及参数以及各种情景太多,实在不能穷举,以下只列出新增内容。[[BR]] 
    363 > '''对于客户端逻辑,此版本需要注意:1.增加新版视频类型返回:type=9;2.版本号要改为v=4.8.2'''[[BR]] 
    364  
    365 **缓存时间** 
    366  
    367 >首页列表5分钟,其余栏目30分钟 
    368  
    369 **提交方式** 
    370  
    371 > GET 
    372  
    373 **是否登录** 
    374  
    375 > 否 
    376  
    377 **数据来源** 
    378  
    379 > cms、快搜、cmt、直播后台等等 
    380  
    381 **参数** 
    382  
    383 此版本对传入参数只做一个修改'''v=4.8.2'''。[[BR]]  
    384 **返回** 
    385 {{{#!java 
    386 { 
    387     "data": [ 
    388         { 
    389             "articleType": "y", 
    390             "channelId": 1, 
    391             "channelName": "头条", 
    392             "count": 0, 
    393             "downs": 0, 
    394             "id": "6929470", 
    395             "image": "http://img0.pcauto.com.cn/pcauto/1509/14/g_6959543_1442223329657_240x160.jpg", 
    396             "pageNo": 3, 
    397             "pubDate": "2013-01-01", 
    398             "title": "测试旧文章", 
    399             "type": 1, 
    400             "ups": 0, 
    401             "url": "http://www.pcauto.com.cn/teach/692/6929470_2.html" 
    402         } 
    403     ], 
    404     "focus": [  
    405         { 
    406             "articleType": "n", 
    407             "id": "1623455", 
    408             "image": "http://img0.pcauto.com.cn/pcauto/app/daogou/1108/201108311.jpg", 
    409             "pubDate": "2011-08-31", 
    410             "title": "哈弗H6挑战比亚迪S6/瑞虎/海马骑士", 
    411             "topicUrl": "http://www.pcauto.com.cn/teach/1108/1622411.html", 
    412             "url": "http://www.pcauto.com.cn/app/daogou/1108/1623455.html" 
    413         } 
    414     ], 
    415     "pageNo": 1, 
    416     "pageSize": 1, 
    417     "topData": [ 
    418         { 
    419             "cc-uri": "http://count.imofan.com/count?url=http://www.pcauto.com.cn/nation/669/6690671.html&ad=132", 
    420             "channelId": 0, 
    421             "channelName": "", 
    422             "count": 0, 
    423             "downs": 0, 
    424             "id": "161", 
    425             "image": "http://img0.pcauto.com.cn/pcauto/1503/15/6055040_567.jpg", 
    426             "isExtend": "0", 
    427             "preView": "央视3·15晚会正在直播 消费在阳光下", 
    428             "pubDate": "2015-03-15", 
    429             "seq": 1, 
    430             "title": "央视3·15晚会直播回顾 消费在阳光下", 
    431             "to-uri": "pcautobrowser://information-article/161?template=live", 
    432             "type": 4, 
    433             "updateAt": 1436284800000, 
    434             "ups": 0 
    435         } 
    436     ], 
    437     "topFocus": [ 
    438         { 
    439             "image": "http://www1.pcauto.com.cn/test/qwegf3wrefgvazv.jpg", 
    440             "seq": 1, 
    441             "title": "驾名爵锐腾1.5T四驱豪华版", 
    442             "to-uri": "http://m.pcauto.com.cn/x/guangzhou/?type=zt&FromApp=1&browser=commonwebview&v=4.5.0", 
    443             "updateAt": 1437408000000 
    444         } 
    445     ], 
    446     "total": 150 
    447 } 
    448 }}} 
    449  
    450  
    451 **返回参数说明** 
    452 [[BR]] 在data与focus数组内的每一个JSONOject中type=9表示新版视频[[BR]] 
    453 ||= 参数名 =||= 参数含义 =|| 
    454 ||= type =||= 1文章,2帖子,3图集,4直播,5专题,6活动,7新专题,9视频,0其他 =|| 
    455 ||= to-uri =||= 论坛版块pcautobrowser://bbs-topics/,图库图片pcautobrowser://album-photo/,车系界面pcautobrowser://serial/,车型界面pcautobrowser://model/ =|| 
    456 ||= pageNo =||= 当type等于1(文章)时,假如有返回pageNo,要跳转到文章相应的pageNo页 =|| 
    457 ||= articleType =||= 值为y表示旧文章 =|| 
    458353 
    459354== 2.找车 == 
    460355=== 2.1预约试驾 === 
    461 '''(开发已完成,调试请连开发机代理)'''[[BR]] 
    462 {{{ 
    463     (开发环境) 
    464     请求url:http://mrobot.pcauto.com.cn/v3/price/testdriverv45/?serialId=8670&modelId=32059&modelName=%E5%A5%A5%E8%BF%AAQ3%202015%E6%AC%BE%2030%20TFSI%20%E6%A0%87%E5%87%86%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/12/c12/28562173_1384235641812_120x90.jpg&appKey=b5d3828499d0590300000003&chId=app_store&devId=cdef0dde8e82323c2a0df5bad5bce8646971f0f5 
    465     HTTP请求方式:GET 
    466     是否需要登录:false 
    467     返回格式:HTML页面 
    468     缓存方式:无 
    469     缓存时间: 
    470     说明: 
    471     请求参数: 
    472 serialId:车系id 
    473 modelId:车型id 
    474 modelName:车型名称 
    475 url:车型图片链接 
    476 dealerId:经销商id(如有指定经销商,则客户端不需要调用getDealers,如无指定经销商即没传此参数,则调用getDealers以显示经销商列表) 
    477 阅读模式:无参数 白天;night 晚间 
    478     返回结果: 
    479 点击车型选择协议:  pcaction://choose-car/json={"cars":[{"id":1, name:"车型名字"}]} 
    480 点击地址选择协议:  pcaction://location/ 
    481  
    482 定义三个js函数: 
    483 setlocation(regionId,regionName) ;调用效果:设置地址,regionId(城市id),regionName(城市名称) 
    484 setCar(modelId,modelName,url);调用效果:设置车型,modelId(车型id),modelName(车型名称),url(车型图片地址) 
    485 getDealers(regionId,serialId);调用效果:获取生成可选经销商,regionId(城市id),serialId(车系id) 
    486  
    487 在HTML源码里,加入(指定经销商)在售可选车型数据 
     356'''(mrobot已完成,请连开发机进行测试)'''[[BR]] 
     357>mrobot地址::http://mrobot.pcauto.com.cn/v3/price/testdriverv45/?serialId=8670&modelId=32059&modelName=%E5%A5%A5%E8%BF%AAQ3%202015%E6%AC%BE%2030%20TFSI%20%E6%A0%87%E5%87%86%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1311/12/c12/28562173_1384235641812_120x90.jpg&appKey=b5d3828499d0590300000003&chId=app_store&devId=cdef0dde8e82323c2a0df5bad5bce8646971f0f5 
     358**说明** 
     359 
     360> 获取某个话题评论列表[[BR]] 
     361 
     362**缓存时间** 
     363 
     364>无 
     365 
     366**提交方式** 
     367 
     368> GET 
     369 
     370**是否登录** 
     371 
     372> 否 
     373 
     374**数据来源** 
     375 
     376> cmt 
     377 
     378**参数** 
     379||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
     380||=serialId =||= 车型ID =||int||= 1 =||= 是 =||=  =|| 
     381||=modelId=||= 车型ID =||int||= 20 =||= 否 =||=  =|| 
     382||=modelName =||=车型名称=||= string =||=  =||= 否 =||= =|| 
     383||=url||=车型图片链接=||= string =||=  =||= 否 =||=  =|| 
     384||=dealerId=||=经销商id=||= int =||=  =||= 否 =||=  =|| 
     385 
     386[[BR]]dealerId:经销商id(如有指定经销商,则客户端不需要调用getDealers,如无指定经销商即没传此参数,则调用getDealers以显示经销商列表) 
     387[[BR]]阅读模式:无参数 白天;night 晚间 
     388[[BR]]点击车型选择协议:  pcaction://choose-car/json={"cars":[{"id":1, name:"车型名字"}]} 
     389[[BR]]点击地址选择协议:  pcaction://location/ 
     390[[BR]]返回结果:HTML 
     391 
     392[[BR]]定义三个js函数: 
     393[[BR]]setlocation(regionId,regionName) ;调用效果:设置地址,regionId(城市id),regionName(城市名称) 
     394[[BR]]setCar(modelId,modelName,url);调用效果:设置车型,modelId(车型id),modelName(车型名称),url(车型图片地址) 
     395[[BR]]getDealers(regionId,serialId);调用效果:获取生成可选经销商,regionId(城市id),serialId(车系id) 
     396[[BR]]在HTML源码里,加入(指定经销商)在售可选车型数据 
    488397    /*@_HTML_META_START_ 
    489398{cars:[{title: " 1.4L 90马力",data: 
     
    492401  _HTML_META_END_@*/ 
    493402 
    494 }}} 
    495403=== 2.2车型页=== 
    496404>mrobot地址:http://mrobot.pcauto.com.cn/xsp/s/auto/info/v4.8/models.xsp?mid=41610&areaId=1&hasDealers=1 [[BR]]