保险地区 VIN 查询

适用场景

• 二手车估值与车况核验：结合初登日期和投保时间，判断车辆使用年限及信息一致性。
• 保险核保与续保：根据投保地区和最近投保年月评估承保、续保及客户触达机会。
• 车辆地域风险分析：分析不同省市区县的车辆分布、事故风险和保险需求。
• 车主运营与营销：针对临近续保客户开展提醒、报价和增值服务推荐。
• 车辆金融与风控审核：辅助确认车辆基础信息及保险覆盖连续性。
• 销售流向分析：主机厂销售流向分析。

接口地址

POST /api/v1/getVehInsuranceRegion

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

请求参数

请求头：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[] 字段

字段	类型	中文含义
province	string/null	保险所在省份。
city	string/null	保险所在城市。
county	string/null	保险所在区县。
insuranceMonth	string/null	最近一次投保年月；格式通常为 YYYY-MM，实际以返回值为准。
vin	string/null	关联车辆的 VIN。
registerDate	string/null	车辆注册/初次登记日期；格式由上游返回。

data 为数组；无匹配数据时为 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":[{
    "province":"江苏省",
    "city":"南京市",
    "county":"鼓楼区",
    "insuranceMonth":"2026-06",
    "vin":"1HGBH41JXMN00****",
    "registerDate":"2020-01-01"
  }],
  "request_id":"request-id"
}

字段可能为 null。

错误码

VIN 格式错误（HTTP 400）

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

查无数据（HTTP 200）

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

供应商返回格式错误或车辆不匹配（HTTP 200）

{"code":"5001","message":"供应商返回格式不正确","data":null,"request_id":"request-id"}

{"code":"5001","message":"供应商返回车辆与查询条件不匹配","data":null,"request_id":"request-id"}

Token 或服务失败（HTTP 200）

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

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

认证层错误按 HTTP 401、403、429、503 处理，不使用上述业务码。