车300(车三百,che300)-权威公正准确的二手车估值与交易平台

简介

公共接口合作，是通过车300提供的数据接口，实现合作网站与车300之间数据互通，获得海量二手车车源数据，统一齐全的汽车车型库及二手车估值，提高合作网站二手车专业水准。

接口列表

车型列表
车系列表
品牌列表
城市列表
基础估值

What's New?

1 功能说明

返回指定筛选条件的车源列表，每次只返回20条。
具体筛选条件和返回结果，详见以下说明。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getCarList
[测试服务器]http://testapi.che300.com/service/getCarList

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
zone	必须	unsigned int	城市标识，可以通过车300城市数据接口拿回车300所支持的所有城市标识，也可以申请合作成功之后提供网站自己的城市信息进行两者之间的映射。
page		unsigned int	车源列表页码，也就是需要拿第几页车源，每页最多会有20条车源，如果不足20条会全部返回。如果不给的话，默认为1。
keyword		string	搜索关键字，根据改关键字进行搜索提供车源，如：宝马X1。
carBrand		unsigned int	品牌ID，可以通过车300的品牌数据接口拿回所有的品牌相关信息。
carSeries		unsigned int	车系ID，可以通过车300的车系数据接口拿回指定品牌下的所有车系相关信息。
carModel		unsigned int	车型ID，可以通过车300的车型数据接口拿回指定车系下的所有车型相关信息。
carYear		string	车龄，既可以指定一个区间（如：3-5），也可以指定一个具体的上牌年份（如：2009）。
carMile		string	车辆里程，既可以指定一个区间（如：3-5），也可以指定一个具体的公里数（如：10），该参数表达的意思是大于等于多少万公里。
carPrice		string	车辆价格，既可以指定一个区间（如：3-5），也可以指定一个具体的数目（如：10），该参数表达的意思是大于等于多少万元。
sellerType		string	卖家类型，1表示个人，2表示商家，不指定的话返回结果就是个人和商家混合车源。
vprSort		string	性价比排序，指定返回的车源按照性价比排序。可以取值asc和desc，其中asc表示升序，desc表示降序。该排序和其它排序方式一样，只会有一种生效，在调用接口的时候只需要指定一种排序即可。如果不指定的话，默认会是下面的发布时间排序。
priceSort		string	价格排序，指定返回的车源按照价格排序。可以取值asc和desc，其中asc表示升序，desc表示降序。该排序和其它排序方式一样，只会有一种生效，在调用接口的时候只需要指定一种排序即可。如果不指定的话，默认会是下面的发布时间排序。
registerDateSort		string	上牌时间排序，指定返回的车源按照上牌时间排序。可以取值asc和desc，其中asc表示升序，desc表示降序。该排序和其它排序方式一样，只会有一种生效，在调用接口的时候只需要指定一种排序即可。如果不指定的话，默认会是下面的发布时间排序。
mileAgeSort		string	车辆里程排序，指定返回的车源按照车辆里程排序。可以取值asc和desc，其中asc表示升序，desc表示降序。该排序和其它排序方式一样，只会有一种生效，在调用接口的时候只需要指定一种排序即可。如果不指定的话，默认会是下面的发布时间排序。
postDateSort		string	发布时间排序，指定返回的车源按照发布时间排序。可以取值asc和desc，其中asc表示升序，desc表示降序。该排序和其它排序方式一样，只会有一种生效，在调用接口的时候只需要指定一种排序即可。如果不指定的话，默认会是下面的发布时间排序。

2.5 请求示例

https://api.che300.com/service/getCarList?
token=8192047c7ab1a654eda8fbce470062f0&
page=2&
carBrand=1&
carSeries=1&
carModel=10&
carYear=0-3&
carMile=0-4&
vprSort=desc&
zone=2

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"car_list":
[{
"id":"14658896", //车源ID
"url":"http:\/\/nj.che300.com\/detail_14658896.html", //车源详细信息链接
"city":"11", //车源所在城市ID
"prov":"11", //车源所在省份ID
"title":"奥迪A4L 2012年款 A4L 2.0TFSI 无级豪华型金盛店出售精品私家车", //车源信息标题
"car_desc":"定速巡航六碟cd 电动加热真皮座椅停车辅助系统店现推出国家认定资质的车况检测业务，可对车况进行权威检测。同时对检测结果郑重承诺：如若检测有误，原价退车，（同时本店还推出二手车按揭贷款业务，最低0首付）。如想进一步了解可直接拨打分机电话联系跟单业务员。小孙竭诚为您服", //车源概况描述
"pic_url":"http:\/\/img.273.com.cn\/eqsdfs01\/M03\/B8\/C6\/CgDJBFOHIduANEVJAAHQ2Wu5uxU049_185-140c_9_0_1.jpg", //车源封面图片
"brand_id":"1", //品牌ID
"brand_name":"奥迪", //品牌名称
"series_id":"1", //车系ID
"series_name":"奥迪A4L", //车系名称
"model_id":"15", //车型ID
"model_name":"2012年款奥迪A4L 2.0TFSI 无级豪华型", //车型名称
"price":"26", //车源报价
"mile_age":"2.1", //行驶里程
"register_date":"2012-01-01 00:00:00", //车辆上牌日期
"gear_type":"自动", //变速箱
"color":"红色", //颜色
"liter":"2.00L", //排量
"tel":"400-6030-273 转 079 035", //联系电话
"tel_url":null, //联系电话图片，有些车源网站的联系方式是图片的方式展示
"contactor":"孙海峰", //联系人
"seller_type":"2", //卖家类型，1表示个人，2表示商家
"dealer_name":"南京金盛服务中心", //商家名称
"car_source":"273", //车源来源网站
"post_time":"2014-05-29 00:00:00", //车源发布时间
"update_time":"2014-05-29 00:00:01", //车源更新时间
"model_price":"39.9", //车型指导价
"eval_price":"23.5919", //车源估值
"vpr":"0.907379948451491", //性价比
"tlci_date":"2015-01-01", //交强险到期时间
"audit_date":"2015-01-01", //商业险到期时间
"next_year_eval_price":"22.392327891262003", //车辆下一年估值
}]
}

2.7 错误信息列表

ID	错误信息	信息说明
1	invlaid zone id	无效的地区参数

What's New?

1 功能说明

返回指定车源的详细信息。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getCarDetail
[测试服务器]http://testapi.che300.com/service/getCarDetail

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
key	必须	string	车源的编号，如：8423

2.5 请求示例

https://api.che300.com/service/getCarDetail?
token=8192047c7ab1a654eda8fbce470062f0&
key=8403

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"car_detail": {
"id":"14658896", //车源ID
"url":"http:\/\/nj.che300.com\/detail_14658896.html", //车源详细信息链接
"city":"11", //车源所在城市ID
"prov":"11", //车源所在省份ID
"title":"奥迪A4L 2012年款 A4L 2.0TFSI 无级豪华型金盛店出售精品私家车", //车源信息标题
"car_desc":"定速巡航六碟cd 电动加热真皮座椅停车辅助系统店现推出国家认定资质的车况检测业务，可对车况进行权威检测。同时对检测结果郑重承诺：如若检测有误，原价退车，（同时本店还推出二手车按揭贷款业务，最低0首付）。如想进一步了解可直接拨打分机电话联系跟单业务员。小孙竭诚为您服", //车源概况描述
"pic_url":"http:\/\/img.273.com.cn\/eqsdfs01\/M03\/B8\/C6\/CgDJBFOHIduANEVJAAHQ2Wu5uxU049_185-140c_9_0_1.jpg", //车源封面图片
"brand_id":"1", //品牌ID
"brand_name":"奥迪", //品牌名称
"series_id":"1", //车系ID
"series_name":"奥迪A4L", //车系名称
"model_id":"15", //车型ID
"model_name":"2012年款奥迪A4L 2.0TFSI 无级豪华型", //车型名称
"price":"26", //车源报价
"mile_age":"2.1", //行驶里程
"register_date":"2012-01-01 00:00:00", //车辆上牌日期
"gear_type":"自动", //变速箱
"color":"红色", //颜色
"liter":"2.00L", //排量
"tel":"400-6030-273 转 079 035", //联系电话
"tel_url":null, //联系电话图片，有些车源网站的联系方式是图片的方式展示
"contactor":"孙海峰", //联系人
"seller_type":"2", //卖家类型，1表示个人，2表示商家
"dealer_name":"南京金盛服务中心", //商家名称
"car_source":"273", //车源来源网站
"post_time":"2014-05-29 00:00:00", //车源发布时间
"update_time":"2014-05-29 00:00:01", //车源更新时间
"model_price":"39.9", //车型指导价
"eval_price":"23.5919", //车源估值
"vpr":"0.907379948451491", //性价比
"tlci_date":"2015-01-01", //交强险到期时间
"audit_date":"2015-01-01", //商业险到期时间
"next_year_eval_price":"22.392327891262003", //车辆下一年估值
"pic_list":[ //车辆图片列表
"http:\/\/www.che300.com\/service\/QueryService.php?oper=getImage&url=http:\/\/www.autoimg.cn\/2scimg\/2013\/6\/14\/b_5709325315977847055.jpg",
"http:\/\/www.che300.com\/service\/QueryService.php?oper=getImage&url=http:\/\/www.autoimg.cn\/2scimg\/2013\/6\/14\/b_5095409273223578011.jpg"]
}}

2.7 错误信息列表

ID	错误信息	信息说明
1	invalid key	无效的车源ID，比如负数之类的
2	car key doesn't exist	该车源ID不存在，一般是确实不存在或者车源已经被用户删除了

What's New?

1 功能说明

返回指定车系下面的所有车型。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getCarModelList
[测试服务器]http://testapi.che300.com/service/getCarModelList

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
seriesId	必须	unsigned int	车系标识，可以通过车300车系数据接口拿回车系信息，从而提前车系标识。

2.5 请求示例

https://api.che300.com/service/getCarModelList?
token=8192047c7ab1a654eda8fbce470062f0&
seriesId=1

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"model_list":
[{
"model_id":"1",//车型ID
"model_name":"2013款奥迪A4L 30TFSI 手动舒适型",//车型名称
"model_price":"27.28",//指导价
"model_year":"2013",//年款
"min_reg_year":"2013",//最小上牌年份
"max_reg_year":"2015",//最大上牌年份
"liter":"2.0T",//排量
"gear_type":"自动",//变速箱
"discharge_standard":"国4",//排放标准
"seat_number": "5",//座位数
"update_time": "2016-01-20 23:23:12"//更新时间
}]
url: http:\\www.che300.com
}

What's New?

1 功能说明

返回指定品牌下面的所有车系列表。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getCarSeriesList
[测试服务器]http://testapi.che300.com/service/getCarSeriesList

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
brandId	必须	unsigned int	品牌标识，可以通过车300品牌数据接口拿回所有的品牌信息，从而提取品牌标识。

2.5 请求示例

https://api.che300.com/service/getCarSeriesList?
token=8192047c7ab1a654eda8fbce470062f0&
brandId=1

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"series_list":
[{
"series_id":"1",//车系ID
"series_name":"奥迪100",//车系名称
"series_group_name":"一汽奥迪",//车系组名},
"update_time": "2016-01-20 23:23:12"//更新时间
{
"series_id":"2",//车系ID
"series_name":"奥迪200",//车系名称
"series_group_name":"一汽奥迪",//车系组名
"update_time": "2016-01-20 23:23:12"//更新时间
}]
url: http:\\www.che300.com
}

What's New?

1 功能说明

返回所有的品牌列表。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getCarBrandList
[测试服务器]http://testapi.che300.com/service/getCarBrandList

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。

2.5 请求示例

https://api.che300.com/service/getCarBrandList?
token=8192047c7ab1a654eda8fbce470062f0

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"brand_list":
[{
"brand_id":"1",//品牌ID
"brand_name":"奥迪",//品牌名称
"initial":"A",//品牌名称拼音首字母
"update_time": "2016-01-20 23:23:12"//更新时间
},
{
"brand_id":"2",//品牌ID
"brand_name":"阿斯顿·马丁",//品牌名称
"initial":"A",//品牌名称拼音首字母
"update_time": "2016-01-20 23:23:12"//更新时间
}]
url: http:\\www.che300.com
}

What's New?

1 功能说明

返回所有的城市列表。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getAllCity
[测试服务器]http://testapi.che300.com/service/getAllCity

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。

2.5 请求示例

https://api.che300.com/service/getAllCity?
token=8192047c7ab1a654eda8fbce470062f0

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"city_list":
[{
"city_id":"11",//城市ID
"city_name":"南京",//城市名称
"prov_id":"11",//所属省份ID
"prov_name":"江苏",//所属省份名称},
{
"city_id":"41",//城市ID
"city_name":"无锡",//城市名称
"prov_id":"11",//所属省份ID
"prov_name":"江苏",//所属省份名称
}]
url: http:\\www.che300.com
}

What's New?

1 功能说明

返回所估车型在指定地区的基础估值信息。

2 接口调用说明

2.1 URL

[正式服务器]https://api.che300.com/service/getUsedCarPrice
[测试服务器]http://testapi.che300.com/service/getUsedCarPrice

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
modelId	必须	unsigned int or string	车型标识，可以通过车300车型列表数据接口拿回车300所支持的所有车型相关信息，也可以申请合作成功之后提供网站自己的车型信息进行两者之间的映射。
regDate	必须	string	待估车辆的上牌时间（格式：yyyy-MM）。
mile	必须	double	待估车辆的公里数，单位万公里。
zone	必须	unsigned int or string	城市标识，可以通过车300城市列表数据接口拿回车300所支持的所有城市相关信息，也可以申请合作成功之后提供网站自己的城市信息进行两者之间的映射。

2.5 请求示例

https://api.che300.com/service/getUsedCarPrice?
token=8192047c7ab1a6549da8fbce470062f1&
modelId=58&
regDate=2012-3&
mile=4&
zone=11

2.6 返回结果示例

完全基于合同需求定制

2.7 错误信息列表

ID	错误信息	信息说明
1	上牌日期格式不正确	正确的上牌日期格式是YYYY-MM的形式，除此之外的输入都被认为非法输入
2	车型无法匹配	用户所传的车型ID系统中不存在或者在双方车型映射库中目前还没有映射成功
3	地区无法匹配	用户所传的地区ID系统中不存在或者在双方地区映射库中目前还没有映射成功
4	车型信息丢失	该错误一般发生在下列情况：双方车型之前是映射上的，但是由于一段时间没有更新，车300更新了车型库导致旧的车型被替换或者删除了
5	缺少车型参数	必传的车型ID没有传递
6	上牌年份不合理	车300所有的车型上牌年份都是存在一个区间的，如果用户所传上牌时间不在该区间内即为不合理

What's New?

1 功能说明

返回指定车型参数返回在车300车型库里面映射的结果。

2 接口调用说明

2.1 URL

https://api.che300.com/service/identifyModel

2.2 格式

json

2.3 HTTP请求方式

GET

2.4 输入参数说明

各个参数请进行URL 编码，编码时请遵守 RFC 1738

参数名称	是否必须	类型	描述
token	必须	string	查询编号，由车300提供，对应唯一的查询用户。注：用户提交合作申请过后，由车300来进行审核，审核通过的用户将会分配唯一的用户访问标识。
brand	必须	string	品牌名称，是合作伙伴所使用的品牌名称，如：雪佛兰。
series	必须	string	车系名称，是合作伙伴所使用的车系名称，如：赛欧三厢。
model	必须	string	车型名称，是合作伙伴所使用的车型名称，如：1.4L MT 幸福版。
modelYear	必须	unsigned int	车型年款，是指定车型的年款，如：2011。
modelPrice		double	新车指导价，可选参数，最好提供可以增加识别的成功几率和准确性，如：7.23。

2.5 请求示例

https://api.che300.com/service/identifyModel?
token=1efff410db0666f6d3196815e8&
brand=雪佛兰&
series=赛欧三厢&
model=1.4L MT 幸福版&
modelYear=2011&
modelPrice=7.23

2.6 返回结果示例

JSON示例:

{
"status":"1",//1 表示成功/0 表示失败
"modelInfo":{//车300车型信息
"brand_id":126,//对应车300车型品牌ID
"series_id":1238,//对应车300车型车系ID
"model_id":17357}//对应车300车型ID
}