人车关系核验-交强险和商业险分别核验

适用场景

• 二手车交易核验：通过 VIN、车主身份证号及保险信息，核对车辆与当前车主的一致性。
• 出行与货运平台审核：判断交强险、商业险投保人或车主信息是否匹配，降低身份冒用风险。
• 车辆金融风控：辅助车贷、融资租赁等业务核验车辆权属及保险状态。
• 主机厂二手车置换补贴政策核验：主机厂在新车营销环节推出的二手车置换补贴政策，帮助真实性核验。

接口地址

POST /api/v1/verifyVehOwnerConsistency

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

请求参数

请求

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

{
  "vin":"1HGBH41JXMN00****",
  "idCard":"<ID_CARD>",
  "licensePlate":""
}

vin 为 17 位 VIN；idCard 必填，18 位；licensePlate 可选，支持 7 或 8 位普通/新能源车牌。服务会去除首尾空格并规范化字母。

响应字段

通用响应字段

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

data 字段

字段	类型	中文含义
vin	string	查询车辆的 VIN。
ownerConsistency	string	车主一致性核验结果；通常包含“商业险:是/否、交强险:是/否”等文本，上游透传，非封闭枚举。

示例

免费测试案例

使用当前 Swagger 默认入参。该身份证号仅作为 docs 示例，请替换为已获授权的测试数据。

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

成功响应

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

{
  "code":"0000",
  "message":"成功",
  "data":{"vin":"1HGBH41JXMN00****","ownerConsistency":"商业险:否,交强险:否"},
  "request_id":"request-id"
}

身份证号属于敏感数据，只能在客户受控服务端传输，不要写入日志、工单或截图。

错误码

业务码与注意事项

0000 成功，0001 查无数据，4001 入参格式不正确，5001 服务处理失败，5002 供应商 Token 获取失败。认证层错误按 401、403、429、503 处理。

身份证号长度错误（HTTP 422）

请求：{"vin":"1HGBH41JXMN00****","idCard":"123","licensePlate":""}

{"code":"invalid_request","message":"request validation failed","request_id":"request-id"}

查无数据或供应商失败（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。