[[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.首页焦点图/品牌数据接口 ===
>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/homeData.xsp?rid=1 [[BR]]


**说明**

> 返回首页焦点图/热门品牌数据

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>CMS：http://www.pcauto.com.cn/client/000089086/1512/intf8251.js

**请求参数**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= rid =||= 区域id =||=  =||= =||
**返回**

{{{#!java
{
    "state": 0,
    "message": "成功",
    "banner": [
        {
            "title": "广州专享，买车就送大礼，厚惠无期",
            "link": "http://app.pcauto.com.cn/bjkclient/",
            "picUrl": "http://img0.pcautost3.png",
            "type": "1"
        }
    ],
    "brand": [1,2,3]
}
}}}
**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含义=||
||= status =||= 接口返回状态码：0成功，非0异常 =||= message =||=接口返回描述信息=||
||= id =||= 指定详情页id =||= type =||= 跳转类型：1专题、2优惠tab列表、3优惠指定详情、4团购列表、5团购指定详情 =||
||= bid =||= 品牌id =||= link =||=链接地址=||
||= picUrl =||= 图片地址 =||= title =||= 标题 =||

----------

=== 1.2销量排行榜 ===
** (mrobot开发已完成，请连开发机进行测试) **

>mrobot地址：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/hotSellSerials.xsp?year=2015&month=1&type=73 [[BR]]
应用后端url：http://price.pcauto.com.cn/top/sales/s2-t73.html  (获取销量排行榜)
             
**说明**

> 

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 登录与未登录都可请求

**数据来源**

>论坛

**参数**
具体传参由后端制定，车系级别对应id由后端给到，拿到的数据由mrobot过滤。另最低价字段需要再单独请求处理
||= 参数名 =||= 参数含义 =||类型||是否必须|| 默认值||
||type||类别||int||是||73:紧凑车型,1:SUV,72:中型车,110:小型车,76:微型车||
||pageNo||第几页||int||是||1||
||pageSize||显示条数||int||是||20||
||year||年||int||否||无（year必须与month同步）||
||month||月||int||否||无（eg:09,12,01)||

**返回**
{{{
{
    "title": "SUV",
    "serials": [
        {
            "total": 10229, //销售数量 
            "smallPhoto": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326_400x300.jpg",//小图
            "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326.jpg",//大图
            "brandId": 949,//品牌id
            "brandName": "东风风行",//品牌名称 
            "price": "-",//最低价格，无最低价格时用-表示
            "photo_350x260": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1305/23/c7/21219427_1369289985326_350x260.jpg",//与原接口的photo字段尺寸一致
            "serialGroupId": 7682,//车系id
            "serialGroupName": "景逸SUV" //车系名称
        }
}
}}}

----------

=== 1.3 搜索 ===
>mrobot地址：[[BR]]
Url：http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.4/search.xsp?q=奔 [[BR]]

后端Url：http://ks.pcauto.com.cn/searchSuggest2.shtml?q=%E7%A7%91&app=composite&addSFields=kind_name,photo [[BR]]

**说明**
车系搜索接口，仅搜索车系,过滤品牌搜索

> 搜索车系接口

**缓存时间**

>0

**提交方式**

> GET

**是否登录**

> 否

**数据来源**

>mrobot后台

**参数**
||= 参数名 =||= 参数含义 =||类型||是否必须|| 默认值||
||= q =||= 搜索关键字 =|| string || 是 || 无 ||


**返回**
{{{#!java
{
    "status": "0",
    "message": "操作成功",
    "datas": [
        {
            "serialId": "3195",
            "name": "天籁",
            "photo": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1505/28/c20/7570720_7570720_1432795429921.JPG",
            "kind": "中型车",
            "price": "17.78-29.98万"
        },
   ]
}
}}}
[[BR]]
**返回参数说明**
||= 参数名 =||= 参数含义 =||类型||是否必须|| 说明||
||= status =||= 状态码 =|| string || 是 || 0->成功 ||
||= message =||= 提示信息 =|| string || 是 || 失败返回失败信息 ||
||= serialId =||= 车系id =|| int || 是 || 无 ||
||= name =||= 车系名称 =|| string || 是 || 无 ||
||= photo =||= 车系图片url =|| string || 是 || 无 ||
||= kind =||= 车系类型 =|| string || 是 || 无 ||
||= price =||= 车系价格 =|| string || 是 || 无 ||
----------

=== 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||是否已订阅||
[[BR]]
***部分返回数据***
{{{#!java
{
    "bbsId": "16300",
    "brand": "雪佛兰",
    "brandId": "225",
    "gfPrice": "8.99万",
    "kind": "紧凑型车",
    "manufacturer": "上汽通用雪佛兰",
    "minPrice": "7.69万起",
    "modelName": "科鲁兹 2015款 1.5L 经典 SL MT ",
    "price": "8.99",
    "productYear": "2014-09",
    "serialGorup": "科鲁兹",
    "serialGorupId": 3544,
    "serialGroup": "科鲁兹",
    "serialId": "3544",
    "shortName": "1.5L 经典 SL MT",
    "state": "在售",
    "url_120x90": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_120x90.jpg",
    "url_400x300": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_400x300.jpg",
    "baseParameter": [
        "厂商",
        "上汽通用雪佛兰",
        "级别",
        "紧凑型车",
        "上市时间",
        "2014-09",
        "发动机",
        "1.5L L4",
        "进气形式",
        "自然吸气",
        "最大马力(PS)",
        "113",
        "最大扭矩(N·m)",
        "141",
        "变速箱",
        "5挡手动",
        "车身结构",
        "4门5座三厢车",
        "长×宽×高(mm)",
        "4643×1797×1477",
        "轴距(mm)",
        "2685",
        "最高车速(km/h)",
        "178",
        "官方0-100km/h加速(s)",
        "13.2",
        "实测0-100km/h加速(s)",
        "-",
        "实测100-0km/h制动(m)",
        "-",
        "工信部综合油耗(L/100km)",
        "6.6",
        "整车质保",
        "三年或10万公里"
],
    "detail": [
{
            "groupName": "车身",
            "groupDetail": [
                "车身结构",
                "三厢车",
                "长度(mm)",
                "4643",
                "宽度(mm)",
                "1797",
                "高度(mm)",
                "1477",
                "轴距(mm)",
                "2685",
                "前轮距(mm)",
                "1544",
                "后轮距(mm)",
                "1565",
                "最小离地间隙(mm)",
                "-",
                "车重(kg)",
                "1320",
                "车门数(个)",
                "4",
                "座位数(个)",
                "5",
                "油箱容积(L)",
                "54",
                "行李厢容积(L)",
                "461",
                "行李厢最大容积(L)",
                "-",
                "货箱尺寸(mm)",
                "-",
                "最大载重质量(kg)",
                "-"
            ]
        },],
    "logo": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_400x300.jpg",
    "logo2": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/24/c0/1054735_1054735_1419403643424_120x90.jpg",
    "photoTotal": "186",
    "dealers": [默认排序:
 {
            "phone": "400-611-6910,283",
            "poc400Phone": "4006116910-283",
            "areaId": "26",
            "city": "广东 广州",
            "mapY": "22.987959",
            "id": 42300,
            "mapX": "113.362339",
            "vip": 2,
            "modelType": "1",
            "isMarketPrice": 1,
            "lowerPrice": "0.0",
            "dealerMapId": 67342,
            "dealerNewsId": 11280906,
            "isShow24Icon": 1,
            "dealerName": "广州迅锐汽车销售服务有限公司",
            "discountPrice": "7.79",
            "aq": "4S店",
            "dealerShortName": "广州迅锐",
            "price": "8.99",
            "priceRange": "暂无报价",
            "areaName": "番禺区",
            "address": "广州市番禺区迎宾大道冼立交南300米（瑞华汽车城）",
            "nameListRange": 0,
            "is400Phone": 1,
            "disPriceRange": "",
            "highPrice": "0.0",
            "qbPrice": 7.97,
            "modelDiscount": "1.20",
            "minPrice": "7.79",
            "shouFu": 2.34,
            "total": 9.09,
            "monthPay": 0.15
        },
],
    "dealers2": [价格最低排序(同默认排序)],
    "nativeMinPrice": "7.69万起",
    "param": {
        "modelId": "34616",
        "v": "1.1.0",
        "areaId": "1",
        "isCompared": "0",
        "isSubscribed": "1",
        "fmt": "json",
        "activityId": 0,
        "paiLiang": 1485,
        "jrjBzzw": "5",
        "introduce": 0,
        "serialId": "3544",
        "pageName": "models"
    }
}
}}}

=== 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后续再制定方案