AutoBigData 开放平台

切换主题

CIECC赛克数据出险报告（商务部下属中心） ​

适用场景 ​

  • 二手车交易前深度核查：为收车、置换和交付前申请完整出险报告。
  • 高风险车辆复核：对高价值、事故线索或客户争议车辆发起报告申请。
  • 风控流程留痕：保存订单号、申请状态和报告结果，形成可追溯审核记录。
  • 客户交付与售后解释：将报告用于车况披露、价格沟通和争议处理。

接口地址 ​

POST /api/v1/veh-claims/swb

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

请求参数 ​

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

json
{
  "vin":"1HGBH41JXMN00****",
  "authName":"<AUTHORIZER_NAME>",
  "drivingPicUrl":"https://<YOUR_PUBLIC_HOST>/driving-license.jpg",
  "authPdfUrl":"https://<YOUR_PUBLIC_HOST>/authorization.pdf",
  "rightsType":"购买",
  "clientNotifyUrl":"https://<YOUR_PUBLIC_HOST>/callbacks/claim"
}
字段类型必填说明
vinstring是17 位 VIN；服务会去除空格并转为大写。
authNamestring是授权人姓名，2 至 50 个字符。
drivingPicUrlstring是行驶证图片公网 HTTPS 地址。
authPdfUrlstring是授权文件公网 HTTPS 地址。
rightsTypestring是购买、受赠、继承 或 其他。
clientNotifyUrlstring否接收结果通知的公网 HTTPS 地址，不含用户名、密码或片段。

图片和 PDF 地址必须可从公网 HTTPS 访问，不能指向私网、保留地址或带账号密码的 URL。出险下单可能产生供应商费用，只能使用已获授权的测试素材。

响应字段 ​

通用响应字段 ​

字段类型中文含义
codestring业务状态码：0000 已受理/查询中、4001 参数或文件地址错误、5001 服务处理失败。认证层拒绝时不使用该业务信封。
messagestring业务处理结果说明；成功、无数据或失败时由服务返回相应文字。
dataobject/array/null业务结果。成功时为对象或数组；查无数据或业务失败时通常为 null。
request_idstring请求链路标识，用于问题排查；不要用它替代密钥或 Token。

data 字段 ​

字段类型中文含义
orderIdstring出险报告订单号；后续查询和回调关联使用。
statusstring订单状态。当前下单响应固定为 processing（处理中/已受理）。

示例 ​

示例入参和 curl ​

以下入参沿用当前 Swagger 默认示例。出险下单可能产生供应商费用，不属于免费接口探针；只有在确认已获授权并接受费用后才执行。

bash
curl -X POST \
  "接口地址详见合作邮件通知" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"vin":"1HGBH41JXMN00****",
  "authName":"水木思源（天津）科技有限公司",
  "drivingPicUrl":"https://<占位示意>.jpg",
  "authPdfUrl":"https://<占位示意>.pdf",
  "rightsType":"购买",
  "clientNotifyUrl":"https://<占位示意>"}'

成功响应 ​

以下为按默认测试入参整理的受理响应示例；订单号由服务生成，实际值以接口返回为准。

json
{
  "code":"0000",
  "message":"成功",
  "data":{
    "orderId":"<ORDER_ID>",
    "status":"processing"
  },
  "request_id":"request-id"
}

请立即在客户服务端安全保存 orderId。然后按照出险结果取回的，使用 orderId 取回报告。

错误码 ​

业务码与注意事项 ​

0000 表示已受理，4001 表示 VIN、URL、文件或授权参数不正确，5001 表示服务处理失败。认证层错误按 401、403、429、503 处理。不要自动重试未知响应或已经可能送达供应商的请求。

VIN 格式错误（HTTP 400） ​

请求：{"vin":"INVALID","authName":"示例授权人","drivingPicUrl":"https://files.example/driving.jpg","authPdfUrl":"https://files.example/auth.pdf","rightsType":"购买"}

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

图片、授权文件或回调地址不可用（HTTP 400） ​

json
{"code":"4001","message":"图片地址不可用","data":null,"request_id":"request-id"}
json
{"code":"4001","message":"授权文件不可用","data":null,"request_id":"request-id"}
json
{"code":"4001","message":"回调地址不可用","data":null,"request_id":"request-id"}

服务或订单文件不可用（HTTP 503） ​

json
{"code":"5001","message":"订单服务暂不可用","data":null,"request_id":"request-id"}
json
{"code":"5001","message":"订单文件服务暂不可用","data":null,"request_id":"request-id"}

供应商响应未知（HTTP 200） ​

当请求可能已经送达但响应无法确认时，服务会保留订单并返回查询中，不能据此自动再次下单：

json
{"code":"0000","message":"查询中","data":{"orderId":"<ORDER_ID>","status":"processing"},"request_id":"request-id"}

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

出险结果取回接口地址 ​

GET /api/v1/veh-claims/swb/{orderId}

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

调用时机 ​

在回调地址收到回调通知后 或者 没有提供回调地址的，可以主动轮询。

请求参数 ​

本接口使用客户级 Token，与出险下单使用同一套 Token 兑换流程。当前版本下单响应只返回 orderId 和 status。

http
GET /api/v1/veh-claims/swb/<ORDER_ID>
Authorization: Bearer <ACCESS_TOKEN>
Accept: application/json

客户级 Token 必须属于创建该订单的 AppKey，并且该 AppKey 已获得 /api/v1/veh-claims/swb/{orderId} 精确路径授权。GET 请求没有 JSON 请求体，不要把 Token 放入 URL、日志或前端页面。

响应字段 ​

通用响应字段 ​

字段类型中文含义
codestring业务状态码：0000 查询成功、4001 请求或订单号错误、5001 订单/服务处理失败。认证层拒绝时不使用该业务信封。
messagestring业务处理结果说明；成功、无数据或失败时由服务返回相应文字。
dataobject/array/null业务结果。成功时为对象或数组；查无数据或业务失败时通常为 null。
request_idstring请求链路标识，用于问题排查；不要用它替代密钥或 Token。

data 字段 ​

字段类型中文含义
orderIdstring出险报告订单号。
statusstring订单状态：processing 处理中、completed 已完成、failed 失败。
htmlstring/null报告 HTML 正文；处理中或失败时可能为 null。
htmlurlstring/null报告 HTML 的 HTTPS 签名访问链接；完成前或失败时可能为 null。
picUrlstring/null报告图片的 HTTPS 签名访问链接；完成前或失败时可能为 null。

status 是代码明确限定的枚举；当状态为 failed 时不得把空链接解释为成功。

示例 ​

示例入参和 curl ​

查询示例需要使用已成功下单后返回的 orderId，不会自动创建订单，因此不产生下单费用。

bash
curl -X GET \
  "接口地址详见合作邮件通知" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Accept: application/json"

成功响应 ​

以下为按已成功下单后获得的订单号整理的状态示例；订单号、报告正文和链接均为占位值，实际结果以接口返回为准。

处理中：

json
{
  "code":"0000",
  "message":"处理中",
  "data":{"orderId":"<ORDER_ID>","status":"processing"},
  "request_id":"request-id"
}

完成时：

json
{
  "code":"0000",
  "message":"完成",
  "data":{
    "orderId":"<ORDER_ID>",
    "status":"completed",
    "html":"<REPORT_HTML_OR_NULL>",
    "htmlurl":"https://<SIGNED_REPORT_URL>",
    "picUrl":"https://<SIGNED_IMAGE_URL>"
  },
  "request_id":"request-id"
}

htmlurl 和 picUrl 是有效期约 31 天的 HTTPS 签名链接。status=failed 时按失败处理，不要把空链接当成成功。

错误码 ​

业务码与注意事项 ​

0000 表示请求成功并返回当前状态，4001 表示订单号或请求不正确，5001 表示服务处理失败。Token 缺失、过期或不属于该订单时通常返回 401 或 403；不存在或不可访问的订单也可能使用泛化错误响应。排查时提供 request_id，不要提供订单 Token。

订单已失败（HTTP 200） ​

json
{"code":"5001","message":"订单提交失败","data":{"orderId":"<ORDER_ID>","status":"failed","html":null,"htmlurl":null,"picUrl":null},"request_id":"request-id"}

订单不存在或不属于当前客户（HTTP 401） ​

json
{"code":"authentication_rejected","message":"authentication rejected","request_id":"request-id"}

服务不会通过错误信息泄露订单是否存在；订单号错误、订单属于其他客户、Token 缺失或过期，都可能呈现为认证失败。

订单服务暂不可用（HTTP 503） ​

json
{"code":"service_unavailable","message":"service unavailable","request_id":"request-id"}

报告仍在处理（HTTP 200） ​

json
{"code":"0000","message":"查询中","data":{"orderId":"<ORDER_ID>","status":"processing","html":null,"htmlurl":null,"picUrl":null},"request_id":"request-id"}

无路径权限、限流和认证依赖不可用时分别为 HTTP 403、429、503；查询接口继续使用创建订单客户的客户级 Token。

Copyright © 2026 北京奥图德塔咨询有限公司 All rights reserved. 网站备案号 京ICP备16010040号-1