告别尽调黑盒：PHP高可用接入天远企业司法认证API穿透涉诉风险穿透B2B交易迷雾：用数据化解商业尽调与授信危机在复杂

穿透B2B交易迷雾：用数据化解商业尽调与授信危机

在复杂的商业博弈中，无论是引入核心供应商、发起大规模商业并购，还是银行进行企业级的融资审批，目标企业的真实运营健康度往往被粉饰过的财务报表所掩盖。许多看似资本雄厚的企业，其底层可能正深陷巨额合同纠纷、劳动争议或侵权责任等诉讼泥潭。如果合作前未能排查出这些隐性债务或失信记录，极易导致供应链瘫痪或巨额坏账。

为了精准识别这些潜藏的商业地雷，天远企业司法认证API 为开发者提供了一套高维度的查验工具。该接口专为供应商审查、商业投资评估、融资审批与并购尽职调查等场景设计。通过传入企业标识，系统能够深度聚合该企业的涉诉案件金额、涉案法院及案件状态信息，帮助风控团队在业务流转的最前端实施精准拦截。

PHP加密通信引擎：AES-128与高并发请求封装

涉及企业司法卷宗的交互，对数据链路的安全性提出了极高要求。该接口的业务请求参数（ent_code 和 ent_name）必须采用 AES-128 算法（CBC 模式，PKCS7 填充）进行加密。加密过程中需动态生成 16 字节的 IV（初始化向量），最终将 IV 与密文拼接后进行 Base64 编码，封装至请求体的 data 字段中。

以下代码展示了在 PHP 环境下，如何利用 openssl 扩展与 cURL 构建一个包含加密签名、解密校验及超时熔断机制的高可用 HTTP 客户端：

1. 核心端点与参数约束

请求方式：POST
接口地址：https://api.tianyuanapi.com/api/v1/QYGL5S1I?t=13位时间戳
公共请求头：Access-Id

2. 标准化调用代码 (PHP)

PHP

<?php

class EnterpriseLegalClient {
    private $baseUrl = "<https://api.tianyuanapi.com/api/v1/QYGL5S1I>"; // 
    private $accessId;
    private $accessKeyBytes; 

    public function __construct($accessId, $accessKeyHex) {
        $this->accessId = $accessId;
        // 账户获得的密钥为 16 进制字符串，需转换为二进制字节流以适配 AES-128 
        $this->accessKeyBytes = hex2bin($accessKeyHex);
    }

    /**
     * 核心加密逻辑：AES-128-CBC
     * PHP 的 openssl_encrypt 默认采用 PKCS7 填充 
     */
    private function _encryptPayload($payloadArray) {
        $jsonStr = json_encode($payloadArray, JSON_UNESCAPED_UNICODE);
        
        // 1. 每次加密随机生成 16 字节 (128位) 的 IV 
        $iv = openssl_random_pseudo_bytes(16);
        
        // 2. 执行 AES-128-CBC 加密 
        $cipherText = openssl_encrypt($jsonStr, 'AES-128-CBC', $this->accessKeyBytes, OPENSSL_RAW_DATA, $iv);
        
        // 3. 将 IV 和密文拼接在一起进行 Base64 编码 
        return base64_encode($iv . $cipherText);
    }

    /**
     * 核心解密逻辑
     */
    private function _decryptPayload($encryptedBase64) {
        try {
            // 1. Base64 解码 
            $rawBytes = base64_decode($encryptedBase64);
            if (strlen($rawBytes) < 16) return null;

            // 2. 提取前 16 字节作为 IV 
            $iv = substr($rawBytes, 0, 16);
            // 3. 提取剩余部分的密文 
            $cipherText = substr($rawBytes, 16);

            // 4. AES-CBC 解密（openssl自动去除 PKCS7 填充） 
            $decryptedStr = openssl_decrypt($cipherText, 'AES-128-CBC', $this->accessKeyBytes, OPENSSL_RAW_DATA, $iv);
            
            return json_decode($decryptedStr, true);
        } catch (Exception $e) {
            error_log("司法数据解密管道异常: " . $e->getMessage());
            return null;
        }
    }

    public function queryLegalRisk($entCode, $entName) {
        // 构造带有 13 位时间戳的防重放 URL 
        $timestamp = (int)(microtime(true) * 1000);
        $url = $this->baseUrl . "?t=" . $timestamp;

        // 组装明文参数：企业机构号与机构名 
        $params = [
            "ent_code" => $entCode,
            "ent_name" => $entName
        ];

        // 加密并封装入 data 字段 
        $encryptedData = $this->_encryptPayload($params);
        $postData = json_encode(["data" => $encryptedData]);

        $headers = [
            "Access-Id: " . $this->accessId, // 
            "Content-Type: application/json",
            "Content-Length: " . strlen($postData)
        ];

        // 初始化 cURL 会话
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_POST, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        
        // 核心容错：设置连接超时 3 秒，执行超时 8 秒，防止拖垮 PHP-FPM
        curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
        curl_setopt($ch, CURLOPT_TIMEOUT, 8);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); 

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        $curlError = curl_error($ch);
        curl_close($ch);

        if ($curlError) {
            error_log("CURL网络请求熔断: " . $curlError);
            return false;
        }

        if ($httpCode == 200) {
            $resData = json_decode($response, true);
            // 校验外层公共参数 code 
            if (isset($resData['code']) && $resData['code'] == 200) {
                // 解密核心业务 data 
                return $this->_decryptPayload($resData['data']);
            } else {
                error_log("业务网关拒绝调用: " . ($resData['message'] ?? '未知状态'));
            }
        }
        return false;
    }
}

// === 测试调用示例 ===
$client = new EnterpriseLegalClient("YOUR_ACCESS_ID", "YOUR_HEX_ACCESS_KEY");
$result = $client->queryLegalRisk("91110000XXXXXXXXXX", "北京测试科技有限公司"); // 

if ($result) {
    if (!empty($result['sxbzxr'])) { // 
        echo "警告：发现失信被执行人记录！\n";
    }
}
?>

3. CLI 快速联调探针

在将 PHP 代码部署至生产环境前，您可以通过标准的 Curl 命令快速验证签名与通道的连通性：

Bash

curl -X POST "<https://api.tianyuanapi.com/api/v1/QYGL5S1I?t=1708811111000>" \
     -H "Access-Id: {此处替换为您的Access-Id}" \
     -H "Content-Type: application/json" \
     -d '{"data": "{此处替换为加密后的Base64长字符串}"}'

司法诉讼特征库解码：多维涉诉指标树状映射

天远企业司法认证API 返回的核心业务数据被包裹在解密后的 JSON 中，呈现出高度结构化的层级特征。其中主要包含 sxbzxr（失信被执行人）、xgbzxr（限高被执行人）以及极具分析价值的 entout（涉诉信息案件树）。

在 PHP 开发中，建议将其映射为多维数组，并重点关注以下特征字段以驱动风控引擎：

风险模块	核心字段名	业务价值说明	开发者注意 (风控干预建议)
失信被执行人	`sxbzxr`	返回“老赖”记录，包含失信被执行人行为具体情形 (`xwqx`) 及被执行人的履行情况 (`lxqk`)	绝对红线。一旦该数组非空且 `lxqk` 显示未履行，无论其注册资本多高，系统应直接触发强拒绝策略。
限高被执行人	`xgbzxr`	限制高消费记录	需提取以评估企业法定代表人或实际控制人的流动性危机。限高记录往往是企业资金链断裂的先兆。
涉诉信息大类	`entout.civil`	区分行政案、民事案件 (`civil`)、执行案件 (`implement`)、强制清算与破产案件 (`bankrupt`) 等	必须重点下钻 `bankrupt` 和 `implement`。如果命中破产清算，投资或授信评估应立即终止。
案件执行金额	`entout.cases.n_sqzxbdje`	申请执行标的金额	核心财务量化指标。需结合 `n_wzxje` (未执行金额) 计算企业的“刚性潜在负债敞口” 。
案件阶段标签	`entout.cases.n_ajjzjd`	当前诉讼的进展阶段	对于处于“执行保全审查”阶段的案件（`preservation` ），意味着目标企业核心资产随时面临法院冻结，风险极高。

驱动数智化决策：API在三大核心场景的高阶落地

将接口返回的司法结构化数据融入 PHP 业务流，企业可以实现从被动查询到主动阻断的风控跃升：

供应商审查：构建动态反脆弱屏障在企业的 SRM系统中，确立供应商无重大涉诉案件是降低供应链风险的核心诉求。利用 PHP 守护进程定期调用 API，扫描 entout.civil 下的合同纠纷与侵权责任。若发现某核心供应商新增巨额执行标的，系统可自动下调其供货份额，并推送告警给采购专员。
融资审批：信贷模型的智能化定损银行及商业保理在审批企业贷款时，验证其法律合规性是不可逾越的红线。在信贷引擎中，可将 n_sqzxbdje (申请执行标的金额) 和 n_bqqpcje (被请求赔偿金额) 动态转换为企业的“或有负债”。当系统测算发现或有负债超过企业当期现金流承载力时，信贷审批流自动将该笔进件降级。
商业投资与并购尽调：穿透隐匿债务在商业投资评估或并购尽职调查中，核查目标企业的涉诉情况是确保交易顺利进行的关键。通过并行调取目标企业及其关联公司的司法状态，重点梳理 n_jaay_tag (结案案由标签) 与 n_dzzm_tree (定罪罪名树) ，生成全景式法律健康度报告，为估值谈判提供无法篡改的数据支撑。

数据合规边界：敏感司法信息的安全存储与隐私声明

在深度集成天远企业司法认证API并获取企业底层的涉诉卷宗后，开发者必须将数据安全与隐私合规置于系统设计的首位。由于接口返回的 sxbzxr（失信被执行人）、xgbzxr（限高被执行人）及具体的案件执行标的（如 n_sqzxbdje）等字段均属于高度敏感的商业信誉数据，在业务落地时必须严格遵循“最小必要”与“授权查询”原则。

建议在前端应用层对核心涉案金额及当事人信息进行脱敏展示，同时在数据库落盘时采用高强度的二次加密机制。虽然我们在传输层已经基于 AES-128 构建了安全的加密通信管道，但在企业内网流转时，仍需建立完善的访问控制策略与操作审计日志。确保每一次针对目标企业的风控查验都能追溯到具体的业务审批节点，在利用数据穿透商业风险的同时，坚守信息安全与法律合规的底线。