当前位置：首页 > news >正文

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

news 2025/6/14 7:48:57

企业司法涉诉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_datadef 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 Noneexcept 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`	公布日期	被列为失信人的日期。