探针C风险评估 - 天远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" "authorized": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | mobile_no | string | 是 | 手机号 | | id_card | string | 是 | 身份证号 | | name | string | 是 | 姓名 | | authorized | string | 是 | 是否取得用户授权（"0":否，"1":是） | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

## 返回字段说明 ## 参数说明 | 参数 | 必选 | 类型 | 描述 | 说明 | |------|------|------|------|------| | result_code | 否 | string | 探查结果编码 | 1：A(Overdue)<br>2：B(Normal)<br>3：B(Delay)<br>4：U | | max_overdue_amt | 否 | string | 最大逾期金额 | 0 /【1~1000】 / （1000~2000】等金额区间 | | max_overdue_days | 否 | string | 最长逾期天数 | 0 /【1~15】/ 【16~30】等天数区间 | | latest_overdue_time | 否 | string | 最近逾期时间 | 时间精确到月，YYYY-MM | | max_performance_amt | 否 | string | 最大履约金额 | 0 /【1~1000】/ （1000~2000】等金额区间 | | latest_performance_time | 否 | string | 最近履约时间 | 时间精确到月，YYYY-MM | | count_performance | 否 | string | 履约笔数 | 0/1/2/3/… | | currently_overdue | 否 | string | 当前逾期机构数 | 0/1/2/3/… | | currently_performance | 否 | string | 当前履约机构数 | 0/1/2/3/… | | acc_exc | 否 | string | 异常还款机构数 | 0/1/2/3/… | | acc_sleep | 否 | string | 睡眠机构数 | 0/1/2/3/… | # 用户行为画像探查说明 ## result_code 探查结论参数说明 | 参数 | 说明 | |------|------| | A | 通过模型计算展现该用户行为画像，并给出具体行为明细（对应探查明细：Overdue） | | B | 通过模型计算展现该用户行为画像，并给出具体行为明细（对应探查明细：Normal/Delay） | | U | 用户数据不充分无法展现该用户行为画像（探查明细为空） | ## result_code 探查明细参数说明 | 参数 | 说明 | |------|------| | Normal | 多笔订单用户，最近一笔订单已结清，且历史所有订单均已结清；<br>单笔订单用户，该订单发生时间在3个月之内，且该订单结清 | | Delay | 用户最近一笔订单已结清，但历史存在未结清订单 | | Overdue | 用户最近一笔订单未结清 | ## 金额区间描述 | 金额区间（左开右闭区间） | |------------------------| | (1~1000] | | (1000~2000] | | (2000~3000] | | (3000~4000] | | (4000~6000] | | (6000~8000] | | (8000~10000] | | (10000~20000] | | (20000~40000] | | (40000~60000] | | (60000~80000] | | (80000~100000] | | (100000~150000] | | (150000~200000] | | (200000~250000] | | (250000~300000] | | (300000~350000] | | (350000~400000] | | (400000~450000] | | (450000~500000] | | (500000~550000] | | (550000~600000] | | (600000~650000] | | (650000~700000] | | (700000~750000] | | (750000~800000] | | (800000~850000] | | (850000~900000] | | (900000~950000] | | (950000~1000000] | | >1000000 |

## 响应示例 ### 成功响应 ```json { "max_performance_amt": "1000-2000", "count_performance": "1", "currently_overdue": "1", "max_overdue_amt": "1000-2000", "acc_sleep": "39", "currently_performance": "29", "result_code": "1", "latest_performance_time": "2018-10", "max_overdue_days": "1-15", "latest_overdue_time": "2018-10", "acc_exc": "0" } ```

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