返回指定筛选条件的车源列表,每次只返回20条。
具体筛选条件和返回结果,详见以下说明。
[正式服务器]https://api.che300.com/service/getCarList
[测试服务器]http://testapi.che300.com/service/getCarList
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车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表示降序。 该排序和其它排序方式一样,只会有一种生效,在调用接口的时候只需要指定一种排序即可。如果不指定的话,默认会是下面的发布时间排序。 |
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
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", //车辆下一年估值
}]
}
ID | 错误信息 | 信息说明 |
---|---|---|
1 | invlaid zone id | 无效的地区参数 |
返回指定车源的详细信息。
[正式服务器]https://api.che300.com/service/getCarDetail
[测试服务器]http://testapi.che300.com/service/getCarDetail
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
key | 必须 | string | 车源的编号,如:8423 |
https://api.che300.com/service/getCarDetail?
token=8192047c7ab1a654eda8fbce470062f0&
key=8403
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"]
}}
ID | 错误信息 | 信息说明 |
---|---|---|
1 | invalid key | 无效的车源ID,比如负数之类的 |
2 | car key doesn't exist | 该车源ID不存在,一般是确实不存在或者车源已经被用户删除了 |
返回指定车系下面的所有车型。
[正式服务器]https://api.che300.com/service/getCarModelList
[测试服务器]http://testapi.che300.com/service/getCarModelList
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
seriesId | 必须 | unsigned int | 车系标识,可以通过车300车系数据接口拿回车系信息,从而提前车系标识。 |
https://api.che300.com/service/getCarModelList?
token=8192047c7ab1a654eda8fbce470062f0&
seriesId=1
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
}
返回指定品牌下面的所有车系列表。
[正式服务器]https://api.che300.com/service/getCarSeriesList
[测试服务器]http://testapi.che300.com/service/getCarSeriesList
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
brandId | 必须 | unsigned int | 品牌标识,可以通过车300品牌数据接口拿回所有的品牌信息,从而提取品牌标识。 |
https://api.che300.com/service/getCarSeriesList?
token=8192047c7ab1a654eda8fbce470062f0&
brandId=1
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
}
返回所有的品牌列表。
[正式服务器]https://api.che300.com/service/getCarBrandList
[测试服务器]http://testapi.che300.com/service/getCarBrandList
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
https://api.che300.com/service/getCarBrandList?
token=8192047c7ab1a654eda8fbce470062f0
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
}
返回所有的城市列表。
[正式服务器]https://api.che300.com/service/getAllCity
[测试服务器]http://testapi.che300.com/service/getAllCity
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
https://api.che300.com/service/getAllCity?
token=8192047c7ab1a654eda8fbce470062f0
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
}
返回所估车型在指定地区的基础估值信息。
[正式服务器]https://api.che300.com/service/getUsedCarPrice
[测试服务器]http://testapi.che300.com/service/getUsedCarPrice
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
modelId | 必须 | unsigned int or string | 车型标识,可以通过车300车型列表数据接口拿回车300所支持的所有车型相关信息,也可以申请合作成功之后提供网站自己的车型信息进行两者之间的映射。 |
regDate | 必须 | string | 待估车辆的上牌时间(格式:yyyy-MM)。 |
mile | 必须 | double | 待估车辆的公里数,单位万公里。 |
zone | 必须 | unsigned int or string | 城市标识,可以通过车300城市列表数据接口拿回车300所支持的所有城市相关信息,也可以申请合作成功之后提供网站自己的城市信息进行两者之间的映射。 |
https://api.che300.com/service/getUsedCarPrice?
token=8192047c7ab1a6549da8fbce470062f1&
modelId=58&
regDate=2012-3&
mile=4&
zone=11
完全基于合同需求定制
ID | 错误信息 | 信息说明 |
---|---|---|
1 | 上牌日期格式不正确 | 正确的上牌日期格式是YYYY-MM的形式,除此之外的输入都被认为非法输入 |
2 | 车型无法匹配 | 用户所传的车型ID系统中不存在或者在双方车型映射库中目前还没有映射成功 |
3 | 地区无法匹配 | 用户所传的地区ID系统中不存在或者在双方地区映射库中目前还没有映射成功 |
4 | 车型信息丢失 | 该错误一般发生在下列情况: 双方车型之前是映射上的,但是由于一段时间没有更新,车300更新了车型库导致旧的车型被替换或者删除了 |
5 | 缺少车型参数 | 必传的车型ID没有传递 |
6 | 上牌年份不合理 | 车300所有的车型上牌年份都是存在一个区间的,如果用户所传上牌时间不在该区间内即为不合理 |
返回指定车型参数返回在车300车型库里面映射的结果。
https://api.che300.com/service/identifyModel
json
GET
各个参数请进行URL 编码,编码时请遵守
RFC 1738
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
token | 必须 | string | 查询编号,由车300提供,对应唯一的查询用户。 注: |
brand | 必须 | string | 品牌名称,是合作伙伴所使用的品牌名称,如:雪佛兰。 |
series | 必须 | string | 车系名称,是合作伙伴所使用的车系名称,如:赛欧三厢。 |
model | 必须 | string | 车型名称,是合作伙伴所使用的车型名称,如:1.4L MT 幸福版。 |
modelYear | 必须 | unsigned int | 车型年款,是指定车型的年款,如:2011。 |
modelPrice | double | 新车指导价,可选参数,最好提供可以增加识别的成功几率和准确性,如:7.23。 |
https://api.che300.com/service/identifyModel?
token=1efff410db0666f6d3196815e8&
brand=雪佛兰&
series=赛欧三厢&
model=1.4L MT 幸福版&
modelYear=2011&
modelPrice=7.23
JSON示例:
{
"status":"1",//1 表示成功/0 表示失败
"modelInfo":{//车300车型信息
"brand_id":126,//对应车300车型品牌ID
"series_id":1238,//对应车300车型车系ID
"model_id":17357}//对应车300车型ID
}
客服电话
400-858-7585扫码关注 车300 微信公众号
车300大众版 App
车300专业版 App