VIN查询车辆信息 10183 - 天远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 { "mobile_no": "string", "id_card": "string", "name": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | mobile_no | string | 是 | 手机号 | | id_card | string | 是 | 身份证号 | | name | string | 是 | 姓名 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ### 返回参数说明 | 参数名 | 类型 | 描述 | |-----------------------------|---------|------| | color | string | 颜色 | | brand_id | int | 品牌（厂商）ID | | series_id | int | 车系 ID | | model_id | int | 车型 ID | | brand_name | string | 厂商（品牌）名称 | | series_name | string | 车系名称 | | model_name | string | 车型名称 | | vehicle_type | int | 车辆种类<br>取值说明：<br>• `1` - 乘用车<br>• `2` - 商用车<br>• `3` - 摩托车 | | model_year | int | 车型年款 | | model_price | float | 车型指导价（单位：万元） | | model_liter | string | 排量 | | model_gear | string | 变速箱类型 | | model_emission_standard | string | 排放标准 | | min_reg_year | int | 最小上牌年份 | | max_reg_year | int | 最大上牌年份 | | make_date | string | 出厂日期 | | series_group_name | string | 车系组名 | | seat_number | string | 座位数 | | response | string | 返回详情 | | fuel_type_s | string | 燃料种类（仅商用车返回） | | emission_standards_s | string | 排放标准（仅商用车返回） | | cargo_length_s | string | 货箱长度（mm）（仅商用车返回） | | cargo_width_s | string | 货箱宽度（mm）（仅商用车返回） | | cargo_height_s | string | 货箱高度（mm）（仅商用车返回） | | model_code_s | string | 公告型号（仅商用车返回） | | car_length_s | string | 车身长度（mm）（仅商用车返回） | | car_width_s | string | 车身宽度（mm）（仅商用车返回） | | car_height_s | string | 车身高度（mm）（仅商用车返回） | | car_weight_s | string | 整车重量（kg）（仅商用车返回） | | rated_load_s | string | 额定载重（kg）（仅商用车返回） | | total_mass_s | string | 总质量（kg）（仅商用车返回） | | total_traction_mass_s | string | 牵引总质量（kg）（仅商用车返回） | | rated_passenger_s | string | 额定载客（仅商用车返回） | | axle_count_s | string | 轴数（仅商用车返回） | | engine_position_s | string | 发动机形式（仅商用车返回） | | maker_c | string | 厂商（仅乘用车返回） | | body_dim_c | string | 长*宽*高(mm)（仅乘用车返回） | | seat_count_c | string | 座位数(个)（仅乘用车返回） | | car_weight_c | string | 整备质量(kg)（仅乘用车返回） | | total_mass_c | string | 总质量(kg)（仅乘用车返回） | | car_payload_c | string | 最大载重质量(kg)（仅乘用车返回） | | fuel_type_c | string | 燃料形式（仅乘用车返回） | | car_width_c | string | 宽度(mm)（仅乘用车返回） | | car_length_c | string | 长度(mm)（仅乘用车返回） | | car_height_c | string | 高度(mm)（仅乘用车返回） | | engine_type_c | string | 发动机型号（仅乘用车返回） | | cargo_dim_c | string | 货箱尺寸（mm）（仅乘用车返回） | | engine_number | string | 发动机号 | | notice_code | string | 公告号 | | notice_vehicle_name_s | string | 车辆类型（仅商用车返回） |