1.公平价估值接口简介

对外合作接口,是通过公平价提供的数据接口,实现合作网站与公平价进行数据互通,从而使用公平价二手车估值,提升二手车相关服务。

申请合作

2.接口列表

2.1 估值接口URL

http://openapi.gongpingjia.com/api/cars/evaluation/合作平台/

2.2 返回格式

JSON

2.3 HTTP请求方式

GET

2.4 请求参数编码方式

UTF8

2.5 请求参数

参数名 是否必填 参数类型 说明
d_model true string 车辆款型ID,以力洋车型库为准,传入车款ID
year true string 初次上牌年代 (2000-2015),合法年份为能买到所估车辆新车的年份,一般为该款 型力洋的上市停产年份+2)之间
month true string 初次上牌时的月份 (1-12)
mile true string 表征里程(单位为万公里,请求参数不带单位,如‘8,2’,‘1.6’)
color true string 颜色,以力洋录入的数据为准(如‘红’,‘黑’,‘其他’)
city true string 该车源所在的城市的市级行政编码,如北京则传入110100
intent true string 估值类型,值为’buy’、‘sell’、’private’、值为‘buy’ 时估出的是个人向诚信经销商购买的价格。值为‘sell’时估出的 是个人车主向诚信经销商出售的价格。值为’private’时估出的是 个人向个人出售的价格。如不传intent参数则一起返回这3种价格和 对应的价格范围,以及对应于公平价估值结果页面的URL。
callback true string 该参数用于支持在前端用ajax方式调用估值接口,参数值一般为“?”或自定义的 javascript回调函数名(参见ajax跨域请求jsonp方式)。 如在服务器端调用估值接口则不需要加这个参数。

2.6 请求示例1

http://openapi.gongpingjia.com/api/cars/evaluation/chemao/?dmodel=81802&year=2014&month=2&mile=2&city=510100

2.7 返回json

键名 是否必返回 键值类型 说明
status true string 估值请求成功该值为‘success’,失败为‘fail’
message true string 对响应估值请求的描述,若请求成功,返回成功的描述信息,失败返回失败原因的描述信息
deal_price false string 初次上牌时的月份 (1-12)
excellent_deal_price false string 车况优秀时的价格
good_deal_price false string 车况优秀时的价格
fair_deal_price false string 车况优秀时的价格
bad_deal_price false string 车况优秀时的价格

2.8 未指定intent参数时返回如下字段

键名 是否必返回 键值类型 说明
status true string 估值请求成功该值为‘success’,失败为‘fail’
message true string 对响应估值请求的描述,若请求成功,返回成功的描述信息,失败返回失败原因的描述信息
deal_price false string 初次上牌时的月份 (1-12)
excellent_deal_price false string 车况优秀时的价格
good_deal_price false string 车况优秀时的价格

2.9 返回json示例

{
    "status": "success",
    "bad_deal_price": "34684",
    "deal_price": "42862",
    "url": "http://cd.gongpingjia.com/used-beiqishenbao-prices/beijingqicheshenbaoD50/2014-2/
    62345_autotis/20000/excellent/1-1-0-0/?intent=sell&source_type=private",
    "fair_deal_price": "37645",
    "message": "Evaluation finished,thanks.",
    "good_deal_price": "42298",
    "condition": "excellent",
    "excellent_deal_price": "43567"
}

2.10 intent参数缺省时

{
    "status": "success",
    "bad_deal_price": "34684",
    "deal_price": "42862",
    "url": "http://cd.gongpingjia.com/used-beiqishenbao-prices/beijingqicheshenbaoD50/2014-2/
    62345_autotis/20000/excellent/1-1-0-0/?intent=sell&source_type=private",
    "fair_deal_price": "37645",
    "message": "Evaluation finished,thanks.",
    "good_deal_price": "42298",
    "condition": "excellent",
    "excellent_deal_price": "43567"
}                       

2.11 返回错误信息列表

status message 说明
fail Not enough parameters sent, missing parameter XXX 请求时发送的参数不完整
fail Not enough parameters sent, missing parameter XXX 请求时发送的参数不完整
fail Not enough parameters sent, missing parameter XXX 请求时发送的参数不完整

申请合作