商业险到期剩余天数

适用场景

• 到期提醒：根据剩余天数，在到期前 30 天、60 天等节点提醒车主及时续保，避免保险过期。
• 续保管理：保险机构或销售人员可筛选即将到期的客户，开展续保跟进、报价和方案推荐。
• 风险预警：对剩余天数较少或已过期的车辆进行标记，提示可能存在无商业险保障的风险。
• 客户服务：客服可快速查询保单有效期，准确回答客户关于保障期限、续保时间等问题。
• 运营统计：用于统计不同时间段内即将到期的保单数量，辅助制定续保任务和营销计划。
• 数据看板：在车辆或保单管理系统中展示保险状态，方便用户直观了解当前保障情况。

接口地址

POST /api/v1/getVehCommInsExpDate

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

请求参数

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

{"vin":"1HGBH41JXMN000001"}

vin 必填，17 位车辆识别代号。请求体不要加入其他字段。

响应字段

通用响应字段

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

data 字段

字段	类型	中文含义
vin	string	查询车辆的 VIN。
commInsExpDate	string	商业险到期剩余天数区间；由供应商返回，常见格式如 (270，300]，不是固定枚举。

示例

免费测试案例

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

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

成功响应

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

{
  "code":"0000",
  "message":"成功",
  "data":{"vin":"1HGBH41JXMN000001","commInsExpDate":"(270，300]"},
  "request_id":"request-id"
}

data.commInsExpDate 为服务返回的商业险到期信息，具体展示格式以实际返回为准。

错误码

业务码与注意事项

0000 成功，0001 查无数据，4001 VIN 格式不正确，5001 服务处理失败，5002 供应商 Token 获取失败。认证失败、无路径权限、限流和认证依赖故障分别按 401、403、429、503 处理。问题排查只提供 request_id，不要提交完整敏感请求体。

VIN 格式错误（HTTP 400）

请求：{"vin":"INVALID"}

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

查无数据（HTTP 200）

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

服务或供应商 Token 失败（HTTP 200）

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

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

认证失败、无路径权限、限流、认证依赖不可用时，分别返回 HTTP 401、403、429、503，响应示例见鉴权与公共约定。