品牌维保（4S）动态计价 - 天远数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | Access-Id | string | 是 | 账号的 Access-Id | 对于业务请求参数 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`，以此方式进行传参。 ```json { "data": "xxxx(base64)" } ``` 对接响应得到的公共参数 ```json { "code": "int", "message": "string", "transaction_id": "string", "data": "string" } ``` **data** 字段为加密的数据，需要解密后查看。 ## 加密和解密机制 账户获得的密钥（**Access Key**）是一个 16 进制字符串，使用 AES-128 加密算法。 ### 加密过程： - 加密模式：**AES-CBC 模式**。 - 密钥长度：**128 位（16 字节）**。 - 填充方式：**PKCS7 填充**。 - **IV（初始化向量）**：IV 长度为 16 字节（128 位），每次加密时随机生成。 - 加密后，将 **IV** 和密文拼接在一起进行传输。 - 最后，将拼接了 IV 的密文通过 **Base64 编码**，方便在网络或文件中传输。 ### 解密过程： - 解密时，首先从 Base64 解码后的数据中提取前 16 字节作为 **IV**。 - 然后使用提取的 **IV**，通过 AES-CBC 模式解密剩余部分的密文。 - 解密后去除 **PKCS7 填充**，即可得到原始明文。 ## 计费说明 - 本产品为**动态计费**：按车架号对应品牌价格收取，详见产品内容中的品牌价格表。 - 请求时按测算金额预冻结，异步回调成功后结算；失败或空结果按业务规则解冻/不计费。 ## 异步说明 本接口为异步查询。 - 请求请传 `out_order_no`（您的业务订单号）与 `notify_url`。 - 首次响应解密后回传 `out_order_no`，用于关联后续回调。 - 回调外层包含 `out_order_no`；不返回内部单号及上游 `order_id` / `order_no`。 ```json { "out_order_no": "您的业务订单号" } ``` 回调示例： ```json { "code": 0, "message": "成功", "out_order_no": "您的业务订单号", "transaction_id": "回调流水号", "data": "AES加密后的业务报告", "product_code": "产品码" } ```

## 请求参数 ```json { "vin": "LFVxxxxxxx", "img_url": "https://example.com/xsz.jpg", "out_order_no": "YOUR_ORDER_NO", "report_type": "url", "notify_url": "https://your.domain/callback" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | vin | string | 是 | 车架号（17位） | | img_url | string | 否 | 行驶证图片地址（URL） | | out_order_no | string | 是 | 用户自定义业务订单号，请确保唯一，最长不超过64位；用于关联请求与回调 | | report_type | string | 是 | 数据格式：url、json | | notify_url | string | 是 | 数据异步回调地址 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 首次响应（解密后） | 字段名 | 类型 | 说明 | |--------|------|------| | out_order_no | string | 用户业务订单号（同请求 out_order_no） | ### 异步回调外层 推送方式：POST，Content-Type: application/json 商户接收到回调后需响应 `success` 或 `ok`，否则将按频率重推。 | 字段名 | 类型 | 说明 | |--------|------|------| | code | int | 业务状态码：0 成功；1000 查询为空；2001 业务失败；1001 接口异常 | | message | string | 状态说明 | | transaction_id | string | 本次回调流水号 | | data | string | AES 加密后的报告内容（Base64）；失败或为空时可能为空字符串 | | product_code | string | 产品码，固定为 QCXGF1IG | ### data 解密后（report 业务内容） | 字段名 | 类型 | 说明 | |--------|------|------| | （报告内容） | object | 报告内容；具体结构随 report_type（url/json）由上游返回 |