特殊名单 - 天远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)" } ```

## 返回字段说明 # 5. 返回参数说明 ## result 参数说明（Object） | 字段名 | 类型 | 说明 | |---|---|---| | RiskStrategy | object | 策略说明，详见【RiskStrategy 字段说明】 | | Rule | object | 规则说明，详见【Rule 字段说明】 | | SpecialList_c | object | 特殊名单结果列表，详见【SpecialList_c 字段说明】 | --- ## RiskStrategy 字段说明（Object） | 字段名 | 类型 | 说明 | |---|---|---| | final_decision | string | 最终决策结果：<br>• Accept：通过<br>• Reject：拒绝<br>• Review：复议<br>• 空：无建议 | | platform | string | 策略使用平台：android / ios / web / 线下 | | scene | string | 策略使用事件类型：<br>• lend：借款<br>• register：注册<br>• login：登录<br>• cash：提现 | | product_name | string | 策略产品名称 | | product_type | string | 策略产品类型编号：<br>• 100081：线上现金分期<br>• 100082：线下现金分期<br>• 100084：信用卡（类信用卡）<br>• 100085：线上小额现金贷<br>• 100086：汽车金融<br>• 100087：线下消费分期<br>• 100099：其他 | | Rule | object | 策略规则，详见下文 | | weight | string | 规则集决策权重，取值范围：>0 的整数 | | decision | string | 规则集决策结果：<br>• weight = 0 → Accept（通过）<br>• weight ≥ 80 → Reject（拒绝）<br>• 0 < weight < 80 → Review（复议） | --- ## Rule 字段说明（Object） | 字段名 | 类型 | 说明 | |---|---|---| | result | object | 规则结果 | | final_decision | string | 最终决策结果：<br>• final_weight ≥ 80 → Reject（拒绝）<br>• 0 < final_weight < 80 → Accept（通过） | | final_weight | string | 最终规则评分，取值范围：>0 的整数 | | hit_rules | object | 命中规则详情 | | rulespeciallist_c | object | 命中特殊名单规则详情 | ### hit_rules / rulespeciallist_c 内部结构 | 字段名 | 类型 | 说明 | |---|---|---| | odr0000331 / ... | object | 命中规则标识 | | name_rule | string | 命中规则名称 | | weight | string | 命中规则权重 | --- ## SpecialList_c 参数说明（Object） ### 查询维度 | 字段名 | 类型 | 说明 | |---|---|---| | id | object | 按身份证维度查询结果 | | cell | object | 按手机号维度查询结果 | --- ### 一、特殊名单命中标识（是否命中） | 字段名 | 类型 | 说明 | |---|---|---| | court_bad | string | 法院失信人：0 命中，空 未命中 | | court_executed | string | 法院被执行人：0 命中，空 未命中 | | bank_bad | string | 银行（含信用卡）中风险：0 命中，空 未命中 | | bank_overdue | string | 银行（含信用卡）一般风险：0 命中，空 未命中 | | bank_lost | string | 银行（含信用卡）高风险：0 命中，空 未命中 | | nbank_bad | string | 非银（全部）中风险：0 命中，空 未命中 | | nbank_overdue | string | 非银（全部）一般风险：0 命中，空 未命中 | | nbank_lost | string | 非银（全部）高风险：0 命中，空 未命中 | | nbank_nsloan_bad | string | 持牌网络小贷中风险：0 命中，空 未命中 | | nbank_nsloan_overdue | string | 持牌网络小贷一般风险：0 命中，空 未命中 | | nbank_nsloan_lost | string | 持牌网络小贷高风险：0 命中，空 未命中 | | nbank_sloan_bad | string | 持牌小贷中风险：0 命中，空 未命中 | | nbank_sloan_overdue | string | 持牌小贷一般风险：0 命中，空 未命中 | | nbank_sloan_lost | string | 持牌小贷高风险：0 命中，空 未命中 | | nbank_cons_bad | string | 持牌消费金融中风险：0 命中，空 未命中 | | nbank_cons_overdue | string | 持牌消费金融一般风险：0 命中，空 未命中 | | nbank_cons_lost | string | 持牌消费金融高风险：0 命中，空 未命中 | | nbank_finlea_bad | string | 持牌融资租赁中风险：0 命中，空 未命中 | | nbank_finlea_overdue | string | 持牌融资租赁一般风险：0 命中，空 未命中 | | nbank_finlea_lost | string | 持牌融资租赁高风险：0 命中，空 未命中 | | nbank_autofin_bad | string | 持牌汽车金融中风险：0 命中，空 未命中 | | nbank_autofin_overdue | string | 持牌汽车金融一般风险：0 命中，空 未命中 | | nbank_autofin_lost | string | 持牌汽车金融高风险：0 命中，空 未命中 | | nbank_other_bad | string | 非银其他中风险：0 命中，空 未命中 | | nbank_other_overdue | string | 非银其他一般风险：0 命中，空 未命中 | | nbank_other_lost | string | 非银其他高风险：0 命中，空 未命中 | --- ### 二、特殊名单命中次数 | 字段名 | 类型 | 说明 | |---|---|---| | court_bad_allnum | string | 法院失信人命中次数 | | court_executed_allnum | string | 法院被执行人命中次数 | | bank_bad_allnum | string | 银行中风险命中次数 | | bank_overdue_allnum | string | 银行一般风险命中次数 | | bank_lost_allnum | string | 银行高风险命中次数 | | nbank_bad_allnum | string | 非银中风险命中次数 | | nbank_overdue_allnum | string | 非银一般风险命中次数 | | nbank_lost_allnum | string | 非银高风险命中次数 | | nbank_nsloan_bad_allnum | string | 持牌网络小贷中风险命中次数 | | nbank_nsloan_overdue_allnum | string | 持牌网络小贷一般风险命中次数 | | nbank_nsloan_lost_allnum | string | 持牌网络小贷高风险命中次数 | | nbank_sloan_bad_allnum | string | 持牌小贷中风险命中次数 | | nbank_sloan_overdue_allnum | string | 持牌小贷一般风险命中次数 | | nbank_sloan_lost_allnum | string | 持牌小贷高风险命中次数 | | nbank_cons_bad_allnum | string | 持牌消费金融中风险命中次数 | | nbank_cons_overdue_allnum | string | 持牌消费金融一般风险命中次数 | | nbank_cons_lost_allnum | string | 持牌消费金融高风险命中次数 | | nbank_finlea_bad_allnum | string | 持牌融资租赁中风险命中次数 | | nbank_finlea_overdue_allnum | string | 持牌融资租赁一般风险命中次数 | | nbank_finlea_lost_allnum | string | 持牌融资租赁高风险命中次数 | | nbank_autofin_bad_allnum | string | 持牌汽车金融中风险命中次数 | | nbank_autofin_overdue_allnum | string | 持牌汽车金融一般风险命中次数 | | nbank_autofin_lost_allnum | string | 持牌汽车金融高风险命中次数 | | nbank_other_bad_allnum | string | 非银其他中风险命中次数 | | nbank_other_overdue_allnum | string | 非银其他一般风险命中次数 | | nbank_other_lost_allnum | string | 非银其他高风险命中次数 | --- ### 三、特殊名单距今天数（单位：年） | 字段名 | 类型 | 说明 | |---|---|---| | court_bad_time | string | 法院失信人最近一次命中距今时间 | | court_executed_time | string | 法院被执行人最近一次命中距今时间 | | bank_bad_time | string | 银行中风险最近一次命中距今时间 | | bank_overdue_time | string | 银行一般风险最近一次命中距今时间 | | bank_lost_time | string | 银行高风险最近一次命中距今时间 | | nbank_bad_time | string | 非银中风险最近一次命中距今时间 | | nbank_overdue_time | string | 非银一般风险最近一次命中距今时间 | | nbank_lost_time | string | 非银高风险最近一次命中距今时间 | | nbank_nsloan_bad_time | string | 持牌网络小贷中风险最近一次命中距今时间 | | nbank_nsloan_overdue_time | string | 持牌网络小贷一般风险最近一次命中距今时间 | | nbank_nsloan_lost_time | string | 持牌网络小贷高风险最近一次命中距今时间 | | nbank_sloan_bad_time | string | 持牌小贷中风险最近一次命中距今时间 | | nbank_sloan_overdue_time | string | 持牌小贷一般风险最近一次命中距今时间 | | nbank_sloan_lost_time | string | 持牌小贷高风险最近一次命中距今时间 | | nbank_cons_bad_time | string | 持牌消费金融中风险最近一次命中距今时间 | | nbank_cons_overdue_time | string | 持牌消费金融一般风险最近一次命中距今时间 | | nbank_cons_lost_time | string | 持牌消费金融高风险最近一次命中距今时间 | | nbank_finlea_bad_time | string | 持牌融资租赁中风险最近一次命中距今时间 | | nbank_finlea_overdue_time | string | 持牌融资租赁一般风险最近一次命中距今时间 | | nbank_finlea_lost_time | string | 持牌融资租赁高风险最近一次命中距今时间 | | nbank_autofin_bad_time | string | 持牌汽车金融中风险最近一次命中距今时间 | | nbank_autofin_overdue_time | string | 持牌汽车金融一般风险最近一次命中距今时间 | | nbank_autofin_lost_time | string | 持牌汽车金融高风险最近一次命中距今时间 | | nbank_other_bad_time | string | 非银其他中风险最近一次命中距今时间 | | nbank_other_overdue_time | string | 非银其他一般风险最近一次命中距今时间 | | nbank_other_lost_time | string | 非银其他高风险最近一次命中距今时间 | > 说明： > - 命中标识字段：`0` 表示命中，`空` 表示未命中 > - 命中次数字段：返回具体命中次数（1–N） > - 距今天数字段：返回最近一次命中距离查询时间的年份数（0–N 年）