简介

公共接口合作,是通过车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
    }

关闭 您身边的二手车专家,买卖二手车,先查车300

车300个人版 App

扫描二维码,下载车300

车300专业版 App

扫描二维码,下载车300
点击弹出二维码下载车300 App