名下车辆详版 - 天远API

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "vehicle_type": "string", "id_card": "string", "name": "string" "user_type": "string" "authorized": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | vehicle_type| string | 否 | 车辆类型 0-客车；1-货车；2-全部；默认查全部 | | id_card | string | 是 | 身份证号 | | name | string | 否 | 姓名 | | user_type | string | 否 | 查询人关系类型：1-ETC 开户人；2-车辆所有人；3-ETC 经办人(默认未1-ETC 开户人) | | authorized | string | 是 | 是否取得用户授权（0:否，1:是） | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ## 车辆信息查询结果字段说明 | 字段名 | 数据类型 | 描述 | |--------|----------|------| | vehicleCount | Integer | 车辆数 | | list | Array | 车辆列表 | ## 车辆列表(list)元素字段说明 | 字段名 | 数据类型 | 描述 | 取值说明 | |--------|----------|------|----------| | plateNum | String | 车牌号 | - | | plateColor | Integer | 车牌颜色 | 0:蓝色<br>1:黄色<br>2:黑色<br>3:白色<br>4:渐变绿色<br>5:黄绿双拼色<br>6:蓝白渐变色<br>7:临时牌照<br>11:绿色<br>12:红色 | | vehicleType | Integer | 车辆类型 | 1:一型客车<br>2:二型客车<br>3:三型客车<br>4:四型客车<br>11:一型货车<br>12:二型货车<br>13:三型货车<br>14:四型货车<br>15:五型货车<br>16:六型货车<br>21:一型专项作业车<br>22:二型专项作业车<br>23:三型专项作业车<br>24:四型专项作业车<br>25:五型专项作业车<br>26:六型专项作业车 |

## 响应示例 ### 成功响应 ```json { "vehicleCount": 1, "list": [ { "plateNum": "粤A1***5", "vehicleType": 1, "plateColor": 0 }, { "plateNum": "粤B1***5", "vehicleType": 1, "plateColor": 0 } ] } ```

## 错误代码 | code | message | |------|---------| | 0 | 业务成功 | | 1000 | 查询为空 | | 1001 | 接口异常 | | 1002 | 参数解密失败 | | 1003 | 基础参数校验不正确 | | 1004 | 未经授权的IP | | 1005 | 缺少Access-Id | | 1006 | 未经授权的AccessId | | 1007 | 账户余额不足，无法请求 | | 1008 | 未开通此产品 | | 2001 | 业务失败 |