wiki:pcauto_BuyAuto_1.2.0

Version 9 (modified by liangzhicong, 11 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 2.接口列表
    1. 2.1 车系参配
    2. 2.2 车型参配
    3. 2.3 车型对比
    4. 2.4 我要优惠
    5. 2.5 优惠详情
    6. 2.6 车型列表

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），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况

2.接口列表

2.1 车系参配


mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/serialDetail.xsp?serialId=4313&subscributedIds=30499,36337
现应用接口： 

http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=4313 车系概览页车型列表接口
http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_overview.jsp?mid=30499 车型概览接口
http://dev3.pcauto.com.cn:8001/interface/iphone/atom/price/model_params.jsp?mid=30499 车型参数接口
http://dev3.pcauto.com.cn:8001/dealer/interface/order/order_info.jsp?m=getMCountBySG&sgId=4313 订单数


原接口： 

http://price.pcauto.com.cn/interface/iphone/model_list_v3.jsp?serialId=4313


HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:

参数名类型必须说明
serialIdStringY车系ID
subscributedIdsStringN已订阅的车型id


返回结果: {

"detailArray": [

{

"detail": [

{

"groupDetail": [

"全国4S店", "2368笔"

], "groupName": "询价订单"

}, {

"groupDetail": [

"前制动器类型", "通风盘式", "后制动器类型", "通风盘式", "驻车制动类型", "电子驻车", "前轮胎规格", "245/45 R18 ", "后轮胎规格", "245/45 R18 ", "备胎规格", "非全尺寸"

], "groupName": "车轮制动"

}... }

], "groupNameArray": [

"询价订单", "价格", "基本参数", "车身", "发动机", "电动机",

.....

]

}

2.2 车型参配


mrobot请求url:http://mrobot.pcauto.com.cn/buy/price/modelDetail/{modelId}?areaId=1&fmt=json
现应用接口： 

http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid={modelId} 基础数据
http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34224 参数


原接口： 

http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224


HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:

参数名类型必须说明
modelIdStringY车型ID
areaIdStringY地区id


返回结果:
{ "baseParameter": [

"厂商", "一汽奥迪", "级别", "中大型车", "上市时间", "2014-01", "发动机"...],

"gfPrice": "38.3万",

"groupNameArray": [

"询价订单", "价格", "基本参数", "车身", "发动机", "电动机", "变速箱", "底盘转向",

...

], "kind": "中大型车", "manufacturer": "一汽奥迪", "minPrice": "5.75万", "modelName": "奥迪A6L 2014款 2.0 TFSI 手动基本型", "price": "38.3", "serialGorup": "奥迪A6L", "serialGorupId": 4313, "shortName": "2.0 TFSI 手动基本型", "state": "在售", "total": "0", "url": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_80x60.jpg", "url_120x90": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg", "url_400x300": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_400x300.jpg", "groupNameArray":[ "询价订单", "价格", "基本参数", "车身", "发动机", "电动机"...], "gfprice":"38.3万", "brand":"奥迪", "detail":[ {

"groupDetail": [

"全国4S店", "0笔"

], "groupName": "询价订单"

}......]

}

2.3 车型对比


mrobot请求url:http://mrobot.pcauto.com.cn/buy/price/detailCompare?modelIds=xx1,xx2&fmt=json
现应用接口： 

http://price.pcauto.com.cn/interface/iphone/atom/price/model_overview.jsp?mid={modelId} 基础数据
http://price.pcauto.com.cn/interface/iphone/atom/price/model_params.jsp?mid=34224 参数


原接口： 

http://price.pcauto.com.cn/interface/iphone/model_detail.jsp?mid=34224


HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:

参数名类型必须说明
modelIdStringY车型ID
areaIdStringY地区id


返回结果:
{ "baseParameter": [

"厂商", "一汽奥迪", "级别", "中大型车", "上市时间", "2014-01", "发动机"...],

"gfPrice": "38.3万",

"groupNameArray": [

"询价订单", "价格", "基本参数", "车身", "发动机", "电动机", "变速箱", "底盘转向",

...

], "kind": "中大型车", "manufacturer": "一汽奥迪", "minPrice": "5.75万", "modelName": "奥迪A6L 2014款 2.0 TFSI 手动基本型", "price": "38.3", "serialGorup": "奥迪A6L", "serialGorupId": 4313, "shortName": "2.0 TFSI 手动基本型", "state": "在售", "total": "0", "url": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_80x60.jpg", "url_120x90": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_120x90.jpg", "url_400x300": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1208/21/c7/13077074_13077074_1345530200671_400x300.jpg", "groupNameArray":[ "询价订单", "价格", "基本参数", "车身", "发动机", "电动机"...], "gfprice":"38.3万", "brand":"奥迪", "detail":[ {

"groupDetail": [

"全国4S店", "0笔"

], "groupName": "询价订单"

}......]

}

2.4 我要优惠


mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/getPromotion.xsp?v=1.1.0&modelId=20062&modelName=奥迪&serialId=4313&areaId=1&dealerId=65469&name=tt&tel=13588888888&appKey=34ca62060a1474350000052f&chId=app_store&devId=cb2039424107a8f6d3847fd390d81e60ba7ab516&referer=sg_discount


现应用接口： 

http://price.pcauto.com.cn/dealer/interface/order/recommend_dealer.jsp?rid=" + areaId + "&sgid=" + serialId + "&type=0
http://mrobot.pcauto.com.cn/v3/price/provinceCityList城市数据


HTTP请求方式:get
是否需要登录:false
返回格式:html
缓存方式:
缓存时间:60
说明:
请求参数:

参数名类型必须说明
modelIdStringY车型ID
areaIdStringY地区id
serialIdStringY车系id
dealerIdStringN经销商id
nameStringN提交名称
telStringN提交电话号码
appKeyStringN魔方appKey
chIdStringN设备类型
devIdStringN设备ID
refererStringN备注
vStringN版本号

2.5 优惠详情


mrobot请求url:http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.2/promotionDetail.xsp?marketId=7033340&modelId=33314


现应用接口： 

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
说明:
请求参数:

参数名类型必须说明
modelIdStringY车型ID
marketIdStringY优惠ID

2.6 车型列表


mrobot请求url:http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4_v12/{serialGroupId}?pageNo=1&pageSize=20&areaId=1


现应用接口： 

http://price.pcauto.com.cn/interface/iphone/atom/price/serial_group_basic_json.jsp?serialGroupId=8670
http://price.pcauto.com.cn/interface/iphone/atom/price/model_list_by_sg_json.jsp?serialGroupId=8670
http://price.pcauto.com.cn/interface/iphone/atom/dealer/model_list_news_price_json.jsp?serialGroupId=8670&rId=1;

[BR]原mrobot接口： http://mrobot.pcauto.com.cn/v3/price/getModelListBySerialId_v4/8670?pageNo=1&pageSize=20&areaId=1
HTTP请求方式:get
是否需要登录:false
返回格式:json
缓存方式:
缓存时间:60
说明:
请求参数:

参数名类型必须说明
serialGroupIdStringY车型ID
areaIdStringY地区ID

[BR]返回结果： {

"advantage": "动力输出流畅，后段爆发力足，整体隔音优秀", "bbsId": "17365", "brand": "奥迪", "brandId": "1", "disadvatage": "后排腿部空间和头部空间较为局促", "displacement": "1.4T 2.0T", "gearbox": "手动 双离合", "kind": "紧凑型SUV", "manufacturer": "一汽奥迪", "manufacturerId": "1", "photo": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_120x90.jpg", "photoTotal": 2501, "photo_400x300": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1410/14/c4/39635392_39635392_1413256391078_400x300.jpg", "priceRange": "24.98~42.88万", "sections": [

{

"data": [

{

"config": "7挡双离合 前置前驱 ", "id": "33293", "introduce": 0, "isNews": "0", "photo": " http://img.pconline.com.cn/images/upload/upc/tx/auto5/1404/28/c15/33660207_1398675582054_120x90.jpg", "price": "28.98", "rjBzzw": 5, "state": "在售", "status": "在售", "title": "2015款 35 TFSI 进取型"

}

], "serialGroupName": "奥迪Q3", "sgAverageScore": 4.33, "shareUrl": " http://price.pcauto.com.cn/sg8670/", "structure": "SUV"

}