切换主题
估值-GetUsedPriceMileAgeCity
适用场景
- 收车和交易定价：结合车龄、里程和城市等要素生成估值参考。
- 库存分级与议价：为收购报价、库存定价和人工议价提供统一基准。
- 金融与租赁残值评估：辅助确定融资额度、期限和风险缓冲。
- 客户报价与解释：用结构化因素说明价格差异，提升报价透明度。
接口地址
详见合作邮件通知
接口描述
| 请求协议 | 请求方式 | 编码格式 | 返回格式 |
|---|---|---|---|
| HTTPS | GET/POST | UTF-8 | JSON |
接口参数
| 参数名字 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | 字符串 | 必须 | 访问令牌，仅当开启签名验证时需要传递，生成令牌可使用App.Auth.ApplyToken接口 |
| model_id | 字符串 | 必须 | 款式ID/车型ID |
| type | 整型 | 必须 | 使用性质，1 非营运 、2 营运 、3 租赁非营运、4 租赁营运 、5 营转非 (8年)、6预约出租车 、7预约出租车转非、8营转非(15年) |
| condition | 整型 | 必须 | 车辆状况，1、极好、2、好、3、一般、4、差、5、极差 |
| mile | 浮点型 | 必须 | 行驶里程(万公里，不能为0)，支持两位小数，例如：20.60 |
| city | 字符串 | 必须 | 城市，例如：东莞 |
| licensing_date | 字符串 | 必须 | 上牌日期，格式：YYYY-MM-DD，例如：2022-01-01 |
| register_type | 整型 | 可选 | 车辆所有人类型，1个人、2公司 |
| transfer_count | 整型 | 可选 | 过户次数 |
| color | 枚举类型 | 可选 | 颜色：白色、红色、黑色、银色、灰色、其它 |
响应字段
返回结果
| 返回结果 | 类型 | 说明 |
|---|---|---|
| ret | 整型 | 状态码，200表示成功，4xx表示客户端非法请求，5xx表示服务器错误 |
| data | 对象或混合类型 | 业务数据，由各自接口指定，通常为对象 |
| msg | 字符串 | 提示信息，失败时的错误提示 |
示例
案例数据
text
// 成功返回示例数据
{
"ret": 200,
"data": {
"BuyPrice": "2.84", // 二手车收购价（万元）
"ModelID": "17650", // 款型ID 返回
"SellPrice": "3.27" // 二手车销售价（万元）
},
"msg": ""
}
// 查询失败示例，参数错误
{
"ret": 400,
"data": {},
"msg": "VIN位数不合规"
}
// 查询失败示例，查无数据
{
"ret": 414,
"data": {},
"msg": "查无数据"
}错误码
错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400，客户端参数错误或非法请求 |
| 404 | ret=404，表示接口服务不存在 |
| 406 | ret=406，access_token令牌校验不通过 |
| 407 | ret=407，app_key权限不足，或未知应用 |
| 408 | ret=408，当前用户禁止使用，或用户未登录 |
| 414 | ret=414，查无数据 |
| 500 | 表示服务端内部错误 |