最大出险查询

适用场景

• 二手车估值与交易决策
  • 判断车辆重大事故程度、维修范围和贬值幅度。
  • 支持定价、收购、置换及车况披露。
• 保险核保与续保
  • 评估车辆历史风险、出险频率和潜在赔付风险。
  • 辅助保费定价、承保限制及续保审核。
• 车队与企业车辆管理
  • 监控运营车辆重大事故、维修成本和停运影响。
  • 支持车辆淘汰、替换及驾驶安全管理。

接口地址

POST /api/v1/getVehMaxClaimIncident 接口地址详见合作邮件通知

请求参数

请求

请求头：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。
insuranceType	any/null	保险类型及承保对象，例如“商业险,主车”；上游透传，非封闭枚举。
accidentTime	any/null	最大出险发生时间；格式由上游数据决定。
accidentRegion	any/null	最大出险发生地区。
vehicleDamageAmount	any/null	车辆损失金额。
personInjuryAmount	any/null	人员伤亡/人伤金额。
repairAgency	any/null	维修机构名称。
partsGroups	array	按维修操作分组的受损部件列表；无部件时为空数组。
lossPart	any/null	损失部位汇总；通常为逗号分隔文本，上游透传。

partsGroups[].parts[] 字段

字段	类型	中文含义
operation	any/null	维修操作，例如“更换”；上游透传，非封闭枚举。
parts	array	该操作对应的部件列表。
parts[].partIdentifier	any/null	部件名称或部件标识。
parts[].type	any/null	部件类型编码/名称；上游透传，非封闭枚举。
parts[].lossPartIdentifier	any/null	部件损失位置或标识。
parts[].flag	any/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****",
    "insuranceType":"商业险,主车",
    "accidentTime":"2019-01",
    "accidentRegion":"天津市津南区***",
    "vehicleDamageAmount":162337.0,
    "personInjuryAmount":5000.0,
    "repairAgency":"天津悦诚****公司",
    "partsGroups":[{"operation":"更换","parts":[{"partIdentifier":"仪表台扬声器（左）","type":1,"lossPartIdentifier":"内部","flag":""}]}],
    "lossPart":"内部,正前,底部,左前,顶部,右侧,左侧"
  },
  "request_id":"request-id"
}

partsGroups 始终为数组；部件项可能包含 partIdentifier、type、lossPartIdentifier、flag，缺失值为 null。

错误码

业务码与注意事项

0000 成功，0001 查无数据，4001 参数不正确，5001 服务处理失败，5002 供应商 Token 获取失败。认证层错误按公共鉴权文档处理，并保留 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，响应体不使用上述业务码。