人车核验加强版 - 海宇数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 填充**，即可得到原始明文。

## 请求参数 明文 JSON 入参（加密前）： ```json { "plate_no": "string", "name": "string", "plate_type": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |-------------|--------|------|------| | plate_no | string | 是 | 车牌号，用于唯一标识车辆 | | name | string | 是 | 姓名 | | plate_type | string | 否 | 车牌类型，见下表。不传时默认为 `02`（小型汽车/蓝牌） | ### 车牌类型（plate_type）编码表 | 编码 | 车牌类型 | 说明 | |------|----------------|------| | 02 | 小型汽车 | **默认值**，蓝牌 | | 01 | 大型汽车 | 黄牌 | | 03 | 使馆汽车 | | | 04 | 领馆汽车 | | | 05 | 境外汽车 | | | 06 | 外籍汽车 | | | 07 | 普通摩托车 | | | 08 | 轻便摩托车 | | | 09 | 使馆摩托车 | | | 10 | 领馆摩托车 | | | 11 | 境外摩托车 | | | 12 | 外籍摩托车 | | | 13 | 低速车 | | | 14 | 拖拉机 | | | 15 | 挂车 | | | 16 | 教练汽车 | | | 17 | 教练摩托车 | | | 20 | 临时入境汽车 | | | 21 | 临时入境摩托车 | | | 22 | 临时行驶车 | | | 23 | 警用汽车 | | | 24 | 警用摩托 | | | 38 | 预留 | | | 51 | 新能源大型车 | 黄绿双拼 | | 52 | 新能源小型车 | 绿牌 | > **注意**：`plate_type` 须与车辆实际号牌类型一致。例如蓝牌小型车请勿传 `01`，否则 ETC 数据源可能查无结果，将自动降级至行驶证信息核验。 ## 请求体 将上述 JSON 使用 Access Key 进行 AES 加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 返回参数说明 | 参数名 | 类型 | 描述 | |--------|--------|--------------------------| | status | string | 验证结果（1：一致，2：不一致） |