Changes between Version 10 and Version 11 of pcauto_4.5.0/interface


Ignore:
Timestamp:
08/27/2014 04:25:54 PM (12 years ago)
Author:
hejingdong
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pcauto_4.5.0/interface

    v10 v11  
    1414是否需要登录:是,否 
    1515返回格式:json,ssi,xml 
    16 缓存方式:接口缓存,对象缓存 
     16缓存方式:接口缓存(接口中返回的响应头里面的 Cache-Control),对象缓存() 
    1717缓存时间:缓存时间 
    1818返回结果:结果可能情况 
     
    2727    是否需要登录:false 
    2828    返回格式:json 
    29     返缓存方式: 
    30     缓存时间: 
    31     请求参数:channelId:栏目id 
    32     说明: 
     29    缓存方式:接口缓存 
     30    缓存时间:5分钟 
     31    请求参数: 
     32channelId:栏目id 
     33    说明: 
     34    返回结果中type说明 
    3335       0其他 
    3436       1文章 
     
    111113    请求url:http://mrobot.pcauto.com.cn/v3/cms/articles/4147040?articleTemplate=4.4.0&size=18&app=pcautobrowser&picRule=2&template=(null)&channelId=4&serialId=0 
    112114    HTTP请求方式:GET 
    113     是否需要登录:false 
    114     返回格式:HTML页面 
    115     返缓存方式: 
    116     缓存时间: 
    117     请求参数: 
     115    是否需要登录:true 
     116    返回格式:HTML页面 
     117    缓存方式:接口缓存 
     118    缓存时间:60分钟 
     119    请求参数: 
     120common_session_id:登录后的session,Cookies传值 
    118121    说明:点击整块热门评论部分,都是触发评论跳转 
    119122    返回结果: 
     
    133136    是否需要登录:false 
    134137    返回格式:JSON 
    135     返缓存方式: 
    136     缓存时间: 
     138    缓存方式:接口缓存 
     139    缓存时间:30分钟 
    137140    说明: 
    138141    请求参数: 
     
    149152    HTTP请求方式:GET 
    150153    是否需要登录:false 
    151     返回格式:json 
    152     返缓存方式: 
    153     缓存时间: 
    154     请求参数: 
    155     说明: 
     154    返回格式:JSON 
     155    缓存方式:接口缓存 
     156    缓存时间:7天 
     157    请求参数: 
     158    说明: 
     159原有接口: http://mrobot.pcauto.com.cn/v2/cms/area_tree     
    156160    返回结果: 
    157161{ 
     
    161165      "name": "广东", 
    162166      "cities": [ 
    163         ["1","广州","5401","广东","广州市"], 
    164         ["4","深圳","5401","广东","深圳市"] 
     167        ["1","广州","5401","广州市"], 
     168        ["4","深圳","5401","深圳市"] 
    165169      ] 
    166170    } 
     
    175179    是否需要登录:false 
    176180    返回格式:json 
    177     返缓存方式: 
    178     缓存时间: 
    179     请求参数:: 
     181    缓存方式:接口缓存 
     182    缓存时间: 
     183    请求参数: 
    180184    说明: 
    181185    返回结果: 
     
    198202    是否需要登录:true 
    199203    返回格式:json 
    200     返缓存方式: 
    201     缓存时间: 
    202     请求参数:common_session_id: 
     204    缓存方式:接口缓存 
     205    缓存时间: 
     206    请求参数: 
     207common_session_id:登录后的session,Cookies传值 
    203208    说明: 
    204209    返回结果: 
     
    245250    是否需要登录:false 
    246251    返回格式:json 
    247     返缓存方式: 
     252    缓存方式:无 
    248253    缓存时间: 
    249254    说明:4.5版本增加一个提问帖,最多显示三张图,默认显示2条置顶帖,多出的列表隐藏起来,通过点击可以展开和收起,展开后最多只能5条。置顶帖的显示上,要和普通的帖子在样式和结构上有所不同 
     
    326331    请求url:http://mrobot.pcauto.com.cn/v2/bbs/topics/5217852?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18 
    327332    HTTP请求方式:GET 
    328     是否需要登录:false 
    329     返回格式:HTML页面 
    330     返缓存方式: 
     333    是否需要登录:true 
     334    返回格式:HTML页面 
     335    缓存方式:无 
    331336    缓存时间: 
    332337    说明:4.5版本增加删帖,加精,评分功能 
    333338    请求参数: 
     339common_session_id:登录后的session,Cookies传值 
    334340        帖子ID 
    335341        pageNo:页码 
     
    355361    是否需要登录:true 
    356362    返回格式:json 
    357     返缓存方式: 
    358     缓存时间: 
    359     说明: 
    360     请求参数: 
     363    缓存方式:无 
     364    缓存时间: 
     365    说明: 
     366    请求参数: 
     367common_session_id:登录后的session,Cookies传值 
    361368topicid:帖子id 
    362369    返回结果: 
     
    370377    是否需要登录:true 
    371378    返回格式:json 
    372     返缓存方式: 
    373     缓存时间: 
    374     说明: 
    375     请求参数: 
     379    缓存方式:无 
     380    缓存时间: 
     381    说明: 
     382    请求参数: 
     383common_session_id:登录后的session,Cookies传值 
    376384topicid:帖子id 
    377385 
     
    386394    是否需要登录:true 
    387395    返回格式:json 
    388     返缓存方式: 
    389     缓存时间: 
    390     说明: 
    391     请求参数: 
     396    缓存方式:无 
     397    缓存时间: 
     398    说明: 
     399    请求参数: 
     400common_session_id:登录后的session,Cookies传值 
    392401topicId:帖子id 
    393402score:分数 
     
    402411    是否需要登录:false 
    403412    返回格式:json 
    404     返缓存方式: 
     413    缓存方式:接口缓存 
    405414    缓存时间: 
    406415    说明: 
     
    430439    是否需要登录:false 
    431440    返回格式:JSON 
    432     返缓存方式: 
     441    缓存方式:接口缓存 
    433442    缓存时间: 
    434443    说明: 
     
    523532    是否需要登录:false 
    524533    返回格式:JSON 
    525     返缓存方式: 
    526     缓存时间: 
     534    缓存方式:接口缓存 
     535    缓存时间:1分钟 
    527536    说明:增加status,用于区分在售分类 
    528537    请求参数: 
     
    555564=== 2.4.1 [=#point2.4.1 车系综述页] === 
    556565{{{ 
    557     请求url:http://mrobot.pcauto.com.cn/v3/price/serialv40/7929?v=4.3.0 
    558     HTTP请求方式:GET 
    559     是否需要登录:false 
    560     返回格式:HTML页面 
    561     返缓存方式: 
    562     缓存时间: 
    563     说明:新增图片、点评、团购、经销商、购车计算等入口 
     566    请求url: 
     567    HTTP请求方式:GET 
     568    是否需要登录:false 
     569    返回格式:HTML页面 
     570    缓存方式:接口缓存 
     571    缓存时间:1分钟 
     572    说明: 
     573原有接口:http://mrobot.pcauto.com.cn/v3/price/serialv40/7929?v=4.3.0 
     574新增图片、点评、团购、经销商、购车计算等入口 
    564575    请求参数: 
    565576 
     
    576587=== 2.4.2 [=#point2.4.2 车系参配页] === 
    577588{{{ 
    578     请求url:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?serialId=7929&v=4.3.0 
    579     HTTP请求方式:GET 
    580     是否需要登录:false 
    581     返回格式:HTML页面 
    582     返缓存方式: 
    583     缓存时间: 
    584     说明:样式调整、滚动时增加协议 
    585     请求参数: 
    586  
    587     返回结果: 
    588 滚动到对应section时,触发协议:  pcaction://show-section/@{类型名} 
     589    请求url: 
     590    HTTP请求方式:GET 
     591    是否需要登录:false 
     592    返回格式:HTML页面 
     593    缓存方式:无 
     594    缓存时间: 
     595    说明: 
     596原有接口:http://mrobot.pcauto.com.cn/v3/price/detailComparev40?serialId=7929&v=4.3.0 
     597样式调整、滚动时增加协议 
     598    请求参数: 
     599 
     600    返回结果: 
     601滚动到对应section时,触发协议:  pcaction://show-section/${类型名} 
    589602 
    590603提供一个js函数gotoSection(index),调用后跳转到对应的锚点 
     
    603616    是否需要登录:false 
    604617    返回格式:HTML页面 
    605     返缓存方式: 
    606     缓存时间: 
     618    缓存方式:接口缓存 
     619    缓存时间:60分钟 
    607620    说明: 
    608621原有接口:http://mrobot.pcauto.com.cn/v3/price/dealersSerialv36?serialId=7889&areaId=1 
     
    619632=== 2.4.4 [=#point2.4.4 车系点评页] === 
    620633{{{ 
    621     请求url:http://mrobot.pcauto.com.cn/v3/price/commentList/7929 
    622     HTTP请求方式:GET 
    623     是否需要登录:false 
    624     返回格式:HTML页面 
    625     返缓存方式: 
    626     缓存时间: 
     634    请求url: 
     635    HTTP请求方式:GET 
     636    是否需要登录:false 
     637    返回格式:HTML页面 
     638    缓存方式:接口缓存 
     639    缓存时间:15分钟 
    627640    说明: 
    628641样式调整,区分在售、停售 
     
    640653    是否需要登录:false 
    641654    返回格式:JSON 
    642     返缓存方式: 
    643     缓存时间: 
     655    缓存方式:接口缓存 
     656    缓存时间:60分钟 
    644657    说明:types增加字段section,用于细化外观 
    645658    请求参数: 
     
    685698    是否需要登录:false 
    686699    返回格式:JSON 
    687     返缓存方式: 
    688     缓存时间: 
     700    缓存方式:接口缓存 
     701    缓存时间:60分钟 
    689702    说明: 
    690703typeId被细化,增加外观分类 
     
    715728=== 2.4.7 [=#point2.4.7 经销商(车系)详情] === 
    716729{{{ 
    717     请求url:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&seq=154070001&modelName=%E8%B5%B7%E4%BA%9AK3%202015%E6%AC%BE%201.6%20%E6%89%8B%E5%8A%A8GL&v=4.3.0&modelId2=33876&serialId=7889&dealerPrice=10.28 
    718     HTTP请求方式:GET 
    719     是否需要登录:false 
    720     返回格式:HTML页面 
    721     返缓存方式: 
    722     缓存时间: 
    723     说明:和4.4版本的经销商详情不一样:此版本经销商详情只能从车系页进入,预约试驾,询底价功能都是针对车系的 
     730    请求url: 
     731    HTTP请求方式:GET 
     732    是否需要登录:false 
     733    返回格式:HTML页面 
     734    缓存方式:接口缓存 
     735    缓存时间:60分钟 
     736    说明: 
     737原有接口:http://mrobot.pcauto.com.cn/v3/price/dealersDetailv40?areaId=1&seq=154070001&modelName=%E8%B5%B7%E4%BA%9AK3%202015%E6%AC%BE%201.6%20%E6%89%8B%E5%8A%A8GL&v=4.3.0&modelId2=33876&serialId=7889&dealerPrice=10.28 
     738和4.4版本的经销商详情不一样:此版本经销商详情只能从车系页进入,预约试驾,询底价功能都是针对车系的 
    724739    请求参数: 
    725740 
     
    736751    是否需要登录:false 
    737752    返回格式:HTML页面 
    738     返缓存方式: 
    739     缓存时间: 
     753    缓存方式:接口缓存 
     754    缓存时间:60分钟 
    740755    说明:新增 
    741756    请求参数: 
     
    745760}}} 
    746761 
    747 === 2.4.9 [=#point2.4.9 询底价页] === 
     762=== 2.4.9 [=#point2.4.9 车型询底价页] === 
    748763{{{ 
    749764    请求url:http://mrobot.pcauto.com.cn/v3/price/askprice?dealerId=49712&dealerName=%E5%B9%BF%E5%B7%9E%E6%96%87%E5%8D%8E%E7%A6%8F%E7%91%9E%E7%A6%8F%E7%89%B9+&modelId=19792&modelName=%E7%A6%8F%E5%85%8B%E6%96%AF+2012%E6%AC%BE+%E4%B8%A4%E5%8E%A2+1.6+MT+%E8%88%92%E9%80%82%E5%9E%8B&url=http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/11/c3/14373198_14373198_1349942613212_120x90.jpg 
     
    751766    是否需要登录:false 
    752767    返回格式:HTML页面 
    753     返缓存方式: 
     768    缓存方式:无 
    754769    缓存时间: 
    755770    说明: 
     
    771786    是否需要登录:false 
    772787    返回格式:HTML页面 
    773     返缓存方式: 
     788    缓存方式:无 
    774789    缓存时间: 
    775790    说明: 
     
    782797阅读模式:无参数 白天;night 晚间 
    783798    返回结果: 
    784  
     799点击车型选择协议:  pcaction://choose-car/{"cars":["id":1,"name":"车型名字"]} 
     800点击地址选择协议:  pcaction://location/ 
    785801}}} 
    786802 
     
    791807    是否需要登录:false 
    792808    返回格式:JSON 
    793     返缓存方式: 
     809    缓存方式:无 
    794810    缓存时间: 
    795811    说明: 
     
    834850    是否需要登录:false 
    835851    返回格式:JSON 
    836     返缓存方式: 
    837     缓存时间: 
     852    缓存方式:对象缓存 
     853    缓存时间:5分钟 
    838854    说明: 
    839855    请求参数: 
     
    849865    请求url:http://my.pcauto.com.cn/intf/syncNickName.jsp 
    850866    HTTP请求方式:POST 
    851     是否需要登录:false 
    852     返回格式:JSON 
    853     返缓存方式: 
     867    是否需要登录:true 
     868    返回格式:JSON 
     869    缓存方式:无 
    854870    缓存时间: 
    855871    说明:增加参数,可修改性别 
     
    859875nickName:昵称 
    860876act:save 
    861 sex: 
     877sex:性别 
     878common_session_id:登录后的session,Cookies传值 
    862879    返回结果: 
    863880{"code":0}表示成功, {"code":非0,"message":"提示"} 
     
    871888    是否需要登录:false 
    872889    返回格式:HTML页面 
    873     返缓存方式: 
     890    缓存方式:无 
    874891    缓存时间: 
    875892    说明: 
     
    887904    是否需要登录:false 
    888905    返回格式:HTML页面 
    889     返缓存方式: 
    890     缓存时间: 
     906    缓存方式:接口缓存 
     907    缓存时间:60分钟 
    891908    说明: 
    892909    请求参数: 
     
    905922    是否需要登录:false 
    906923    返回格式:HTML页面 
    907     返缓存方式: 
    908     缓存时间: 
     924    缓存方式:接口缓存 
     925    缓存时间:60分钟 
    909926    说明: 
    910927    请求参数: 
     
    919936    请求url:http://my.pcauto.com.cn/intf/app/focus.jsp?accountId=31836836&act=findFocus&common_session_id=6E2073035FC49C29DD038821CAF2058F93196617DE299753&resp_enc=UTF-8&pageNo=1&pageSize=20&req_enc=UTF-8 
    920937    HTTP请求方式:GET 
    921     是否需要登录:false 
    922     返回格式:JSON 
    923     返缓存方式: 
     938    是否需要登录:true 
     939    返回格式:JSON 
     940    缓存方式:无 
    924941    缓存时间: 
    925942    说明:增加相互关注标示,共同关注标示 
     
    932949req_enc:UTF-8 
    933950resp_enc:UTF-8 
     951common_session_id:登录后的session,Cookies传值 
    934952    返回结果: 
    935953{ 
     
    956974    请求url: 
    957975    HTTP请求方式:GET 
    958     是否需要登录:false 
    959     返回格式:JSON 
    960     返缓存方式: 
     976    是否需要登录:true 
     977    返回格式:JSON 
     978    缓存方式:无 
    961979    缓存时间: 
    962980    说明: 
    963981    请求参数: 
    964982dealerid:经销商id 
     983common_session_id:登录后的session,Cookies传值 
    965984    返回结果: 
    966985 
     
    973992    是否需要登录:true 
    974993    返回格式:JSON 
    975     返缓存方式: 
     994    缓存方式:无 
    976995    缓存时间: 
    977996    说明: 
    978997    请求参数: 
    979998dealerid:经销商id 
     999common_session_id:登录后的session,Cookies传值 
    9801000    返回结果: 
    9811001 
     
    9891009    是否需要登录:true 
    9901010    返回格式:JSON 
    991     返缓存方式: 
     1011    缓存方式:无 
    9921012    缓存时间: 
    9931013    说明: 
    9941014    请求参数: 
    9951015dealerid:经销商id 
     1016common_session_id:登录后的session,Cookies传值 
    9961017    返回结果: 
    9971018 
     
    10051026    是否需要登录:false 
    10061027    返回格式:JSON 
    1007     返缓存方式: 
    1008     缓存时间: 
     1028    缓存方式:接口缓存 
     1029    缓存时间:60分钟 
    10091030    说明: 
    10101031原有接口: http://mrobot.pcauto.com.cn/v3/price/promotionList?areaId=1&pageNo=1&pageSize=20&orderBy=popularity