保险过户次数 VIN 查询

适用场景

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

接口地址

POST /api/v1/getInsTransferCountbyVin

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

请求参数

请求

请求头：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 查询时返回并校验一致的车辆标识。
totalTransCount	string	累计保险过户次数；"0" 是有效结果。
latestTransYM	string/null	最近一次保险过户年月；无记录时为 null。
transCarYear	string/null	最近一次过户时车龄；无记录时为 null。

示例

免费测试案例

使用当前 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****",
    "totalTransCount":"0",
    "latestTransYM":null,
    "transCarYear":null
  },
  "request_id":"request-id"
}

totalTransCount 为字符串，"0" 是有效结果。

错误码

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，不使用业务码。