PHP开发实战：天远全能入职背调报告API集成指南与HRMS系统对接

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

一、实现HR系统的秒级自动化背调

在现代人力资源管理（HRM）及招聘SaaS平台中，背景调查往往是流程中最耗时且成本较高的环节。传统的人工线下核查通常需要3至5天时间，同时费用不菲。

全能入职背调报告API为HR软件开发商和企业IT团队提供了一种革命性的解决方案。作为天远API的核心产品之一，该接口通过一次调用即可整合学历学籍、不良记录、司法涉诉、社保评级以及全景雷达等多项关键数据。

本文将面向使用PHP语言的开发者，特别是熟悉Laravel与ThinkPHP框架的技术人员，详细介绍如何将此API封装为标准服务，并解析其多维度返回结果，助力企业在招聘过程中实现“一键背调”，显著降低用人风险与决策成本。

COMBQN12

二、PHP版本API调用示例

该API采用标准POST请求方式，数据以Base64加密传输，非常适合利用PHP的相应扩展进行处理。

1. 接口配置信息

• 接口地址：

  https://api.tianyuanapi.com/api/v1/COMBQN12?t=13位时间戳

• 请求方式：POST
• 内容类型：

  application/json

• 核心参数说明：业务参数需先转换为JSON格式，再进行Base64编码并放入

  data

  字段中。

cURL

2. 使用Curl命令行快速测试

Bash
curl -X POST "https://api.tianyuanapi.com/api/v1/COMBQN12?t=1715068800000" \
-H "Content-Type: application/json" \
-d '{
    "data": "eyJhdXRob3JpemVkIjoiMSIsIm5hbWUiOiLlvKDku0kiLCJpZF9jYXJkIjoiNDUyMTIyMjAwMDA4Mjc0MjNYIiwibW9iaWxlX25vIjoiMTM4MDAxMzgwMDAifQ=="
}'

3. PHP完整服务类封装实例

以下代码展示了一个可独立运行的PHP Service类，能够无缝集成到Laravel或ThinkPHP的服务层架构中：

PHP
<?php

class BackgroundCheckService
{
    // API地址
    private $apiUrl = "https://api.tianyuanapi.com/api/v1/COMBQN12";

    /**
     * 加密处理函数（模拟）
     * 实际对接请替换为天远API官方提供的加密算法（如AES/RSA）
     * * @param array $data 原始业务参数
     * @return string Base64编码后的字符串
     */
    private function encryptData($data)
    {
        $jsonStr = json_encode($data, JSON_UNESCAPED_UNICODE);
        // TODO: 在此处加入AES加密逻辑
        // $encrypted = OpenSSL::encrypt($jsonStr, ...);
        // 此处仅做Base64编码演示
        return base64_encode($jsonStr);
    }

    /**
     * 发起背调请求
     * * @param string $name 姓名
     * @param string $idCard 身份证号
     * @param string $mobile 手机号
     * @return array|null 解析后的响应数据
     */
    public function queryReport($name, $idCard, $mobile)
    {
        // 1. 准备时间戳
        $timestamp = round(microtime(true) * 1000);
        $url = $this->apiUrl . "?t=" . $timestamp;

        // 2. 构建请求载荷
        $payload = [
            "authorized" => "1", // 必须字段：1-已授权 "name" => $name,
            "id_card" => $idCard,
            "mobile_no" => $mobile
        ];

        // 3. 加密参数
        $encryptedData = $this->encryptData($payload);
        $body = json_encode(["data" => $encryptedData]);

        // 4. 初始化CURL
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 设置超时

        // 5. 执行请求
        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        
        if (curl_errno($ch)) {
            // 记录日志：curl_error($ch)
            return null;
        }
        curl_close($ch);

        if ($httpCode === 200) {
            $result = json_decode($response, true);
            // 6. 解析组合包数据
            if (isset($result['responses'])) {
                return $this->parseResponses($result['responses']);
            }
        }

        return null;
    }

    /**
     * 格式化输出关键数据，便于前端展示
     */
    private function parseResponses($responses)
    {
        $report = [
            'education' => null,     // 学历
            'risk_level' => '正常',   // 综合风险
            'social_level' => '-',   // 社保评级
            'legal_count' => 0       // 涉诉数量
        ];

        foreach ($responses as $item) {
            if (!$item['success']) continue; // 跳过失败的子产品 $data = $item['data'];
            switch ($item['api_code']) {
                case 'IVYZ3P9M': // 学历核验 // 仅取第一条学历信息
                    if (!empty($data) && is_array($data)) {
                        $info = $data[0] ?? [];
                        $report['education'] = [
                            'school' => $info['schoolName'] ?? '', // 对应学校代码 'level' => $this->mapEduLevel($info['educationLevel'] ?? ''),
                            'date' => $info['graduationDate'] ?? ''
                        ];
                    }
                    break;
                case 'FLXGDEA9': // 公安不良 if (isset($data['level']) && $data['level'] !== '0') {
                        $report['risk_level'] = "存在风险(代码:{$data['level']})";
                    }
                    break;
                case 'FLXG7E8F': // 司法涉诉 $report['legal_count'] = $data['judicial_data']['count']['count_total'] ?? 0;
                    break;
                 case 'JRZQ09J8': // 社保评级 $report['social_level'] = $data['level'] ?? '-';
                    break;
            }
        }
        return $report;
    }

    // 辅助字典映射
    private function mapEduLevel($code) {
        $map = ['1'=>'专科', '2'=>'本科', '3'=>'硕士', '4'=>'博士']; // return $map[$code] ?? '未知';
    }
}

// 调用演示
$service = new BackgroundCheckService();
$report = $service->queryReport("张三", "110101199001011234", "13912345678");
print_r($report);

三、返回数据结构深度解析

天远API的响应结构天然适配PHP的关联数组操作模式。根节点包含一个名为

responses

的数组，每个元素代表一个子产品的查询结果。

主要子产品及其功能如下：

• IVYZ3P9M（学历核验）：返回数组形式的教育经历数据。
• FLXGDEA9（不良人员）：返回对象结构，重点关注

  level

  字段。
• JRZQ7F1A（全景雷达）：返回嵌套复杂对象，涵盖借贷申请与还款行为分析。
• FLXG7E8F（司法涉诉）：返回深层嵌套对象，包括

  judicial_data

  主节点及其下的具体案件详情

  cases

  。

四、关键字段详解

在实际HR系统开发中，后端通常聚焦于影响录用决策的“红线”类指标。以下是PHP服务中应重点处理的关键字段说明。

1. 风险与合规类数据（FLXGDEA9 & FLXG7E8F）

字段名 (JSON key)	对应PHP处理	含义	业务逻辑建议
level (FLXGDEA9)	$data['level']	不良记录等级	若值非空，则触发“红灯”预警机制
breachCaseList	$data['judicial_data']['breachCaseList']	失信被执行人列表	检查是否为空数组；存在条目则判定为“老赖”
concreteDetails	...['concreteDetails']	失信行为详情	如显示“有履行能力而拒不履行”，应在HR界面明确提示
consumptionRestrictionList	...['consumptionRestrictionList']	限制高消费状态	影响员工差旅购票权限，需提前警示

2. 履历真实性验证（IVYZ3P9M）

字段名 (JSON key)	对应PHP处理	含义	业务逻辑建议
schoolName	$data[0]['schoolName']	学校名称/代码	需对照天远提供的学校字典映射为中文全称
specialtyName	$data[0]['specialtyName']	专业名称/代码	需结合专业代码字典进行标准化转换
educationLevel	$data[0]['educationLevel']	学历层次	对比简历填写内容，例如API返回 1 （专科）但简历写本科，则视为造假

3. 财务稳定性评估（JRZQ7F1A - 全景雷达）

字段名 (JSON key)	对应PHP处理	含义	业务逻辑建议
A22160001	$data['apply_report_detail']['A22160001']	申请准入分	评分范围1-1000，分数偏低可能存在多头借贷风险
B22170026	$data['behavior_report_detail']['B22170026']	近12个月逾期笔数	频繁逾期可能反映财务压力大，影响工作专注度

五、应用场景与业务价值

对于基于PHP构建的HRMS或OA系统而言，接入天远API可带来显著的效率提升与风控增强。

1. 构建企业内部诚信黑名单库

借助FLXGDEA9（公安不良记录）与FLXG7E8F（司法失信名单）的数据返回，企业可建立专属的候选人黑名单数据库。当系统识别出“在逃”、“吸毒”（level为A或C）或“失信被执行”等高危状态时，自动阻断录用流程，有效防范潜在用工风险。

2. 实现简历自动清洗与真实性校验

在校招或蓝领招聘高峰期，HR常面临海量简历筛选压力。通过集成IVYZ3P9M（学历核验）接口，PHP脚本可批量比对简历中的学历信息与API返回的educationLevel字段。仅需少量代码即可自动识别虚假学历，节省超过80%的初筛人力成本。

3. 自动生成结构化背调报告

结合PHP强大的模板引擎（如Blade或Smarty），开发者可将API返回的JSON数据渲染成专业的PDF格式背调报告。例如：将JRZQ09J8（社保评级）转化为可视化收入趋势图，将JRZQ7F1A（全景雷达）转化为财务健康仪表盘，为管理层提供直观可靠的录用依据。

六、总结

通过在PHP系统中集成全能入职背调报告API，企业能以极低的技术投入获得专业级的背景调查能力。该接口“一站式聚合”的特性，避免了分别对接多个独立数据源（如学信网、法院公开系统等）所带来的开发复杂性与维护负担。

开发者建议：注意定期更新并维护学校、专业等相关字典表，确保数据映射准确无误。

数据缓存策略：背景调查数据具备一定的时效性，但在短时间内可能出现重复查询的情况（例如HR操作失误），因此建议在PHP层面实施短期缓存机制，以减少不必要的API调用，降低接口使用成本。

接口优化处理：由于接口返回的学校名称与专业信息多以编码形式呈现（如

10001

表示北京大学），推荐将文档中包含的长字典数据预先存储至本地数据库或Redis缓存系统中，从而提升前端页面的渲染效率与响应速度。

安全与合规要求：每次调用API时，必须在服务端完整记录所使用的授权凭证信息，确保后续可进行审计追踪，满足安全合规需求。

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：API RMS PHP HRM Application

相关内容：php系统开发