[[TOC]] =报价1.4.0接口文档 = >mrobot代理环境说明: 192.168.10.198 端口为 1080 连的是QA测试环境(192.168.74.80)[[BR]] 192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)[[BR]] '''ps:对于mrobot.pcauto.com.cn/x/前缀的接口,mrobot仅作代理,没有任何逻辑处理。''' [[BR]] ---------- === 1.1首页焦点图 === >mrobot地址:[[BR]] **说明** > 首页banner接口 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >CMS **参数** **返回** {{{#!java { "status": 0, "message": "操作成功", "datas": [ { "title": "详情页标题", "id": "指定详情页id", "type": 类型, "img": "图片地址", "url": "指定详情页URL" }, ], "hotdatas": [ { "品牌id" "品牌名称": "品牌图片地址": }, ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=|| ||= status =||= 接口返回状态码:0成功,非0异常 =||= message =||=接口返回描述信息=|| ||= id =||= 指定详情页id =||= type =||= 跳转类型: =||= title =||= 标题 =|| ---------- === 1.2销量排行榜 === >mrobot地址:[[BR]] 应用后端url:http://price.pcauto.com.cn/top/sales/s2-t73.html (获取销量排行榜) **说明** > **缓存时间** >0 **提交方式** > GET **是否登录** > 登录与未登录都可请求 **数据来源** >论坛 **参数** 具体传参由后端制定,车系级别对应id由后端给到,拿到的数据由mrobot过滤。另最低价字段需要再单独请求处理 **返回** { "isNew": "0", "photo": "http://img0.pcauto.com.cn/pcauto/price/000075962/000076002/1502/40067270_40067270_1414118778618_270x202.jpg", "price": “最低价”//此处不改,mrobot增加一个字段取字低值,为以上一个版本相兼容 "sellStatus": "3", "serialGroupId": "100", "serialGroupName": "新桑塔纳" “销售数量”:”123412” }, ---------- === 1.3 搜索 === >mrobot地址:[[BR]] 后端Url:http://ks.pcauto.com.cn/searchSuggest2.shtml?q=%E7%A7%91&app=composite [[BR]] **说明** > 搜索车系接口 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >mrobot后台 **参数** 搜索关键字:keyword **返回** { "status": 0, "message": "操作成功", "datas": [ { "车系id" "车系名称": "车系图片地址": “车系类型” “车系价格区间” }, ] } ---------- === 1.4 团购详情页 === >mrobot地址:http://mrobot.pcauto.com.cn/buy/price/activityDetailv11/%s[[BR]] **说明** > 团购详情页接口 mrobot确认后端接口是否有返回团购状态标志位,如果没有,通知后端 **缓存时间** >0 **提交方式** > GET **是否登录** > 否 **数据来源** >mrobot后台 **参数** 团购详情id,拼接在url后面 返回: HTML ---------- === 1.5 车系综述页接口 === ** (mrobot开发已完成,请连开发机进行测试) ** >http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/serial.xsp?v=1.1.0&areaId=3&isSubscribed=0&serialId=4313&modelIds= [[BR]] **后端接口** {{{ http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=4313 //车系概述基本数据 http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313 //车系概述最低价接口 http://price.pcauto.com.cn/interface/iphone/serial_group_compete.jsp?serialGroupId=4313&size=3 //车系对比 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=3&serialId=4313 //判断是否有团购 http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId4313&rId=3 //车系概述列表接口 http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?rid=3&sid=4313) //获取本地最低价 http://price.pcauto.com.cn/interface/cms/region_400_json.jsp?rid=3) //获取400电话 http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp?vs=1.3&areaId=1&isSubscribed=1&modelId=33393 //通过modelId去取对应的经销商的列表及基础数据 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式: html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||int||Y||地区ID|| ||serialId||int||Y||车系id|| ||isSubscribed||int||N||是否订阅|| ||modelId||int||N||车型ID|| 页面内数据说明:在返回的页面里添加了注释数据/*@_HTML_META_START_(数据部分)_HTML_META_END_@*/ 数据内容为: {{{#!java { "kind": "中型车", "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_400x300.jpg", "priceRange": "27.28~57.81万", "cars": [{ "title": " 1.8T 涡轮增压 160马力", "data": [{ "id": "33318", "title": "2015款 1.8 30TFSI 手动舒适型", "price": "27.28", "config": "6挡手动 前置前驱 ", "state": "在售", "status": "在售", "isNews": "0", "rjBzzw": 5, "introduce": 0, "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1409/17/c6/38686815_38686815_1410941571968_120x90.jpg", "minPrice": "23.77", "paiLiang": "1.8", "jqx": 950, "glassPercent": 0.0019, "compared": "", "result": { "shoufu": 7.13, "loan": 170000, "monthPay": 0.52, "firstPayTotal": 9.87, "loantotal": 28.7, "total": 26.87 } }] }, { "title": " 2.0T 涡轮增压 224马力", "data": [{ "id": "33319", "title": "2015款 2.0 45TFSI quattro个性运动版", "price": "35.3", "config": "7挡双离合 前置四驱 托森式差速", "state": "在售", "status": "在售", "isNews": "0", "rjBzzw": 5, "introduce": 0, "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/22/c6/39977239_39977239_1413950602832_120x90.jpg", "minPrice": "31.42", "paiLiang": "2.0", "jqx": 950, "glassPercent": 0.0019, "compared": "", "result": { "shoufu": 9.43, "loan": 220000, "monthPay": 0.68, "firstPayTotal": 13.41, "loantotal": 37.77, "total": 35.41 } } ] }] } }}} {{{#!java 协议说明: 订阅: pcautobuy://addSubscribed/?serialId={{serialId}}&serialName={{serialName}} 取消订阅:pcautobuy://deleteSubscribed/?serialId={{serialId}}&serialName={{serialGroupName}} 对比:pcaction://compare/?modelId={{id}}&modelName={{title}}&image={{photo}} 取消对比:pcaction://decompare/?modelId={{id}}&modelName={{title}}&image={{photo}} 去团购:pcautobuy://model-activity-detail/?activityId={{activityId}}&areaId={{areaId}} 求组团:pcautobuy://serial-activity-initiate/?serialId={{serialId}}&serialName={{serialGroupName}} 询底价:pcautobuy://auto-ask-price/?areaId={{areaId}}&dealerId=0&serialId={{serialId}}&modelId={{modelId}}&modelName={{modelName}}&image={{image}}&isMain=1 去购车计算:pcautobuy://auto-calculator/{{id}}?modelName={{title}}&price={{minPrice}}&paiLiang={{paiLiang}}&rjBzzw={{rjBzzw}}&introduce={{introduce}} 400电话咨询:pcaction://webview_tel/{{phone}}?name={{name}} 我要优惠:pcautobuy://auto-get-promotion/?areaId={{param.areaId}}&dealerId={{dealerId}}&serialId={{../serialId}}&modelId={{../id}}&modelName={{../title}}&image={{../photo}}&isMain=1 点击车型跳转:pcautobuy://model/?modelId={{id}}&modelName={{title}}&areaId={{areaId}} 优惠详情页:pcautobuy://get-promotionDetail/{{newsId}}?areaId={{../areaId}}&modelId={{../id}} newsId指优惠活动id 购车优惠:pcaction://click-discount }}} ---------- == 1.6车型综述== >http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/model.xsp?modelId=3462&v=1.1.0&areaId=2&isCompared=0&isSubscribed=0 **后端接口** {{{ http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid=34626 车型基本信息 http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34626 参数信息 http://price.pcauto.com.cn/interface/iphone/atom/price/model_calculator_basic_json.jsp?mIds=34626 基础数据如排量等 http://price.pcauto.com.cn/interface/iphone/dealer_page_list_json.jsp?modelId="+modelId+"&rId="+areaId+"&pageNo=1&pageSize=1000 经销商信息 http://price.pcauto.com.cn/interface/iphone/get_lower_modelPrice.jsp?mid=" + modelId + "&rid=" + areaId 车型本地最低价 http://mall.pcauto.com.cn/autoMall/interface/auto_mall_gct_list_by_sg_json.jsp?regionId=1&serialId=4313车系下是否有团购信息 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||areaId||int||N||地区ID|| ||modelId||int||N||车型ID|| ||v||string||N||版本号|| ||isCompared||int||N||是否已比较|| ||isSubscribed||int||N||是否已订阅|| === 1.7 经销商优惠详情 === [[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?marketId=7033340&modelId=33314}}} [[BR]]现应用接口: {{{ http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_info_json.jsp?marketId={marketId}+&modelId={modelId}//优惠基础数据 http://price.pcauto.com.cn/interface/iphone/atom/dealer/dealer_market_model_json.jsp?marketId={marketId}//得到该优惠相关的车型车系 }}} [[BR]]HTTP请求方式:get [[BR]]是否需要登录:false [[BR]]返回格式:html [[BR]]缓存方式: [[BR]]缓存时间:60 [[BR]]说明: [[BR]]请求参数:[[BR]] ||参数名||类型||必须||说明|| ||modelId||int||N||车型ID|| ||marketId||int||Y||优惠ID|| === 1.8 经销商报价详情 === Mrobot后续再制定方案