[[TOC]]
= 报价宝典SDK接口 =


== 1.基本约定 ==
{{{
接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况
}}}

[[BR]]代理环境说明：
[[BR]]192.168.10.198 端口为 1080    连的是v36的测试环境（192.168.74.36）
[[BR]]192.168.10.199 端口为 1080    连的是dev40的开发环境（192.168.75.40）

=== 1.1 [=#point1.1 车系综述] ===
'''(旧接口)'''

[[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/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?pageNo=1&pageSize=20&areaId=1  //

}}}
[BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/serial/4313?v=1.1.0&areaId=3&isSubscribed=0&modelIds=；}}}
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:html
[[BR]]缓存方式:
[[BR]]缓存时间:60
[[BR]]说明:
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||areaId||int||Y||地区ID||
||serialId||int||Y||车系id||
||isSubscribed||int||N||是否订阅||
||modelIds||String||N||车型ID||
||pageNo||int||N||当前页||
||pageSize||int||N||当前页条数||
页面内数据说明：在返回的页面里添加了注释数据/*@_HTML_META_START_（数据部分）_HTML_META_END_@*/ 
数据内容为： 
{{{
{
	"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
			}
		},
		......
		}]
	}]
}
}}}

=== 1.2 [=#point1.2 车型综述] ===
'''(旧接口)'''

[[BR]]mrobot请求url:{{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/model.xsp?modelId=30499&v=1.1.0&areaId=1&isCompared=0&isSubscribed=0}}}

[[BR]]现应用接口：
{{{
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车系下是否有团购信息
http://price.pcauto.com.cn/dealer/interface/app/market_groupby_model_json.jsp?pageNo=1&pageSize=20&areaId=1  //
}}}
[BR]原mrobot接口：{{{http://mrobot.pcauto.com.cn/buy/price/model/34626?pageSize=20&pageNo=1;}}}
[[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||是否已订阅||
||pageNo||int||N||当前页||
||pageSize||int||N||当前页条数||

=== 1.3[=#point1.3 优惠详情] ===
'''(学车2.0测试)'''
[[BR]]mrobot请求url:{{http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/promotionDetail.xsp?marketId=8408506&areaId=2&modelId=38323}}}
[[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.4[=#point1.4 车系列表] ===
'''(学车2.0测试)'''
** (mrobot开发已完成，请连开发机进行测试) **
>http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/getSerialListByBrandId.xsp?brandId=1&type=1 [[BR]]
**后端接口**

>http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?vs=1.3&bid=1&type=1 车系列表数据 [[BR]]
>http://price.pcauto.com.cn/interface/iphone/atom/price/hot_model_list_json.jsp?vs=1.3&brandId=1 本地热门车型最低价
**说明**

>本地热门车型最低价新加的接口,serials字段下count=0表该车系下无车型，若没有mId则表示没有该热门车型，此时我要询价不可选。

**提交方式**

> GET

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||
||brandId||品牌||int|| 1||是||
||typeId||类型Id||int||1||是||

**返回**

{{{#!java
  {
   "manufacturers":[{
        "brandName": "奥迪",
        "name": "测试的",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": []
    },
    {
        "brandName": "奥迪",
        "name": "一汽奥迪",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": [
            {
                "id": 3524,
                "name": "奥迪A4L",
                "kind": "中型车",
                "priceRange": "27.28~57.81 万",
                "isNew": 0,
                "sellStatus": 3,
                "carVersion": 1,
                "carField": 4,
                "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_180x135.jpg",
                "count": 43，
                "mId": 30822,
                "mName":"车型名称",
                "mPhoto":"车型图片"
            } .....
   ]
   } 

}}}