企业司法涉诉API (QYGL8271) 技术文档：原始字段全解与风控应用 | 天远API企业司法涉诉API, 企业风险

企业司法涉诉API (QYGL8271) 技术文档：原始字段全解与风控应用 | 天远API

摘要

本文是天远API企业司法涉诉API（接口代码：QYGL8271）的官方技术文档。我们将对该接口返回的原始数据进行全面、深入的拆解，详细解释包括刑事案件、民事案件、执行案件、失信被执行人及限制高消费等在内的所有核心字段。本文档旨在为从事企业风控、供应链审核、尽职调查和法律科技（LegalTech）领域的开发者，提供一份详尽、精确的API集成与应用指南。

核心关键词: 企业司法涉诉API, 企业风险查询, 司法大数据, API技术文档, 天远API, QYGL8271, 企业背景调查, 供应商审核, 企业信用报告。

一、 API 接口概述与调用

1.1 接口功能

企业司法涉诉API (QYGL8271) 提供对特定企业实体的全面司法诉讼信息查询。通过输入企业名称和统一社会信用代码，可以获取该企业相关的历史及当前的诉讼、执行、失信等记录。

1.2 接口详情

Endpoint: https://api.tianyuanapi.com/api/v1/QYGL8271
Method: POST
认证: 请求头（Headers）中需包含您的专属 Access-Id。
加密: 为保障数据安全，请求体与响应体中的业务数据（data字段）均使用 AES-128-CBC 对称加密。

1.3 Python `requests` 调用示例

import requests
import json

# 假设您已根据天远API文档实现了加密和解密工具函数
# from tianyuan_crypto_utils import encrypt_data, decrypt_data

def query_company_judicial_risk(company_name, credit_code):
    api_url = "https://api.tianyuanapi.com/api/v1/QYGL8271"
    access_id = "YOUR_ACCESS_ID"  # 请替换为您的Access ID
    
    # 1. 准备业务参数
    params = {
        "ent_name": company_name,
        "ent_code": credit_code,
        "description": "企业司法涉诉查询" # 可自定义描述
    }

    # 2. 加密数据 (此处为伪代码)
    # encrypted_payload = encrypt_data(json.dumps(params))
    encrypted_payload = "这里是您加密业务参数后得到的Base64字符串"

    # 3. 构建请求
    headers = {'Content-Type': 'application/json', 'Access-Id': access_id}
    request_body = {"data": encrypted_payload}

    try:
        response = requests.post(api_url, headers=headers, json=request_body, timeout=30)
        response.raise_for_status()
        response_json = response.json()
        
        # 4. 检查业务状态码并解密
        if response_json.get('code') == 0:
            # decrypted_result_str = decrypt_data(response_json.get('data'))
            # result = json.loads(decrypted_result_str)
            # print(json.dumps(result, indent=2, ensure_ascii=False))
            print("API请求成功，请解密返回的data字段获取详细司法数据。")
            return response_json # 实际应用中应返回解密和解析后的数据
        else:
            print(f"API业务错误: {response_json.get('message')}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"网络请求或HTTP异常: {e}")
        return None

# 调用示例
# query_company_judicial_risk("示例公司名称", "示例统一社会信用代码")

二、返回数据结构与字段全解

API返回的核心业务数据位于解密后JSON的data.entout[0].entout字段中（该字段为JSON字符串，需再次解析）。其内部包含了按案件类型组织的详细数据。

2.1 案件类型 (Case Types)

API返回的数据按以下案件类型进行组织，您可以在返回的entout对象中找到对应的键名。

字段名	案件类型	核心风险信号
`criminal`	刑事案件	欺诈、挪用、侵占等严重违法犯罪行为。
`civil`	民事案件	合同纠纷、债务问题、侵权等，反映企业履约能力和商业信誉。
`administrative`	行政案件	环保、税务、工商等方面的合规性风险。
`implement`	执行案件	企业作为被执行人，反映其偿债能力和资产状况。
`bankrupt`	强制清算与破产案件	企业经营出现严重困难，濒临倒闭的重大风险信号。
`preservation`	非诉保全审查	资产可能被诉前冻结，存在潜在重大纠纷。
`sxbzxr`	失信被执行人信息	即"老赖"，企业信用破产的标志，融资、招投标等严重受限。
`xgbzxr`	限制高消费信息	企业或其法人、高管的消费行为受限，是执行案件的常见衍生风险。

2.2 案件详情通用字段 (`cases`对象)

在每个案件类型（如criminal）下都包含一个cases数组，数组中的每个对象代表一个案件。以下是大部分案件通用的核心字段。

字段名	含义	数据类型	说明
`c_id`	案件唯一ID	String	平台内部唯一ID。
`c_ah`	案号	String	法院分配的唯一案件编号。
`d_larq`	立案时间	String	格式通常为 `YYYY-MM-DD`。
`d_jarq`	结案时间	String	如果案件已完结，则有此字段。
`n_jbfy`	经办法院	String	受理该案件的法院名称。
`n_laay`	立案案由	String	案件的核心原因，如"买卖合同纠纷"、"民间借贷纠纷"。
`n_jaay`	结案案由	String	结案时认定的案由。
`n_jafs`	结案方式	String	如"判决"、"调解"、"撤诉"等。
`n_slcx`	审理程序	String	如"一审"、"二审"、"再审"、"执行"等。
`n_ssdw`	诉讼地位	String	企业在该案件中的角色，如"被告"、"原告"、"被上诉人"。
`c_dsrxx`	当事人信息	Array	对象数组，结构化地列出案件所有当事人及其诉讼地位。

2.3 各类案件特有字段

刑事案件 (`criminal.cases`)

字段名	含义	说明
`n_dzzm`	定罪罪名	法院最终认定的罪名，如"合同诈骗罪"。
`n_pcjg`	判处结果	具体的判决结果，如"有期徒刑三年"。
`n_fzje`	犯罪金额	涉案的犯罪金额。
`c_gkws_pjjg`	判决结果(文本)	裁判文书中的判决结果原文。

民事/行政案件 (`civil.cases`, `administrative.cases`)

字段名	含义	说明
`n_qsbdje`	起诉标的金额	原告起诉时要求的金额。
`n_jabdje`	结案标的金额	最终判决或调解确定的金额。
`n_pj_victory`	胜诉估计	基于大数据分析的胜诉可能性评估。

执行案件 (`implement.cases`)

字段名	含义	说明
`n_sqzxbdje`	申请执行标的金额	申请人请求强制执行的金额。
`n_sjdwje`	实际到位金额	已执行到位的金额。
`n_wzxje`	未执行金额	尚未执行到位的金额，反映偿债缺口。

2.4 失信与限高记录

失信被执行人 (`sxbzxr`)

字段名	含义	说明
`xwqx`	失信行为具体情形	导致被列为失信的具体行为，如"有履行能力而拒不履行"。
`yw`	生效法律文书确定义务	判决书等要求履行的义务。
`lxqk`	被执行人的履行情况	如"全部未履行"、"部分未履行"。
`fbrq`	公布日期	被列为失信人的日期。

限制高消费 (`xgbzxr`)

字段名	含义	说明
`ah`	案号	关联的执行案件案号。
`fbrq`	发布日期	限高令的发布日期。
`zxfy`	执行法院	发布限高令的法院。

三、应用价值

理解这些精确的原始字段，能为您的业务带来巨大价值：

构建精细化风控模型: 可基于案由、诉讼地位、罪名、失信行为及各类涉案金额，构建比通用信用分更贴合自身业务场景的量化风控模型。
自动化尽职调查: 结构化的数据可直接用于自动化生成详尽、专业的企业背景调查报告，极大地提升审核效率。
供应链风险预警: 通过监控核心供应商的执行案件和破产清算信息，可提前预警潜在的供应链断裂风险。

四、获取API密钥

要开始集成和使用企业司法涉诉API，您需要获取专属的Access-Id和Encryption-Key。

请访问 天远API开放平台官网 注册并获取您的API密钥。

五、关键词 (Keywords)

企业司法涉诉API, 企业风险查询API, 司法大数据, API技术文档, 天远API, QYGL8271, 企业背景调查, 供应商审核, 企业信用报告, 尽职调查, LegalTech, 合规科技, 失信被执行人查询, 限制高消费查询。

企业司法涉诉API (QYGL8271) 技术文档：原始字段全解与风控应用 | 天远API