二手车价格评估接口（usedcar.price）：20 项参数估出价格区间

这个接口能解决什么问题

usedcar.price 把二手车的估值过程收敛成一次 HTTP 请求。相比只看车贩子报价，接口按品牌型号 + 车龄 + 里程 + 车况 + 地域的组合做估算，返回的是价格区间而不是单一数字，天然反映真实交易中的议价空间。

一句话说明

提交最多 20 项车况参数，返回评估价格区间（万元）；brand 与 model 至少填一个，估不出价格不收费。

适用场景

收车 / 置换估价：快速给出收购与零售参考价
零售挂牌定价：基于行情区间定价
金融质押物估值
车源定价体检：结合 usedcar.list 给在售车源一键估值

接口规格

接口规格
请求地址	`https://api.xujian.tech/openapi/usedcar/price`
请求方式	POST，参数放 application/json 请求体
鉴权方式	请求头 `X-API-Key`
接口编码	`usedcar.price`
收费类型	按次计费（PER_CALL，0.5000 元/次）
计费规则	查得计费：参数非法、上游不可用、未能给出价格区间时失败且不扣费
字段长度	每个字符串字段不超过 50 个字符
典型用途	收车估价、零售定价、金融质押估值

如何调用

cURL

curl -s -X POST "https://api.xujian.tech/openapi/usedcar/price" -H "Content-Type: application/json" -H "X-API-Key: 你的APIKey" -d @body.json

body.json 内容（参数越多越准）

JSON

{
  "brand": "大众",
  "model": "迈腾",
  "year": "2023",
  "configuration": "330TSI DSG 豪华型",
  "registrationDate": "2022-03",
  "mileage": "8.5",
  "accidentHistory": "0",
  "transferCount": "0",
  "maintenanceRecord": "全程4S店保养",
  "fuelType": "汽油",
  "transmissionType": "自动",
  "displacement": "2.0",
  "color": "黑色",
  "location": "北京",
  "description": "车辆外观完好内饰9成新"
}

影响估值的四个关键参数

权重最高的参数

mileage 行驶里程 —— 权重最高
registrationDate 上牌时间 / year 年款 —— 车龄折旧
location 车辆所在地 —— 地域价格差异
accidentHistory 事故历史 —— 车况

这四项务必尽量填准；其余参数可选，但填得越全结果越稳。

返回示例（code = 0）

JSON

{
  "code": 0,
  "msg": "success",
  "data": {
    "minPrice": "10.6",
    "maxPrice": "12.4",
    "unit": "万元",
    "apiCode": "usedcar.price",
    "apiName": "二手车价格评估",
    "chargeType": "PER_CALL",
    "balance": 99.5000,
    "costMs": 420
  }
}

计费说明

按次计费，0.5000 元/次。采用「先预鉴权、给出价格区间后扣费」两段式；参数非法、上游不可用、未能给出价格区间时返回失败，不扣费。

常见问题

只填品牌型号能估吗？ brand 与 model 至少填一个；填得越全（里程、车龄、车况、地域）结果越稳。
返回的是区间还是单价？ 是区间（minPrice ~ maxPrice，万元），反映议价空间。
和 usedcar.list 怎么配合？ list 拉车源，price 给单辆估值，二者组合可做「车源 + 估价」展示。