车辆出险记录查验（简） - 天远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_code": "LSVxxxxxxxxxxxxxxxx" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | vin_code | string | 是 | 车辆识别代号 VIN 码 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 | 字段名 | 类型 | 说明 | |--------|------|------| | CarType | string | 车辆款型 | | FuelType | string | 燃料种类 | | TypeName | string | 类别名称 | | Displacement | string | 排量（单位：ml） | | BodyColor | string | 车身颜色 | | EngineNumber | string | 发动机号 | | DebutDate | string | 初登日期 | | PurchasePrice | string | 新车购置价（单位：元） | | CarAge | string | 车龄（单位：月） | | IfHighriskVehicle | string | 是否为高风险车辆名单（1：是，0：否） | | CommercialPolicyTime | string | 商业险保单倒计时（返回值：1:78 说明：1(商业险)+天数(最新保单终保时间-查询当前日期)；返回值：NULL 说明当期无商业险保单；返回值：2:null 说明：当期商业险保单天数小于0） | | CompulsoryPolicyTime | string | 交强险保单倒计时（返回值：3:78 说明：3(交强险)+天数(最新保单终保时间-查询当前日期）；返回值：NULL 说明当期无交强险保单；返回值：4:null 说明：当期交强险保单天数小于0） | | IfCarDamage | string | 是否投保车损险（1：是，0：否） | | IsConInsure | string | 是否为连续投保（1：连续，0：不连续） | | IfTuoBao | string | 历史是否脱保（1：是，0：否） | | TuoBaoTime | string | 历史最大脱保时间 | | CommercialPolicyDangerCount | string | 商业险出险（A:5说明：A(商业险+出险次数)） | | CompulsoryPolicyDangerCount | string | 交强险出险（固定返回：B:0，后续不再维护） | | MajorAccident | string | 重大事故标志（返回值：A:1,B:0,C:0,D:0。说明：A.碰撞+是否出过;B.火自燃+是否出过;C.水淹+是否出过;D.盗抢+是否出过；1: 是，0: 否） | | LossPart | string | 损失部位（返回值：5:1,6:1,7:1,8:1,10:1 说明：1.正前方+次数;2.正后方+次数;3.顶部+次数;4.底部+次数;5.前方左侧+次数;6.后方左侧+次数;7.中间左侧+次数;8.前方右侧+次数;9.后方右侧+次数;10.中间右侧+次数;11.内部+次数;12.其它+次数;13.null-不详+次数） | | CompensationRatioo | string | 最高车损险损失比例 | | Total | string | 车损险综合评分 | | IsLiabilityAvailable | string | 是否可以投保责任险（N：否，Y：是） | | IsExtendAvailable | string | 是否可以承保延保险（N：否，Y：是） | | EmiStandard | string | 排放标准（暂不返回） | | RatedCapacity | string | 载客人数（暂不返回） | | IsMajorAccidentData | string | 事故次数 | | IsMajorAccidentLevel | string | 事故等级 | | IsOperation | string | 是否为营运车辆（1：是，0：否） | | CompulsoryPolicyTransferCount | string | 交强险过户次数（固定返回为空，后续不再维护） | | CommercialPolicyTransferCount | string | 保险过户次数（返回：1:1；1：代表商业险代码，1：表示过户次数） | | LicensePlate | string | 车牌号 | | UsedCarPrice | string | 二手车价格 | | ThreeRisksDangerCount | string | 三者出险次数（固定返回为空，后续不再维护） | | TotalLoss | string | 全损（1：是 0：否） | | isCharge | string | 是否收费（true：收费，false：不计费） |