历史过户次数查询

适用场景

• 二手车估值与交易决策：判断车辆流转频率，辅助定价、收购和出售。
• 车况与风险核验：识别频繁过户、短期倒手等潜在风险。
• 保险与金融审核：辅助保险承保、车贷审批及风险评估。

接口地址

POST /api/v1/getVehTransferCount

接口地址详见合作邮件通知

请求参数

请求头：Authorization: Bearer <ACCESS_TOKEN>、Content-Type: application/json。

{"vin":"1HGBH41JXMN000001"}

vin 必填，17 位 VIN。请求体不要加入其他字段。

响应字段

通用响应字段

字段	类型	中文含义
code	string	业务状态码：0000 成功、0001 查无数据、4001 参数格式错误、5001 服务处理失败、5002 供应商 Token 获取失败。认证层拒绝时不使用该业务信封。
message	string	业务处理结果说明；成功、无数据或失败时由服务返回相应文字。
data	object/array/null	业务结果。成功时为对象或数组；查无数据或业务失败时通常为 null。
request_id	string	请求链路标识，用于问题排查；不要用它替代密钥或 Token。

data 字段

字段	类型	中文含义
vin	string	查询车辆的 VIN。
transferCount	string	历史过户次数；数值以字符串返回，"0" 是有效的零次过户结果。

示例

免费测试案例

使用当前 Swagger 默认入参：vin=1HGBH41JXMN000001。

curl -X POST \
  "接口地址详见合作邮件通知" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"vin":"1HGBH41JXMN000001"}'

成功响应

以下为按默认测试入参整理的字段结构示例；次数仅用于说明返回格式，实际结果以接口返回为准。

{
  "code":"0000",
  "message":"成功",
  "data":{"vin":"1HGBH41JXMN00****","transferCount":"0"},
  "request_id":"request-id"
}

transferCount 使用字符串；"0" 是有效结果，不应当被当成无数据。

错误码

业务码与注意事项

0000 成功，0001 查无数据，4001 VIN 格式不正确，5001 服务处理失败，5002 供应商 Token 获取失败。认证层错误按公共鉴权文档处理。

VIN 格式错误（HTTP 400）

{"code":"4001","message":"VIN格式不正确","data":null,"request_id":"request-id"}

查无数据、服务失败和 Token 失败（HTTP 200）

{"code":"0001","message":"查无数据","data":null,"request_id":"request-id"}

{"code":"5001","message":"供应商接口调用失败","data":null,"request_id":"request-id"}

{"code":"5002","message":"供应商Token获取失败","data":null,"request_id":"request-id"}

认证层错误为 HTTP 401、403、429、503，不使用业务码。