天远风控决策 - 天远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 { "id_card": "string", "name": "string", "authorized": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |------------|--------|------|--------------| | id_card | string | 是 | 身份证号 | | name | string | 是 | 姓名 | | authorized | string | 是 | 身份授权 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

### 返回字段说明 | 名称 | 类型 | 说明 | | ---- | ---- | ---- | | reviewSuggestions | String | 审核建议:<br>A:严重逾期，建议拒绝<br>B:当前逾期，建议拒绝<br>C:欺诈风险，关注审核<br>D:轻微逾期，关注审核<br>E:正常用户<br>F:未命中 | | lastCondition | object | 最新欺诈/逾期状态 | | seriousOverdue | integer | 严重逾期>90天<br>1:命中;0:未命中 | | generalOverdue | integer | 一般逾期1-90天<br>1:命中;0:未命中 | | slightlOverdue | integer | 轻微逾期<br>1:命中;0:未命中 | | suspectFraud | integer | 疑似欺诈<br>1:命中;0:未命中 | | fraud | integer | 欺诈<br>1:命中;0:未命中 | | loanTypes | object | 黑名单类型 | | isBank | integer | 银行(含信用卡)<br>1:命中;0:未命中 | | isNetloan | integer | 网络贷款<br>1:命中;0:未命中 | | isSloan | integer | 小额贷款<br>1:命中;0:未命中 | | isConsume | integer | 消费金融<br>1:命中;0:未命中 | | isFinlea | integer | 融资租赁<br>1:命中;0:未命中 | | isAutofin | integer | 汽车金融<br>1:命中;0:未命中 | | isOther | integer | 其他<br>1:命中;0:未命中 | | blackOrgNum | String | 当前确认为黑名单的机构数 | | overdueAmt | String | 当前逾期金额 |