车型识别普通 - 天远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 { "vin": "LVSHJCACXDE249895" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | vin | string | 是 | 车架号码 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 解密后业务字段。report_type 为 url 时返回 reportUrl；为 json 时返回车型明细字段。 | 字段名 | 类型 | 说明 | |--------|------|------| | reportUrl | string | 报告链接地址（report_type 为 url 时） | | vin | string | 车架号 | | brand | string | 品牌 | | vehicleType | string | 车辆类型 | | effluentStandard | string | 环保标准 | | engineModel | string | 发动机型号 | | cc | string | 排量(L) | | modelDate | string | 年款 | | guochanhezijinkou | string | 国产合资进口 | | newChexi | string | 新标准的车系 | | newtagName | string | 新车车系名称 | | changjia | string | 厂商 | | chexi | string | 车系 | | xiaoshoumingcheng | string | 销售名称 | | ranyouleixing | string | 燃料形式 | | ranyoubiaohao | string | 燃油标号 | | dangweishu | string | 挡位个数 | | zhulileixing | string | 助力类型 | | zhouju | string | 轴距(mm) | | chemenshu | string | 车门数 | | zuoweishu | string | 座位数 | | qudongxingshi | string | 驱动方式 | | disabled | string | 状态 | | new_chexing | string | 新车车型 | | chezubianma | string | 车组编码 | | chezumingcheng | string | 车组名称 | | chexingdaima | string | 车型代码 | | beizhu | string | 备注 | | shangshinianfen | string | 上市年份 | | gonglv | string | 功率 | | groupId | string | 车组ID | | ansFlag | string | 轮胎标志 | | valveNum | string | 发动机气门数 | | familyName | string | 车系名称 | | displacement | string | 排量 | | vehicleId | string | 车型ID | | brandCode | string | 品牌编码 | | cylinderNum | string | 气缸数 | | familyId | string | 车系id | | cfgLevel | string | 配置等级 |