天远入职背调报告API接入指南：Go语言构建高并发自动化背景筛查引擎

应对复杂用工风险：构建数据驱动的雇员背景核验机制

在现代企业的人力资源管理与业务扩张中，候选人履历失真、隐瞒过往严重劳资纠纷或背负高危信用债务等情况，是极具隐蔽性的风险源。传统的线下背景调查往往依赖人工致电或第三方走访，不仅耗时漫长、成本高昂，且难以全面覆盖个人的司法涉诉、涉赌涉诈及底层信用记录。若将存在重大诚信瑕疵或合规隐患的人员引入核心业务线，可能引发连带的商业纠纷甚至名誉受损。

为了在候选人入职前置阶段实现客观、高效的风险排查，天远入职背调报告API 提供了一种直连底层权威数据的组合核验方案。该接口将学历学籍真伪、婚姻状态、劳动争议、涉诈预警以及法院执行等多个维度的数据打包输出。

Go 后端安全通信解析：构建高并发加密调用链路

本接口处理的是高度敏感的个人履历数据，不仅在业务层面强制要求提供电子授权书（authorization_url）以符合合规审查，在网络通信层也制定了极为严苛的安全标准。在使用 Go 语言进行系统对接时，由于标准库原生不提供 PKCS7 填充算法，开发者需要自行实现补码与去码逻辑。

1. 核心加密规范与端点配置

请求端点 : https://api.tianyuanapi.com/api/v1/COMBTY17?t=13位时间戳
通信协议: POST
加密策略: AES-CBC 模式，128位密钥，PKCS7填充。每次加密需随机生成 16 字节 IV（初始化向量），加密后将 IV 和密文拼接在一起，最后通过 Base64 编码进行传输。
关键入参 : name (姓名), id_card (身份证号), mobile_no (手机号码) 与 authorization_url (授权书URL地址)。

2. 标准化 Go 客户端代码集成

以下代码展示了如何利用 Go 的并发安全特性与 net/http 包，构建一个包含完整加解密管道、超时控制与异常拦截的底层调用模块：

jsx 复制代码

package main

import (
	"bytes"
	"crypto/aes"
	"crypto/cipher"
	"crypto/rand"
	"encoding/base64"
	"encoding/hex"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"time"
)

const ApiUrl = "https://api.tianyuanapi.com/api/v1/COMBTY17"

// BackgroundCheckClient 封装背调API调用客户端
type BackgroundCheckClient struct {
	AccessId  string
	AccessKey []byte
	Client    *http.Client
}

// NewBackgroundCheckClient 初始化客户端
func NewBackgroundCheckClient(accessId, hexAccessKey string) (*BackgroundCheckClient, error) {
	keyBytes, err := hex.DecodeString(hexAccessKey)
	if err != nil || len(keyBytes) != 16 {
		return nil, fmt.Errorf("无效的 AccessKey，必须为合法的16字节hex字符串")
	}

	return &BackgroundCheckClient{
		AccessId:  accessId,
		AccessKey: keyBytes,
		Client: &http.Client{
			Timeout: 15 * time.Second, // 组合包查询耗时可能较长，设置15秒超时
		},
	}, nil
}

// pkcs7Padding 补码逻辑
func pkcs7Padding(ciphertext []byte, blockSize int) []byte {
	padding := blockSize - len(ciphertext)%blockSize
	padtext := bytes.Repeat([]byte{byte(padding)}, padding)
	return append(ciphertext, padtext...)
}

// pkcs7UnPadding 去码逻辑
func pkcs7UnPadding(origData []byte) ([]byte, error) {
	length := len(origData)
	if length == 0 {
		return nil, fmt.Errorf("解密数据为空")
	}
	unpadding := int(origData[length-1])
	if unpadding > length {
		return nil, fmt.Errorf("无效的填充长度")
	}
	return origData[:(length - unpadding)], nil
}

// encryptData AES-128-CBC + PKCS7 + Base64
func (c *BackgroundCheckClient) encryptData(rawData string) (string, error) {
	block, err := aes.NewCipher(c.AccessKey)
	if err != nil {
		return "", err
	}

	// 1. 随机生成 16 字节 IV
	iv := make([]byte, 16)
	if _, err := io.ReadFull(rand.Reader, iv); err != nil {
		return "", err
	}

	// 2. PKCS7 填充
	paddedData := pkcs7Padding([]byte(rawData), block.BlockSize())

	// 3. 执行加密
	cipherText := make([]byte, len(paddedData))
	mode := cipher.NewCBCEncrypter(block, iv)
	mode.CryptBlocks(cipherText, paddedData)

	// 4. 拼接并编码
	combined := append(iv, cipherText...)
	return base64.StdEncoding.EncodeToString(combined), nil
}

// decryptData 响应载荷解密
func (c *BackgroundCheckClient) decryptData(encryptedBase64 string) ([]byte, error) {
	combined, err := base64.StdEncoding.DecodeString(encryptedBase64)
	if err != nil || len(combined) <= 16 {
		return nil, fmt.Errorf("Base64解码异常或数据长度不足")
	}

	// 1. 提取头部 16 字节 IV
	iv := combined[:16]
	cipherText := combined[16:]

	block, err := aes.NewCipher(c.AccessKey)
	if err != nil {
		return nil, err
	}

	// 2. 解密
	mode := cipher.NewCBCDecrypter(block, iv)
	plainTextPadded := make([]byte, len(cipherText))
	mode.CryptBlocks(plainTextPadded, cipherText)

	// 3. 去除填充
	return pkcs7UnPadding(plainTextPadded)
}

// FetchReport 发起综合背调查询
func (c *BackgroundCheckClient) FetchReport(name, idCard, mobileNo, authUrl string) (map[string]interface{}, error) {
	// 组装必须携带授权书的明文参数
	payloadMap := map[string]string{
		"name":              name,
		"id_card":           idCard,
		"mobile_no":         mobileNo,
		"authorization_url": authUrl,
	}
	payloadBytes, _ := json.Marshal(payloadMap)

	// 加密载荷
	encryptedStr, err := c.encryptData(string(payloadBytes))
	if err != nil {
		return nil, fmt.Errorf("参数加密失败: %v", err)
	}

	reqBodyMap := map[string]string{"data": encryptedStr}
	reqBodyBytes, _ := json.Marshal(reqBodyMap)

	// 拼装时间戳
	timestamp := time.Now().UnixNano() / 1e6
	reqUrl := fmt.Sprintf("%s?t=%d", ApiUrl, timestamp)

	req, err := http.NewRequest("POST", reqUrl, bytes.NewBuffer(reqBodyBytes))
	if err != nil {
		return nil, err
	}

	req.Header.Set("Access-Id", c.AccessId)
	req.Header.Set("Content-Type", "application/json")

	resp, err := c.Client.Do(req)
	if err != nil {
		return nil, fmt.Errorf("网络通信阻断: %v", err)
	}
	defer resp.Body.Close()

	if resp.StatusCode != http.StatusOK {
		return nil, fmt.Errorf("API 通信异常，状态码: %d", resp.StatusCode)
	}

	var resJson map[string]interface{}
	if err := json.NewDecoder(resp.Body).Decode(&resJson); err != nil {
		return nil, fmt.Errorf("解析响应 JSON 失败: %v", err)
	}

	if dataStr, ok := resJson["data"].(string); ok {
		decryptedBytes, err := c.decryptData(dataStr)
		if err != nil {
			return nil, fmt.Errorf("数据解密失败: %v", err)
		}
		var finalResult map[string]interface{}
		json.Unmarshal(decryptedBytes, &finalResult)
		return finalResult, nil
	}

	return nil, fmt.Errorf("业务异常: %v", resJson["message"])
}

func main() {
	client, err := NewBackgroundCheckClient("YOUR_ACCESS_ID", "YOUR_HEX_KEY")
	if err != nil {
		panic(err)
	}

	result, err := client.FetchReport(
		"张三", 
		"11010519900101XXXX", 
		"13800138000", 
		"https://your-domain.com/auth/signed_doc.pdf",
	)
	
	if err != nil {
		fmt.Println("查询失败:", err)
		return
	}

	// 解析 responses 数组
	if responses, ok := result["responses"].([]interface{}); ok {
		fmt.Printf("背调组合包获取成功，子产品数量: %d\n", len(responses))
	}
}

3. 网关探活测试 (cURL)

Bash

jsx 复制代码

curl -X POST "https://api.tianyuanapi.com/api/v1/COMBTY17?t=1710123456789" \
     -H "Access-Id: YOUR_ACCESS_ID" \
     -H "Content-Type: application/json" \
     -d '{"data": "经过AES加密且包含授权书URL的Base64编码字符串"}'

拆解组合包矩阵：复杂响应体的数据清洗映射

本接口返回的核心数据集中在 responses 数组内。每个数组元素代表一个独立子产品的探测结果。在 Go 语言的中间件或结构体解析层，开发者必须先校验 success 标识的布尔值，再通过 api_code 对其内部嵌套的 data 对象进行降维与归类。

核心核验维度	定位路径与关键字段	业务含义说明	开发者注意 (后端清洗策略)
学历资质穿透	`data.educationLevel`
`data.learningForm`	学历层次与学习形式	强逻辑校验：重点解析 `learningForm`（学习形式）。将简历上的全日制统招声明与接口返回的"函授"、"非全日制"等标签进行严格的字符串比对，不符即触发风控挂起。
司南高危预警	`data.securityInfo.drug`
`data.securityInfo.escape`	涉毒、在逃等重点人员排查	刚性阻断：此部分代表严重的公安预警风险。在 Go 后端的规则引擎中，应将此类字段配置为最高权重，只要数值大于 0，即无条件熔断当前入职流程。
信用与逾期行为	`data.overdueRecord.m1PlusCountLast12Months`	近12个月 M1+ 逾期笔数	高管/财务防线：针对涉及资金与商业机密的核心岗位，需评估其个人财务健康度。高频严重的信贷逾期往往与潜在的职务侵占动机高度相关。
职场隐患排查	`data.labor_disputes.non_compete`	竞业限制纠纷风险	法务联动点：当识别出竞业限制纠纷时，Go 系统可自动调用内部审批流 API（如飞书/钉钉），指派专员核对候选人是否具备前雇主的解约协议。

驱动业务流：自动化核查机制的微服务落地

在 Go 语言优异的高并发性能支持下，开发团队可将该背调组件封装为内部 RPC 微服务，无缝赋能企业的多个准入场景：

大规模基础岗位流式审批

针对制造加工、物流配送等人员流动率极高、招聘体量庞大的基础业务线。将接口能力集成至移动端入职小程序，候选人线上签署授权书后，后端协程并发拉取背调快照。只要未命中"在逃涉毒"及"法院失信被执行"等红线指标，系统即可在数秒内自动推进至签约环节。
企业 ATS 系统核心节点把控

将接口深度结合于自研的 ATS（招聘追踪系统）中。在候选人从"面试通过"流转至"Offer 审批"的节点，自动化核验其 educationLevel (学历) 等信息的真实性。匹配成功则自动激活 OA 账号创建与工位分配逻辑；若数据存疑，自动生成异常摘要单转交 HR 专员复盘。
众包平台防欺诈准入滤网

外包派单平台在审核家政、网约车等非全日制用工群体时，可重点解析 antiFraudInfo (涉赌涉诈预警) 与 judiciaRiskInfos (法院案件信息)。通过筛除洗钱高风险或身负多起民事执行案件的申请者，保障平台两端用户的交易安全。

数据合规与隐私保护声明

在对接与处理由天远入职背调报告API反馈的履历数据时，技术架构与业务流程必须坚决贯彻相关数据安全与隐私保护法规。本接口在参数层强制验证 authorization_url 字段，即明确要求开发者在发起调用前，必须确保已通过合法途径获取当事人的明确知情同意及电子授权协议。严禁在非必要场景下私自调用、爬取或滥用此类高度敏感信息。

技术团队应在数据库层面落实"可用不可见"的存储策略。对于解析后的学历、婚姻状况、司法涉案等隐私快照，必须实施字段级的高强度加密（如 AES/国密算法），并建立严密的访问鉴权与调用日志审计系统。此外，系统通过接口获取的标签指标仅应作为风控模型与人工审核的客观辅助参考依据，不应单凭个别预警记录作为武断拒绝的绝对指令。用严谨的技术手段赋能合规业务，才是企业数字化转型的正道。