## 一、 构建多维度的企业用工风险防火墙

在企业招聘、关键岗位背景审查以及金融风控等众多场景中，**全能入职背调报告API**的核心价值是进行候选人综合素质评估与风险排查的关键依据。该组合接口不仅涵盖了基础的身份与学历核验，还深度整合了司法诉讼、金融借贷行为及社会负面记录，能够一站式输出候选人的多维度画像。

本文将作为一份详细的开发文档，深入剖析此API，详细解读其返回的原始数据结构和每一个核心字段的含义，帮助开发者利用API提供的大数据能力，进行更深层次的人才风险分析与企业人力资源管理系统（HRM）的集成。通过标准化接入该接口，企业可大幅降低背调成本，提升招聘决策的准确性与安全性。




## 二、 API接口调用示例

本接口采用组合包形式（API代码：COMBQN12），一次调用即可获取包括学历、婚姻状况、社会不良记录、司法涉诉、社保评级及借贷风险雷达等六大维度的背调数据。

### 1. 调用说明

- **接口地址**：`https://api.tianyuanapi.com/api/v1/COMBQN12?t=13位时间戳`

- **请求方式**：POST

- **安全机制**：请求参数需经过加密处理并转换为Base64字符串放入 `data` 字段中。

- **数据格式**：JSON


### 2. Curl 调用示例

Bash

```
curl -X POST "<https://api.tianyuanapi.com/api/v1/COMBQN12?t=1715068800000>" \\
-H "Content-Type: application/json" \\
-d '{
    "data": "eyJhdXRob3JpemVkIjoiMSIsIm5hbWUiOiLlvKDku0kiLCJpZF9jYXJkIjoiNDUyMTIyMjAwMDA4Mjc0MjNYIiwibW9iaWxlX25vIjoiMTM4MDAxMzgwMDAifQ==" 
}'
# 注意：上面的data值为示例Base64，实际使用时请替换为您的加密业务数据
```
### 3. Python 调用示例

以下代码展示了如何集成API的全能背调接口，包含了完整的请求构建与基础的错误处理逻辑。

Python

```
import requests
import json
import time
import base64

# 1. 配置API基础信息
API_URL = "<https://api.tianyuanapi.com/api/v1/COMBQN12>"
TIMESTAMP = int(round(time.time() * 1000))
FULL_URL = f"{API_URL}?t={TIMESTAMP}"

def encrypt_payload(payload_dict):
    """
    数据加密处理函数占位符
    请根据天远API官方提供的加密算法（如AES/RSA）实现此函数
    此处仅做JSON序列化和Base64编码演示
    """
    json_str = json.dumps(payload_dict)
    # 假设此处进行了加密操作，最后转为Base64
    # encrypted_bytes = your_encryption_func(json_str) 
    return base64.b64encode(json_str.encode('utf-8')).decode('utf-8')

def get_background_check_report(name, id_card, mobile):
    # 2. 准备请求参数
    payload = {
        "authorized": "1",      # 必须获得用户授权
        "name": name,           # 姓名
        "id_card": id_card,     # 身份证号
        "mobile_no": mobile,    # 手机号
        # "return_type": "json" # 可选参数
    }

    # 3. 加密参数
    encrypted_data = encrypt_payload(payload)
    
    # 4. 发送请求
    headers = {'Content-Type': 'application/json'}
    body = {"data": encrypted_data}

    try:
        response = requests.post(FULL_URL, headers=headers, json=body)
        
        # 5. 处理响应
        if response.status_code == 200:
            result = response.json()
            # 组合包返回的是responses数组
            if "responses" in result:
                print("--- 背调报告生成成功 ---")
                return result["responses"]
            else:
                print(f"调用失败，返回信息: {result}")
        else:
            print(f"请求异常，状态码: {response.status_code}")
            
    except Exception as e:
        print(f"发生系统错误: {e}")

# 执行调用
if __name__ == "__main__":
    report_data = get_background_check_report("张三", "45212220000827423X", "13800138000")
    
    # 简单的结果解析示例
    if report_data:
        for sub_product in report_data:
            code = sub_product.get('api_code')
            success = sub_product.get('success')
            if code == 'IVYZ3P9M' and success:
                print("学历核验数据:", sub_product.get('data'))
            elif code == 'FLXG7E8F' and success:
                print("司法涉诉数据:", sub_product.get('data'))
```


----

## 三、 核心数据结构解析

由于该接口是“组合包”模式，响应数据的根节点包含一个 `responses` 数组。数组中的每一个对象代表一个子产品的查询结果。

**主要子产品对照表：**

|**子产品代码**|**产品名称**|**核心作用**|
|:-:|:-:|:-:|
|**IVYZ3P9M**|学籍学历核验(实时版)|验证学历真伪、毕业院校及专业|
|**IVYZ81NC**|单人婚姻查询|查询婚姻登记记录（结婚/离婚）|
|**JRZQ09J8**|收入评估(社保评级)|基于社保推算的收入等级|
|**JRZQ7F1A**|全景雷达|分析多头借贷、逾期及信贷申请行为|
|**FLXGDEA9**|公安不良人员名单|筛查吸毒、在逃、前科等严重不良记录|
|**FLXG7E8F**|个人司法涉诉查询|查询民事、刑事、执行、失信等司法记录|




## 四、 字段详解

以下是各子模块核心字段的详细说明，开发者可据此进行数据落库和页面展示。

### 1. 学籍学历核验 (IVYZ3P9M)

|**字段名**|**类型**|**含义**|**说明/枚举值**|
|:-:|:-:|:-:|:-:|
|`specialtyName`|string|专业名称|对应专业字典编号|
|`schoolName`|string|学校名称|对应学校字典编号|
|`educationLevel`|string|学历层次|1:专科, 2:本科, 3:硕士, 4:博士, 5:第二学士|
|`learningForm`|string|学习形式|1:脱产, 2:普通全日制, 6:函授, 7:网络教育等|
|`graduationDate`|string|毕业时间|格式：YYYYMMDD|
|`enrollmentDate`|string|入学时间|格式：YYYYMMDD|

### 2. 司法涉诉查询 (FLXG7E8F)

该模块数据结构较复杂，分为统计信息和详细列表。

|**字段名**|**类型**|**含义**|**说明**|
|:-:|:-:|:-:|:-:|
|**consumptionRestrictionList**|array|限制高消费记录|包含案号、执行法院、发布日期|
|**breachCaseList**|array|失信被执行人列表|俗称“老赖”名单，包含具体失信行为描述|
|**lawsuitStat**|object|案件详情树|包含民事(civil)、刑事(criminal)等案件树状图|
|`count_total`|number|案件总数|涉诉总数量|
|`money_total`|number|涉案总金额|单位：元|
|`cases`|array|案件明细列表|包含案号(c_ah)、案由(n_laay)、结案方式等|

### 3. 全景雷达 (JRZQ7F1A)

用于评估候选人的财务稳定性与潜在债务压力。

|**字段名**|**类型**|**含义**|**说明**|
|:-:|:-:|:-:|:-:|
|**apply_report_detail**|object|申请行为详情|借贷申请记录|
|`A22160001`|string|申请准入分|1-1000，分数越低准入风险越高|
|`A22160006`|string|机构总查询次数|历史总查询次数|
|`A22160008`|string|近1个月查询笔数|反映近期资金饥渴度|
|**behavior_report_detail**|object|放款还款详情|实际借贷与还款表现|
|`B22170026`|string|近12个月M0+逾期|M0+表示有逾期行为的笔数|
|`B22170034`|string|正常还款比例|如 "70%"|
|**current_report_detail**|object|信用详情|当前授信情况|
|`C22180001`|string|网贷授信额度|预估额度区间|

### 4. 收入评估 (JRZQ09J8) & 婚姻查询 (IVYZ81NC)

|**字段名**|**类型**|**含义**|**说明**|
|:-:|:-:|:-:|:-:|
|`level`|string|社保评级|A-J级，例如 A级对应(2000-4000元)|
|`op_type_desc`|string|婚姻业务描述|结婚、离婚、匹配不成功|
|`op_date`|string|登记日期|格式：YYYY-MM-DD|




## 五、 应用价值分析

在接入API的全能入职背调报告后，企业和开发者可以在以下场景中挖掘深度价值：


1. 高风险岗位准入筛查
	通过FLXGDEA9（公安不良）和 FLXG7E8F（司法涉诉）接口，可以秒级识别候选人是否存在盗窃、诈骗前科或严重的经济纠纷。这对于财务、安保、高管等关键岗位至关重要，有效规避用工法律风险。

2. 简历真实性核验
	利用 IVYZ3P9M（学历核验）接口返回的 educationLevel 和 graduationDate，系统可自动与候选人填写的简历信息进行比对。若API返回“专科”而简历填写“本科”，系统可自动触发预警，大幅提高HR筛选效率。

3. 员工稳定性预判
	结合 JRZQ7F1A（全景雷达）和 JRZQ09J8（收入评估），企业可以侧面了解候选人的经济状况。例如，若候选人存在多头借贷且近期频繁逾期（全景雷达数据异常），可能意味着其面临较大的个人财务压力，这与员工的在职稳定性及潜在的舞弊风险存在一定相关性。




## 六、 开发者集成建议与总结

**全能入职背调报告API**通过标准化的JSON数据交互，为开发者提供了一套“即插即用”的背景调查基础设施。相比于传统的人工背调，接入API可以将背调周期从3-5天缩短至毫秒级响应。

**建议开发者在集成时注意：**

- **隐私授权**：务必在前端确保获取了用户的明确授权（参数 `authorized` 传 1），合规使用数据。

- **异常处理**：由于涉及多个子产品，建议对 `responses` 数组进行遍历检查，针对某个子产品（如学历）查询失败的情况做降级处理，不影响整体报告的生成。

- **数据脱敏**：存储和展示司法、借贷等敏感数据时，建议在系统内进行脱敏处理，保护候选人隐私。

在企业招聘、关键岗位背景审查以及金融风控等众多场景中，全能入职背调报告API的核心价值是进行候选人综合素质评估与风险排查的关键依据。该组合接口不仅涵盖了基础的身份与学历核验，还深度整合了司法诉讼、金融借贷行为及社会负面记录，能够一站式输出候选人的多维度画像。

企业级背调解决方案：全能入职背调报告API接口调用代码流程与接入指南

后端

职业发展

安全

全能入职背调API提供一站式候选人风险评估，涵盖学历、司法、金融等6大维度数据。支持JSON格式调用，包含Python示例代码，帮助企业快速集成人才背景调查功能，降低招聘风险，提升HR效率。详细解析API数据结构与核心字段含义。

数据脱敏

数据加密

数据结构

敏感数据

大数据

防火墙

Python

JSON

AI驱动 智领未来

bigdata-class

dmask

cloudhsm

文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

企业级背调解决方案：全能入职背调报告API接口调用代码流程与接入指南-腾讯云开发者社区-腾讯云

企业级背调解决方案：全能入职背调报告API接口调用代码流程与接入指南

企业级背调解决方案：全能入职背调报告API接口调用代码流程与接入指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐