切换主题
vin查初登日期和投保年月
适用场景
- 车辆年限核验:通过初登日期判断车龄,支持二手车估值和金融期限审核。
- 保险续保运营:依据最近投保年月筛选续保线索,开展提醒和报价服务。
- 投保连续性与风险判断:识别保险记录间隔,辅助承保和车辆资料复核。
- 区域经营分析:结合 VIN 车辆档案和投保时间,分析客户及车辆生命周期。
接口地址
详见合作邮件通知
接口描述
| 请求协议 | 请求方式 | 编码格式 | 返回格式 |
|---|---|---|---|
| HTTPS | GET/POST | UTF-8 | JSON |
接口参数
| 参数名字 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | 字符串 | 必须 | 访问令牌,开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口 |
| vin | 字符串 | 必须 | 车架号 |
响应字段
返回结果
| 返回字段 | 类型 | 中文含义 |
|---|---|---|
| ret | integer | 旧版业务状态码;200 表示成功,4xx 表示客户端错误,5xx 表示服务端错误。 |
| data | object/null | 车辆初登和投保年月数据;查无数据时可能为空对象,失败时可能不返回或为空。 |
| msg | string | 提示信息;成功时通常为空字符串,失败时包含错误说明。 |
data 字段
| 字段 | 类型 | 中文含义 |
|---|---|---|
| VIN | string/null | 车辆识别代号;通常为 17 位 VIN。 |
| PlateNum | string/null | 与 VIN 匹配的车牌号;本接口按代码在 VIN 查询场景明确置为 null。 |
| Brand | string/null | 车辆品牌;无上游数据时可能为 null。 |
| FirstRegistrationDate | string/null | 初次登记日期;常见格式为 YYYY-MM-DD,实际格式以上游返回为准。 |
| insuranceMonth | string/null | 最近一次投保年月;常见格式为 YYYY-MM,实际格式以上游返回为准。 |
| carUsage | string/null | 车辆使用性质;例如“非营业个人”“非营运”,由上游透传,非封闭枚举。 |
返回的json结果
text
{
"ret": 200,
"data": {
"carUsage": "非营业个人",
"insuranceMonth": "2024-10",
"VIN": "WVGAV67L9AD004**4",
"PlateNum": null,
"Brand": null,
"FirstRegistrationDate": "2009-10-26"
},
"msg": ""
}错误码
错误列表
| 错误状态码 | 错误描述信息 |
|---|---|
| 400 | ret=400,客户端参数错误或非法请求 |
| 404 | 表示接口服务不存在 |
| 406 | ret=406,access_token令牌校验不通过 |
| 407 | ret=407,app_key权限不足,或未知应用 |
| 408 | ret=408,当前用户禁止使用,或用户未登录 |
| 500 | 表示服务端内部错误 |