个人大数据报告（标准版） - 海宇数据

## 请求头 | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | 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 { "idcard": "string", "name": "string", "mobileno": "string" "AuthorizationURL": "string" "AuthAuthorizeFileBase64": "string" } ``` | 字段名 | 类型 | 必填 | 描述 | |--------|------|------|------| | idcard | string | 是 | 身份证号 | | name | string | 是 | 姓名 | | mobileno | string | 是 | 手机号 | | AuthorizationURL | string | 否 | 授权书url地址(支持格式为:pdf) | | AuthAuthorizeFileBase64 | string | 是 | 授权书 PDF 文件的 Base64 编码数据 | 通过加密后得到 Base64 字符串，将其放入到请求体中，字段名为 `data`。 ```json { "data": "xxxx(base64)" } ```

# DWBG4R7K 个人大数据综合报告 - 返回字段说明 ## 接口说明 `DWBG4R7K` 会并发整合 9 个子接口结果，生成一份个人大数据综合报告。接口响应直接返回报告数据对象，并提供 `reportUrl` 用于打开 HTML 报告页面。 整合子接口如下： | 子接口 | `sourceData` 字段 | 说明 | | --- | --- | --- | | YYSY7N3K | carrierTriple | 全网运营商三要素 | | YYSY35TA | mobileArea | 手机号码归属地 | | YYSYE7V5 | onlineStatus | 手机在网状态 | | IVYZRAX1 | creditScore | 个人信用分 | | JRZQR4N7 | loanIntent | 借贷意向验证 | | JRZQV87M | financialBlacklist | 金融黑名单 | | JRZQV3HM | overdueBlacklist | 债务逾期黑名单 | | JRZQV7MD | specialList | 特殊名单 | | FLXGHB4F | judicialLitigation | 个人司法涉诉 | ## 顶层字段 | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | label | string | 是 | 报告标签，固定为“贷前风控 · 个人大数据” | | title | string | 是 | 报告标题，固定为“个人大数据综合报告” | | reportNo | string | 是 | 报告编号，格式为 `RPT-DWBG4R7K-yyyyMMddHHmmss` | | generatedAt | string | 是 | 报告生成时间，格式为 `yyyy-MM-dd HH:mm:ss` | | version | string | 是 | 报告版本，当前为 `V1.0` | | profile | object | 是 | 报告头部用户画像 | | sections | array | 是 | 报告正文 9 个章节，顺序固定 | | sourceData | object | 是 | 9 个子接口的完整原始业务数据，供报告渲染和排查使用 | | reportId | string | 是 | 报告短编号 | | reportTime | string | 是 | 报告时间，取值同 `generatedAt` | | reportUrl | string | 是 | 报告访问地址，路径为 `/reports/dwbg/{reportId}` | ## profile 字段 | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | name | string | 是 | 脱敏姓名 | | mobileNo | string | 是 | 脱敏手机号 | | idCard | string | 是 | 脱敏身份证号 | | mobileArea | string | 是 | 手机号归属地，格式为“省份 城市”；无值时为空字符串 | | carrier | string | 是 | 运营商名称，优先取在网状态，其次取归属地和三要素 | ## sections 通用字段 | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | title | string | 是 | 章节标题 | | subtitle | string | 是 | 章节副标题 | | data | object/array | 是 | 章节数据，不同章节结构不同 | ## 第一章：风险评估 路径：`sections[title=一、风险评估].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | riskLevel | string | 是 | 综合风险等级，取值 `A`、`B`、`C`、`D`、`E`、`F`，风险从低到高 | | personalCreditScore | string/number | 是 | 个人信用分；无有效值时返回 `-` | | overdueRiskLevel | string/number | 是 | 债务逾期风险等级；无有效值时返回 `-` | | financialBlacklistHit | string | 是 | 金融黑名单是否命中，取值“命中”或“未命中” | | loanApplications12M | string/number | 是 | 近 12 个月手机号维度借贷申请次数 | ## 第二章：风险汇总 路径：`sections[title=二、风险汇总].data[]` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | name | string | 是 | 风险类别名称，如司法案件、借贷意向、逾期勘测、身份与手机、特殊名单 | | level | string | 是 | 风险等级文案，如低风险、关注预警、高风险 | | summary | string | 是 | 当前风险类别摘要说明 | ## 第三章：用户、手机与司法风险 路径：`sections[title=三、用户、手机与司法风险].data` ### data.userInfo | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | name | string | 是 | 脱敏姓名 | | idCard | string | 是 | 脱敏身份证号 | | carrierType | string | 是 | 三要素接口返回的运营商类型 | | verifyResult | string | 是 | 三要素核验结果：一致、不一致、查无数据或 `-` | | onlineCarrier | string | 是 | 手机在网状态接口返回的运营商 | ### data.mobileInfo | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | orderNo | string | 是 | 手机在网状态订单号；仅结构化数据保留，报告页面不渲染 | | carrier | string | 是 | 手机在网状态接口返回的运营商 | | status | string | 是 | 在网状态：在网、不在网或 `-` | | desc | string | 是 | 在网状态说明 | ### data.judicialRisk | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | casesTree | string | 是 | 案件关系树展示摘要 | | dishonest | string | 是 | 失信被执行人列表展示摘要 | | highConsume | string | 是 | 限制高消费列表展示摘要 | | changeCodeCRC | string | 是 | 司法数据变更码 | ## 第四章：借贷意向 路径：`sections[title=四、借贷意向].data` ### data.summary | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | idApplications12M | string | 是 | 近 12 个月身份证维度申请次数 | | mobileApplications12M | string | 是 | 近 12 个月手机号维度申请次数 | | idOrganizations12M | string | 是 | 近 12 个月身份证维度申请机构数 | | mobileOrganizations12M | string | 是 | 近 12 个月手机号维度申请机构数 | ### data.periodMatrix[] | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | period | string | 是 | 统计周期，取值 `d3`、`d7`、`d15`、`m1`、`m3`、`m6`、`m12` | | idAllNum | string | 是 | 当前周期身份证维度申请次数 | | cellAllNum | string | 是 | 当前周期手机号维度申请次数 | | idOrgNum | string | 是 | 当前周期身份证维度申请机构数 | | cellOrgNum | string | 是 | 当前周期手机号维度申请机构数 | | riskLevel | string | 是 | 当前周期风险等级 | | displayValue | string | 是 | 展示值，格式为“身份证维度/手机号维度” | ### data.categoryMatrix[] | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | name | string | 是 | 机构类型名称 | | applyCount | string | 是 | 近 12 个月申请次数，格式为“身份证维度/手机号维度” | | orgCount | string | 是 | 近 12 个月申请机构数，格式为“身份证维度/手机号维度” | ### data.monthlyStats | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | idAvgMonthNum | string | 是 | 近 12 个月身份证维度月均申请次数 | | mobileAvgMonthNum | string | 是 | 近 12 个月手机号维度月均申请次数 | | idMaxMonthNum | string | 是 | 近 12 个月身份证维度单月最高申请次数 | | mobileMaxMonthNum | string | 是 | 近 12 个月手机号维度单月最高申请次数 | ## 第五章：名单与逾期 路径：`sections[title=五、名单与逾期].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | overdueRiskLevel | string | 是 | 债务逾期综合风险等级 | | financialBlacklist | object | 是 | 金融黑名单摘要 | | matrix | array | 是 | 近 30/90/180 天逾期风险矩阵 | ### data.financialBlacklist | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | blackList | string | 是 | 金融黑名单是否命中 | | tags | object | 是 | `black_tag` 开头的标签命中情况 | ### data.matrix[] | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | name | string | 是 | 统计项名称 | | total | string | 是 | 机构类型风险等级或风险值 | | level | string | 是 | 风险类型数 | ## 第六章：身份与手机号核验 路径：`sections[title=六、身份与手机号核验].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | carrierTriple | object | 是 | 运营商三要素核验结果 | | mobileArea | object | 是 | 手机号码归属地 | | onlineStatus | object | 是 | 手机在网状态 | ### data.carrierTriple | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | carrierType | string | 是 | 运营商类型 | | verifyStatus | string | 是 | 三要素核验结果 | ### data.mobileArea | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | orderNo | string | 是 | 订单号；仅结构化数据保留，报告页面不渲染 | | areaCode | string | 是 | 城市区号 | | cityCode | string | 是 | 城市编码 | | carrier | string | 是 | 运营商 | | province | string | 是 | 省份 | | city | string | 是 | 城市 | | segment | string | 是 | 手机号号段 | ### data.onlineStatus | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | orderNo | string | 是 | 订单号；仅结构化数据保留，报告页面不渲染 | | carrier | string | 是 | 运营商 | | status | string | 是 | 在网状态 | | desc | string | 是 | 状态说明 | ## 第七章：信用评分与金融黑名单 路径：`sections[title=七、信用评分与金融黑名单].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | creditScore | object | 是 | 信用评分摘要 | | financialBlacklist | object | 是 | 金融黑名单摘要 | ### data.creditScore | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | score | string | 是 | 个人信用分 | | range | string | 是 | 分数范围说明 | ### data.financialBlacklist | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | blackList | string | 是 | 金融黑名单是否命中 | | tags | object | 是 | `black_tag` 开头的标签命中情况 | ## 第八章：特殊名单 路径：`sections[title=八、特殊名单].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | strategy | object | 是 | 策略结果摘要 | | rule | object | 是 | 规则结果摘要 | | listSummary | object | 是 | 法院被执行人摘要 | ### data.strategy | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | finalDecision | string | 是 | 最终决策，来自 `RiskStrategy.final_decision` | | platform | string | 是 | 策略平台 | | scene | string | 是 | 业务场景 | | productName | string | 是 | 产品名称 | | productType | string | 是 | 产品类型 | ### data.rule | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | finalWeight | string | 是 | 最终权重 | | finalDecision | string | 是 | 最终决策，来自 `Rule.result.final_decision` | | hitRules | object | 否 | 命中规则原始结构 | ### data.listSummary | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | courtExecuted | string | 是 | 法院被执行人是否命中 | | courtExecutedAllNum | string | 是 | 法院被执行人命中次数 | | courtExecutedTime | string | 是 | 最近命中距今年数 | ## 第九章：司法涉诉 路径：`sections[title=九、司法涉诉].data` | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | summary | object | 是 | 司法涉诉摘要 | | details | object | 是 | 司法涉诉完整原始业务数据 | ### data.summary | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | casesTree | string | 是 | 案件关系树展示摘要 | | dishonest | string | 是 | 失信被执行人列表展示摘要 | | highConsume | string | 是 | 限制高消费列表展示摘要 | | crc | string | 是 | 数据变更码 | ### data.details.ss | 字段名 | 类型 | 是否必返 | 说明 | | --- | --- | --- | --- | | crc | string | 否 | 整体数据变更码 | | cases_tree | object | 否 | 民事、刑事、行政案件串联关系树 | | count | object | 否 | 全类型案件统计 | | civil | object | 否 | 民事案件信息，包含 `count` 和 `cases` | | criminal | object | 否 | 刑事案件信息，包含 `count` 和 `cases` | | administrative | object | 否 | 行政案件信息，包含 `count` 和 `cases` | | implement | object | 否 | 执行案件信息，包含 `count` 和 `cases` | | preservation | object | 否 | 非诉财产保全审查案件信息，包含 `count` 和 `cases` | | bankrupt | object | 否 | 强制清算与破产案件信息，包含 `count` 和 `cases` | ### data.details.ss.*.count `ss.count`、`ss.civil.count`、`ss.criminal.count`、`ss.administrative.count`、`ss.implement.count`、`ss.preservation.count`、`ss.bankrupt.count` 使用同一套统计字段。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | count_total | number/string | 案件总数 | | count_jie_total | number/string | 已结案总数 | | count_wei_total | number/string | 未结案总数 | | count_yuangao | number/string | 原告总数 | | count_jie_yuangao | number/string | 原告已结案数 | | count_wei_yuangao | number/string | 原告未结案数 | | count_beigao | number/string | 被告总数 | | count_jie_beigao | number/string | 被告已结案数 | | count_wei_beigao | number/string | 被告未结案数 | | count_other | number/string | 第三人总数 | | count_jie_other | number/string | 第三人已结案数 | | count_wei_other | number/string | 第三人未结案数 | | money_total | number/string | 涉案总金额等级；等级码由上游返回，接口文档未提供金额区间映射 | | money_jie_total | number/string | 已结案金额等级 | | money_wei_total | number/string | 未结案金额等级 | | money_wei_percent | number/string | 未结案金额占比；报告渲染时会格式化为百分比 | | money_yuangao | number/string | 原告涉案金额等级 | | money_jie_yuangao | number/string | 原告已结案金额等级 | | money_wei_yuangao | number/string | 原告未结案金额等级 | | money_beigao | number/string | 被告涉案金额等级 | | money_jie_beigao | number/string | 被告已结案金额等级 | | money_wei_beigao | number/string | 被告未结案金额等级 | | money_other | number/string | 第三人涉案金额等级 | | money_jie_other | number/string | 第三人已结案金额等级 | | money_wei_other | number/string | 第三人未结案金额等级 | | ay_stat | string | 涉案案由分布 | | larq_stat | string | 立案年份分布 | | area_stat | string | 涉案省份分布 | | jafs_stat | string | 结案方式分布 | ### data.details.ss.*.cases[] 不同案件类型字段略有差异，报告会按可用字段渲染案件卡片。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | c_ah | string | 案号 | | c_ah_ys | string | 原审案号 | | c_ah_hx | string | 后续案号 | | c_gkws_glah | string | 相关案件号 | | n_jbfy | string | 经办法院 | | n_jbfy_cj | string | 法院层级 | | c_ssdy | string | 所属地域 | | n_laay | string | 立案案由 | | n_laay_tree | string | 立案案由层级详情 | | n_jaay | string | 结案案由 | | n_jaay_tree | string | 结案案由层级详情 | | n_dzzm | string | 定罪罪名 | | n_dzzm_tree | string | 定罪罪名层级详情 | | n_slcx | string | 审理程序 | | n_ajjzjd | string | 案件进展阶段 | | n_jafs | string | 结案方式 | | n_ajlx | string | 案件类型 | | d_larq | string | 立案时间 | | d_jarq | string | 结案时间 | | n_ssdw | string | 诉讼地位 | | n_ssdw_ys | string | 一审诉讼地位 | | n_qsbdje | number/string | 起诉标的金额 | | n_qsbdje_level | number/string | 起诉标的金额等级 | | n_qsbdje_gj | number/string | 起诉标的金额估算 | | n_qsbdje_gj_level | number/string | 起诉标的金额估算等级 | | n_jabdje | number/string | 结案标的金额 | | n_jabdje_level | number/string | 结案标的金额等级 | | n_jabdje_gj | number/string | 结案标的金额估算 | | n_jabdje_gj_level | number/string | 结案标的金额估算等级 | | n_sqbqse | number/string | 申请保全数额 | | n_sqbqse_level | number/string | 申请保全数额等级 | | c_sqbqbdw | string | 保全标的物 | | n_sqzxbdje | number/string | 申请执行标的金额 | | n_sjdwje | number/string | 实际到位金额 | | n_wzxje | number/string | 未执行金额 | | n_fzje | number/string | 犯罪金额 | | n_fzje_level | number/string | 犯罪金额等级 | | n_bqqpcje | number/string | 被请求赔偿金额 | | n_bqqpcje_level | number/string | 被请求赔偿金额等级 | | n_pcpcje | number/string | 判处赔偿金额 | | n_pcpcje_level | number/string | 判处赔偿金额等级 | | n_ccxzxje | number/string | 财产刑执行金额 | | n_ccxzxje_level | number/string | 财产刑执行金额等级 | | c_gkws_pjjg | string | 判决结果 | | n_pj_victory | string | 胜诉估计 | | n_pcjg | string | 判处结果 | | c_slfsxx | string | 审理方式信息 | | c_dsrxx | array | 当事人信息 | | c_dsrxx[].c_mc | string | 当事人名称 | | c_dsrxx[].n_dsrlx | string | 当事人类型 | | c_dsrxx[].n_ssdw | string | 当事人诉讼地位 | ### data.details.sxbzxr[] / data.details.xgbzxr[] | 字段名 | 类型 | 说明 | | --- | --- | --- | | ah | string | 案号 | | zxfy | string | 执行法院 | | larq | string | 立案时间 | | fbrq | string | 发布时间 | | sf | string | 执行省份 | | pjje_gj | number/string | 判决金额估计 | | yw | string | 生效法律文书确定义务 | | zxyjwh | string | 执行依据文号 | | zxyjdw | string | 执行依据作出单位 | | lxqk | string | 履行情况 | | xwqx | string | 失信具体情形 | ## sourceData 字段 `sourceData` 完整保留 9 个子接口的原始业务数据，用于后续复核和报告渲染。报告页面不会渲染订单号、接口来源或原始字段路径。 | 字段名 | 类型 | 说明 | | --- | --- | --- | | carrierTriple | object/null | YYSY7N3K 原始业务数据 | | mobileArea | object/null | YYSY35TA 原始业务数据 | | onlineStatus | object/null | YYSYE7V5 原始业务数据 | | creditScore | object/null | IVYZRAX1 原始业务数据 | | loanIntent | object/null | JRZQR4N7 原始业务数据 | | financialBlacklist | object/null | JRZQV87M 原始业务数据 | | overdueBlacklist | object/null | JRZQV3HM 原始业务数据 | | specialList | object/null | JRZQV7MD 原始业务数据 | | judicialLitigation | object/null | FLXGHB4F 原始业务数据 | ### sourceData.loanIntent 常用字段 借贷意向字段采用 `ae_{周期}_{维度}_{指标}` 命名。 | 组成 | 取值 | 说明 | | --- | --- | --- | | 周期 | `d3`、`d7`、`d15`、`m1`、`m3`、`m6`、`m12` | 近 3 天、7 天、15 天、1/3/6/12 个月 | | 维度 | `id`、`cell` | 身份证维度、手机号维度 | | 指标 | `allnum`、`orgnum`、`allnum_d`、`orgnum_d` | 申请次数、机构数、去重申请次数、去重机构数 | | 客户类型指标 | `bank_*`、`nbank_*`、`nbank_sloan_*` 等 | 银行、非银、小贷、消费金融等机构类型 | | 时间指标 | `*_night_*`、`*_weekend_*` | 夜间、周末申请 | | 月度指标 | `tot_mons`、`avg_monnum`、`max_monnum`、`min_monnum` | 有申请记录月份数、月均、最大月、最小月申请次数 | ### sourceData.overdueBlacklist 字段 | 字段名 | 类型 | 说明 | | --- | --- | --- | | RiskLevel | number/string | 债务逾期综合风险等级 | | s04_t30_e21x / s04_t90_e21x / s04_t180_e21x | number/string | 近 30/90/180 天机构类型风险等级 | | s05_t30_e21x / s05_t90_e21x / s05_t180_e21x | number/string | 近 30/90/180 天风险类型数 | | s04_t*_e21x_og1 | number/string | 银行类机构风险 | | s04_t*_e21x_og2 | number/string | 汽车金融类机构风险 | | s04_t*_e21x_og3 | number/string | 消费金融类机构风险 | | s04_t*_e21x_og4 | number/string | 小贷类机构风险 | | s04_t*_e21x_og5 | number/string | 保险类机构风险 | | s04_t*_e21x_og6 | number/string | 特殊类机构风险 | | s04_t*_e21x_og7 | number/string | 混合类机构风险 | | s04_t*_e21x_og8 | number/string | 其他类机构风险 | ### sourceData.specialList 常用字段 | 字段名 | 类型 | 说明 | | --- | --- | --- | | Rule.result.final_decision | string | 规则最终决策 | | Rule.result.final_weight | string | 规则最终权重 | | Rule.hit_rules | object | 命中规则明细 | | RiskStrategy.final_decision | string | 策略最终决策 | | RiskStrategy.platform | string | 策略平台 | | RiskStrategy.scene | string | 业务场景 | | SpecialList_c.id | object | 身份证维度特殊名单结果 | | SpecialList_c.cell | object | 手机号维度特殊名单结果 | `SpecialList_c.id` 和 `SpecialList_c.cell` 下常用字段为 `{名单类型}`、`{名单类型}_allnum`、`{名单类型}_time`，分别表示是否命中、命中次数、最近命中距今年数。名单类型包括 `court_executed`、`nbank_bad`、`nbank_overdue`、`nbank_other_bad`、`nbank_other_overdue` 等。 ## 空值说明 如果某个子接口调用失败或上游未返回对应字段，报告仍会生成；对应字段通常返回 `-`、`未返回`、空对象、空数组或 `null`。`reportUrl` 指向的 HTML 报告会按当前可用字段渲染。