报价宝典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),对象缓存() 缓存时间:缓存时间 返回结果:结果可能情况
代理环境说明:
192.168.10.198 端口为 1080 连的是v36的测试环境(192.168.74.36)
192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)
1.1 车系综述
(旧接口)
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=
现应用接口:
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=;
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| 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 车型综述
(旧接口)
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
现应用接口:
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;
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| 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优惠详情
(学车2.0测试)
mrobot请求url:{{ http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/promotionDetail.xsp?marketId=8408506&areaId=2&modelId=38323}}}
现应用接口:
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}//得到该优惠相关的车型车系
HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:
| 参数名 | 类型 | 必须 | 说明 |
| modelId | int | N | 车型ID |
| marketId | int | Y | 优惠ID |
1.4车系列表
(学车2.0测试) (mrobot开发已完成,请连开发机进行测试)
后端接口
http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?vs=1.3&bid=1&type=1 车系列表数据
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 | 是 |
返回
{
"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":"车型图片"
} .....
]
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)