wiki:pcauto_sdk_1.0.0/interface

报价宝典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
说明:
请求参数:

参数名类型必须说明
areaIdintY地区ID
serialIdintY车系id
isSubscribedintN是否订阅
modelIdsStringN车型ID
pageNointN当前页
pageSizeintN当前页条数

页面内数据说明:在返回的页面里添加了注释数据/*@_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
说明:
请求参数:

参数名类型必须说明
areaIdintN地区ID
modelIdintN车型ID
vstringN版本号
isComparedintN是否已比较
isSubscribedintN是否已订阅
pageNointN当前页
pageSizeintN当前页条数

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

参数名类型必须说明
modelIdintN车型ID
marketIdintY优惠ID

1.4车系列表

(学车2.0测试) (mrobot开发已完成,请连开发机进行测试)

 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/pcauto_sdkv1.0/getSerialListByBrandId.xsp?brandId=1&type=1

后端接口

 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类型Idint1

返回

  {
   "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":"车型图片"
            } .....
   ]
   }