基于天远API实现全能入职背调报告：接口调用与代码流程深度解析一、构建多维度的企业用工风险防火墙在企业招聘、关键岗位

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

在企业招聘、关键岗位背景审查以及金融风控等众多场景中，全能入职背调报告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的全能入职背调报告后，企业和开发者可以在以下场景中挖掘深度价值：

高风险岗位准入筛查

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

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

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

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

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

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

隐私授权：务必在前端确保获取了用户的明确授权（参数 authorized 传 1），合规使用数据。
异常处理：由于涉及多个子产品，建议对 responses 数组进行遍历检查，针对某个子产品（如学历）查询失败的情况做降级处理，不影响整体报告的生成。
数据脱敏：存储和展示司法、借贷等敏感数据时，建议在系统内进行脱敏处理，保护候选人隐私。

基于天远API实现全能入职背调报告：接口调用与代码流程深度解析

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