租凭分期报告（标准版） - 海宇数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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", "mobile_no": "string", "auth_pdf_base64": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | id_card | string | 是 | 身份证号 | | name | string | 是 | 姓名 | | mobile_no | string | 是 | 手机号 | | auth_pdf_base64 | string | 是 | 授权书 PDF 文件的 Base64 编码数据，文件大小不得超过 500KB | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

# DWBG7M4Q 返回字段说明 ## 接口说明 `DWBG7M4Q` 为租赁分期报告（标准版）聚合接口，后端并发调用 3 个子接口并生成一份报告数据： | 子节点 | 子接口 | 说明 | |---|---|---| | `risk_probe` | `JRZQI079` | 风险探针 C | | `cave` | `JRZQK9P2` | 百行洞侦 | | `legal` | `FLXGC4CT` | 个人涉诉 V2 版 | ## 顶层返回字段 | 字段名 | 类型 | 说明 | |---|---|---| | `api_code` | string | 当前聚合接口编码，固定为 `DWBG7M4Q` | | `report_id` | string | 报告唯一编号，后端随机生成 | | `reportId` | string | 报告唯一编号，供前端或调用方直接读取，值与 `report_id` 一致 | | `report_no` | string | 报告展示编号，格式为 `RPT-DWBG7M4Q-yyyyMMddHHmmss` | | `generated_at` | string | 报告生成时间，格式为 `yyyy-MM-dd HH:mm:ss` | | `reportTime` | string | 报告生成时间，格式为 `yyyy-MM-dd HH:mm:ss`，用于对齐报告类接口返回 | | `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_probe` | object | 风险探针 C 原始响应，通常包含 `result` 对象 | | `source_data.cave` | object | 百行洞侦原始响应，通常包含 `score`、`reason`、`contents` | | `source_data.legal` | object | 个人涉诉 V2 版原始响应，通常包含 `ss`、`sxbzxr`、`xgbzxr` | > 子接口调用失败时，对应节点返回： > > | 字段名 | 类型 | 说明 | > |---|---|---| > | `success` | boolean | 固定为 `false` | > | `error` | string | 子接口错误信息 | ## risk_probe.result 主要字段 | 字段名 | 类型 | 说明 | |---|---|---| | `result_code` | string | 探查结果编码：`1` 逾期，`2` 正常，`3` 延期/迟付，`4` 未知/无数据 | | `max_overdue_amt` | string | 最大逾期金额区间 | | `max_overdue_days` | string | 最长逾期天数区间 | | `latest_overdue_time` | string | 最近逾期时间，精确到月 | | `max_performance_amt` | string | 最大履约金额区间 | | `latest_performance_time` | string | 最近履约时间，精确到月 | | `count_performance` | string | 履约笔数 | | `currently_overdue` | string | 当前逾期机构数 | | `currently_performance` | string | 当前履约机构数 | | `acc_exc` | string | 异常还款机构数 | | `acc_sleep` | string | 睡眠机构数 | ## cave 主要字段 | 字段名 | 类型 | 说明 | |---|---|---| | `score` | integer/string | 洞侦评分，页面按 300-900 区间展示 | | `reason` | string | 评分或查询说明 | | `contents` | object | 洞侦明细特征集合 | | `contents.TC_A118` | integer/string | 近 30 天所有机构查询次数 | | `contents.TC_A122` | integer/string | 近 365 天所有机构查询次数 | | `contents.TC_A123` | integer/string | 近 730 天所有机构查询次数 | | `contents.TC_A127` | integer/string | 近 30 天所有机构查询机构数 | | `contents.TC_A131` | integer/string | 近 365 天所有机构查询机构数 | | `contents.TC_A132` | integer/string | 近 730 天所有机构查询机构数 | ## legal 主要字段 | 字段名 | 类型 | 说明 | |---|---|---| | `ss` | object | 涉诉案件信息对象 | | `ss.crc` | string | 变更码 CRC | | `ss.cases_tree` | object | 案件关系树 | | `ss.count` | object | 案件统计 | | `ss.civil` | object | 民事案件 | | `ss.criminal` | object | 刑事案件 | | `ss.administrative` | object | 行政案件 | | `ss.implement` | object | 执行案件 | | `ss.bankrupt` | object | 强制清算与破产 | | `ss.preservation` | object | 非诉财产保全 | | `sxbzxr` | array | 失信被执行人列表 | | `xgbzxr` | array | 限制消费被执行人列表 |