消金报告（标准版） - 海宇数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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)" } ```

# DWBGYL29 返回字段说明 ## 接口说明 `DWBGYL29` 为消费金融报告（专业版）聚合接口。后端并发调用 3 个子接口，并将结果保存为一份报告： | 子节点 | 子接口 | 说明 | |---|---|---| | `risk_radar` | `JRZQNKEI` | 风险全景雷达 | | `consumer_finance_profile` | `JRZQ3C7P` | 海宇消金画像核验 | | `risk_probe` | `JRZQI079` | 风险探针 C | ## 顶层返回字段 | 字段名 | 类型 | 说明 | |---|---|---| | `api_code` | string | 当前聚合接口编码，固定为 `DWBGYL29` | | `report_id` | string | 报告唯一编号，后端随机生成 | | `reportId` | string | 报告唯一编号，值与 `report_id` 一致 | | `report_no` | string | 报告展示编号，格式为 `RPT-DWBGG9HK-yyyyMMddHHmmss` | | `generated_at` | string | 报告生成时间，格式为 `yyyy-MM-dd HH:mm:ss` | | `reportTime` | string | 报告生成时间，值与 `generated_at` 一致 | | `reportUrl` | string | 报告查看地址，打开后渲染消费金融专业版 HTML 报告 | | `profile` | object | 脱敏后的查询主体信息 | | `source_data` | object | 3 个子接口的原始响应数据集合 | `reportUrl` 路由为 `/reports/dwbg/{reportId}`。配置 `API_PUBLIC_BASE_URL` 后返回完整外部地址，否则返回站内相对路径。 ## profile 字段说明 | 字段名 | 类型 | 说明 | |---|---|---| | `profile.name` | string | 脱敏姓名 | | `profile.id_card` | string | 脱敏身份证号 | | `profile.mobile_no` | string | 脱敏手机号 | ## source_data 字段说明 | 字段名 | 类型 | 说明 | |---|---|---| | `source_data.risk_radar` | object | 风险全景雷达原始响应，通常包含 `result` 对象 | | `source_data.consumer_finance_profile` | object | 海宇消金画像核验原始响应，返回扁平化画像字段 | 子接口调用失败时，对应节点不会影响其他节点返回，节点结构如下： | 字段名 | 类型 | 说明 | |---|---|---| | `success` | boolean | 固定为 `false` | | `error` | string | 子接口错误信息 | ## risk_radar.result 字段 ### 申请雷达（apply_report_detail） | 字段名 | 类型 | 说明 | |---|---|---| | `A22160001` | string | 申请准入分（1-1000） | | `A22160002` | string | 申请准入置信度（50-100） | | `A22160003` | string | 申请命中机构数 | | `A22160004` | string | 申请命中消金类机构数 | | `A22160005` | string | 申请命中网络贷款类机构数 | | `A22160006` | string | 机构总查询次数 | | `A22160007` | string | 最近一次查询时间，格式 `yyyy-mm` | | `A22160008` | string | 近 1 个月机构总查询笔数 | | `A22160009` | string | 近 3 个月机构总查询笔数 | | `A22160010` | string | 近 6 个月机构总查询笔数 | ### 信用现状（current_report_detail） | 字段名 | 类型 | 说明 | |---|---|---| | `C22180001` | string | 网贷授信额度 | | `C22180002` | string | 网贷额度置信度 | | `C22180003` | string | 网络贷款类机构数 | | `C22180004` | string | 网络贷款类产品数 | | `C22180005` | string | 网贷机构最大授信额度 | | `C22180006` | string | 网贷机构平均授信额度 | | `C22180007` | string | 消金贷款类机构数 | | `C22180008` | string | 消金贷款类产品数 | | `C22180009` | string | 消金机构最大授信额度 | | `C22180010` | string | 消金机构平均授信额度 | | `C22180011` | string | 消金建议授信额度 | | `C22180012` | string | 消金额度置信度 | ### 借贷行为（behavior_report_detail） | 字段范围 | 类型 | 说明 | |---|---|---| | `B22170001` | string | 贷款行为分（1-1000） | | `B22170002`-`B22170006` | string | 近 1/3/6/12/24 个月贷款笔数 | | `B22170007`-`B22170011` | string | 近 1/3/6/12/24 个月贷款总金额 | | `B22170012`-`B22170015` | string | 近 12 个月不同金额区间贷款笔数 | | `B22170016`-`B22170020` | string | 近 1/3/6/12/24 个月贷款机构数 | | `B22170021`-`B22170024` | string | 近 12/24 个月消金、网贷机构数 | | `B22170025`-`B22170030` | string | 近 6/12/24 个月 M0+/M1+ 逾期贷款笔数 | | `B22170031`-`B22170033` | string | 近 6/12/24 个月累计逾期金额 | | `B22170034` | string | 正常还款订单占贷款总订单数比例 | | `B22170035`-`B22170039` | string | 近 1/3/6/12/24 个月失败扣款笔数 | | `B22170040`-`B22170044` | string | 近 1/3/6/12/24 个月履约贷款总金额 | | `B22170045`-`B22170049` | string | 近 1/3/6/12/24 个月履约贷款次数 | | `B22170050` | string | 最近一次履约距今天数 | | `B22170051` | string | 贷款行为置信度 | | `B22170052` | string | 贷款已结清订单数 | | `B22170053` | string | 信用贷款时长 | | `B22170054` | string | 最近一次贷款放款时间，格式 `yyyy-mm` | 金额类字段单位默认为人民币元；未命中字段可能为空或为 `-1`。 ## consumer_finance_profile 字段 该节点返回 114 个扁平化画像字段，命名格式为 `{窗口}_{机构?}_{指标}`： | 片段 | 可选值 | 说明 | |---|---|---| | 窗口 | `m1`、`m6`、`m12` | 近 1、6、12 个月 | | 机构 | 省略、`bank`、`cfc`、`sloan` | 综合、银行、消费金融、小贷 | | 指标后缀 | `total_cnt`、`total_org`、`severe_overdue_cnt`、`severe_overdue_org`、`overdue_cnt`、`overdue_org`、`repay_fail_cnt`、`repay_fail_org`、`repay_ok_cnt`、`disburse_fail_cnt`、`disburse_ok_cnt`、`disburse_ok_org`、`audit_fail_cnt`、`audit_ok_cnt`、`apply_cnt`、`apply_org` | 次数或机构数指标 | 其中： - `m1` 包含综合和消费金融画像，共 26 项； - `m6`、`m12` 包含综合、银行、消费金融和小贷画像，各 44 项； - `cnt` 表示次数，`org` 表示机构数。