天远风控车险核验

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "VINCode": "string", "Authorized": "string" } ``` | 名称 | 类型 | 是否必填 | 说明 | |------------|--------|----------|----------------------------------------| | VINCode | String | 是 | 车辆识别代号 VIN 码 | | Authorized | String | 是 | 是否取得用户授权（0:否，1:是） | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

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

## 响应示例 ### 成功响应 ```json{ "code": "200", "data": { "TypeName": "", "ThreeRisksDangerCount": "C:1.00", "CommercialPolicyTransferCount": "1:2", "TuoBaoTime": "大于180天", "PurchasePrice": "129800.00", "CarAge": "144", "CompensationRatioo": "1.0%", "IsExtendAvailable": "", "FuelType": "燃油", "EngineNumber": "D410556", "IfTuoBao": "1", "RatedCapacity": "", "CommercialPolicyDangerCount": "A:2", "BodyColor": "无", "CompulsoryPolicyTransferCount": "2:1", "DebutDate": "2013-03-26 00:00:00", "MajorAccident": "A:0,B:0,C:0,D:0", "CommercialPolicyTime": "1:30", "CompulsoryPolicyDangerCount": "B:1", "TotalLoss": "0", "LicensePlate": "湘***03", "IfCarDamage": "0", "IsMajorAccidentData": "3", "EmiStandard": "", "Displacement": "", "UsedCarPrice": "17123.216", "CompulsoryPolicyTime": "3:30", "IsConInsure": "0", "LossPart": "13:1", "IfHighriskVehicle": "0", "IsLiabilityAvailable": "N", "IsMajorAccidentLevel": "一般", "Total": "261.21", "CarType": "江淮***0K1F", "IsOperation": "0" }, "message": "success", "success": true } ```

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