wiki:pcauto_BuyAuto_1.2.0

Version 6 (modified by wuxiaoling, 11 years ago) (diff)

--

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/buy/price/serialDetail/{serialId}?areaId=1&fmt=json
现应用接口:

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/atom/dealer/model_list_news_price_json.jsp?serialGroupId=4313&rId=1本地经销商最低价


原接口:

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


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

|serialId
参数名类型必须说明
StringY车系ID
areaIdStringY地区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