一、关于企业风险
在企业尽职调查、金融机构风控 、供应链金融、投资决策支持等众多场景中，全面的企业风险分析数据是进行风险评估 6的关键依据。“企业风险报告API” ，能够通过整合工商、司法、税务、环保等多维度数据源，为企业、金融机构、投资机构等提供准确、及时的风险评估服务 。
本文将作为一份详细的开发文档，深入剖析天远API的这款核心产品，详细解读其返回的原始数据结构和每一个核心字段的含义，帮助开发者利用企业风险大数据进行更深层次的数据分析与企业风控 应用集成。
二、API接口调用示例
调用说明
- 接口端点：
https://api.tybigdata.com/enterprise-risk-report - 请求方式：
POST - 请求体格式：
application/json
**安全认证**：采用**API密钥认证**，所有请求均需在请求头中携带认证凭证（如 `Access-Id`） 。部分服务可能还需配置**IP白名单**。
- 请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
entName | String | 是 | 目标企业名称 |
creditCode | String | 否 | 统一社会信用代码（与entName至少提供一个） 1515 |
Curl 示例
Bash
curl -X POST 'https://api.tybigdata.com/enterprise-risk-report' \
-H 'Content-Type: application/json' \
-H 'Access-Id: YOUR_ACCESS_ID' \
-H 'Secret-Key: YOUR_SECRET_KEY' \
-d '{
"entName": "海南XXXX大数据科技有限公司",
"creditCode": "91460100MA001ABCDE"
}'
Python 示例
以下是一个完整的Python requests调用示例，包含了必要的请求头、数据体、加密/解密占位符以及错误处理逻辑。
Python
import requests
import json
import time
import hmac
import hashlib
import base64
# --- 占位符：安全与加密 ---
# 实际开发中，请替换为天远API提供的加密与签名逻辑
def get_api_signature(secret_key, body_str, timestamp):
"""
(示例) 生成API签名，具体签名逻辑请参照官方文档
"""
# 假设使用HMAC-SHA256
message = f"{timestamp}{body_str}"
signature = hmac.new(
secret_key.encode('utf-8'),
message.encode('utf-8'),
hashlib.sha256
).digest()
return base64.b64encode(signature).decode('utf-8')
def decrypt_response_data(encrypted_data):
"""
(示例) 解密响应数据，具体解密逻辑请参照官方文档
"""
print("... 正在解密响应数据 ...")
# 假设数据是明文传输或在此处解密
return encrypted_data
# --- 占位符结束 ---
def get_enterprise_risk_report(api_url, access_id, secret_key, ent_name, credit_code):
"""
调用天远API获取企业风险报告
"""
headers = {
'Content-Type': 'application/json',
'Access-Id': access_id,
# 'Timestamp': str(int(time.time())),
# 'Signature': '' # 签名通常基于时间和请求体生成
}
body = {
"entName": ent_name,
"creditCode": credit_code
}
body_str = json.dumps(body)
# (示例) 如果需要签名，请在此处生成
# headers['Signature'] = get_api_signature(secret_key, body_str, headers['Timestamp'])
print(f"--- 正在请求: {api_url} ---")
try:
response = requests.post(api_url, data=body_str, headers=headers, timeout=10)
# 检查HTTP状态码
response.raise_for_status()
# 解析响应JSON
result = response.json()
# 检查业务状态码
if result.get("code") == 0:
print("--- API业务成功 ---")
# (示例) 如果响应数据是加密的，在此处解密
# decrypted_data = decrypt_response_data(result.get('data'))
decrypted_data = result.get('data') # 假设示例中 data 未加密 return decrypted_data
else:
print(f"--- API业务失败 ---")
print(f"错误码: {result.get('code')}")
print(f"错误信息: {result.get('message')}")
return None
except requests.exceptions.HTTPError as http_err:
print(f"HTTP 错误: {http_err}")
except requests.exceptions.ConnectionError as conn_err:
print(f"连接错误: {conn_err}")
except requests.exceptions.Timeout as timeout_err:
print(f"请求超时: {timeout_err}")
except requests.exceptions.RequestException as req_err:
print(f"请求异常: {req_err}")
except json.JSONDecodeError:
print("解析响应失败：返回内容非JSON格式")
print(f"原始响应: {response.text}")
return None
# --- 调用配置 ---
API_URL = "https://api.tybigdata.com/enterprise-risk-report" # 示例端点
ACCESS_ID = "YOUR_ACCESS_ID"
SECRET_KEY = "YOUR_SECRET_KEY"
# --- 执行查询 ---
ENT_NAME = "海南XXXX大数据科技有限公司" [cite: 4]
CREDIT_CODE = "91460100MA001ABCDE" [cite: 4]
report_data = get_enterprise_risk_report(API_URL, ACCESS_ID, SECRET_KEY, ENT_NAME, CREDIT_CODE)
if report_data:
print(f"\n--- 查询成功：{report_data.get('查询企业')} ---")
print(f"查询编号: {report_data.get('查询编号')}")
print(f"工商信息模块状态: {report_data.get('工商信息', {}).get('状态描述')}") [cite: 3]
print(f"法人风险模块状态: {report_data.get('法人风险', {}).get('状态描述')}") [cite: 86]
print(f"司法涉诉风险等级: {report_data.get('司法涉诉', {}).get('risk_level')}") [cite: 285]
三、核心数据结构解析
API的响应数据主体位于data字段中。data是一个复杂的对象，包含了按模块划分的各类风险数据。开发者可以根据业务需求，按需解析相应的模块。
核心数据模块：
data.工商信息: 包含企业基本情况、股东、主要人员、变更记录、年报等。data.法人风险: 法人对外投资、任职情况及关联风险。data.司法涉诉: 企业的涉诉统计、案件详情、失信被执行人、限高信息等。data.合同履约风险: 从企业信誉、履约能力、主体资格等维度进行评分和建议。data.投融资风险: 股权结构、股东关系、知识产权等风险分析。data.债务债权: 企业的债权和债务趋势图表数据。data.欠税公告: 企业的欠税记录详情。data.税收违法: 企业的税收违法案件记录。data.环保处罚: 企业的环保处罚记录。data.行政处罚: 其他行政处罚记录。data.天眼风险: 综合风险等级和详细的风险事件列表。
四、字段详解
以下是各核心模块中关键字段的详细说明。
1. 响应顶层字段
| 字段名 | 含义 | 说明 |
|---|---|---|
code | 响应状态码 | 0表示业务成功 |
message | 响应消息 | 企业信息查询成功或错误提示 |
data | 响应数据主体 | 包含所有风险报告数据的对象 |
data.查询编号 | 查询唯一ID | 本次查询的唯一标识 |
data.查询企业 | 查询的企业名称 | |
data.统一社会信用代码 | 信用代码 | |
data.查询时间 | 查询时间戳 |
2. 工商信息 (data.工商信息.数据)
此模块数据结构复杂，分为多个子对象，如BASIC（基本信息）、SHAREHOLDER（股东信息）、PERSON（主要人员）等。
| 字段名 | 含义 | 说明 |
|---|---|---|
BASIC.ENTNAME | 企业名称 | [cite: 4] |
BASIC.FRNAME | 法定代表人 | [cite: 5] |
BASIC.REGCAP | 注册资本 | [cite: 5] |
BASIC.ESDATE | 成立日期 | [cite: 6] |
BASIC.ENTSTATUS | 经营状态 | 如：在营（开业）企业 [cite: 6] |
BASIC.ENTTYPE | 企业类型 | 如：有限责任公司(自然人投资或控股) [cite: 7] |
BASIC.DOM | 住所 | [cite: 7] |
BASIC.REGORG | 登记机关 | [cite: 7] |
BASIC.INDUSTRYCONAME | 行业门类名称 | 如：软件和信息技术服务业 [cite: 9] |
BASIC.ABUITEM | 经营范围 | [cite: 9] |
SHAREHOLDER[].SHANAME | 股东名称 | [cite: 12] |
SHAREHOLDER[].FUNDEDRATIO | 出资比例 | [cite: 13] |
SHAREHOLDER[].SUBCONAM | 认缴出资额 | [cite: 12] |
PERSON[].PERNAME | 主要人员姓名 | [cite: 19] |
PERSON[].POSITION | 职务 | 如：执行董事兼总经理、监事 [cite: 19, 21] |
ALTER[].ALTITEM | 变更事项 | [cite: 23] |
ALTER[].ALTBE | 变更前内容 | [cite: 23] |
ALTER[].ALTAF | 变更后内容 | [cite: 24] |
EXCEPTIONLIST[] | 经营异常记录 | [cite: 61] |
BREAKLAW[] | 严重违法记录 | [cite: 64] |
MORTGAGEBASIC[] | 动产抵押记录 | [cite: 66] |
STOCKPAWN[] | 股权出质记录 | [cite: 79] |
3. 法人风险 (data.法人风险.数据)
| 字段名 | 含义 | 说明 |
|---|---|---|
name | 法人姓名 | [cite: 186] |
children[] | 任职/投资列表 | 按“法定代表人”、“企业高管”、“股东”分类 [cite: 87, 114, 137] |
children[].name | 角色类型 | 如：“法定代表人” [cite: 113] |
children[].children[] | 关联公司列表 | 法人在此角色下的公司数组 |
...children[].name | 关联公司名称 | [cite: 90, 98] |
...children[].regStatus | 经营状态 | [cite: 95, 104] |
...children[].option.sxxg.dishonest | 是否失信 | true 或 false [cite: 102] |
...children[].option.sxxg.limitConsumption | 是否限高 | true 或 false [cite: 102] |
...children[].option.judicial.weiJieCount | 未结案件数量 | [cite: 100] |
4. 司法涉诉 (data.司法涉诉)
| 字段名 | 含义 | 说明 |
|---|---|---|
risk_level | 风险等级 | 无风险、低风险、中风险、高风险 [cite: 2, 285] |
risk_score | 风险分值 | 0-100，分值越高风险越大 [cite: 2, 285] |
stats.当前案件总数 | 案件总数 | [cite: 2, 187] |
stats.当前失信被执行人数 | 失信记录数 | [cite: 2, 189] |
stats.当前限高案件数 | 限高记录数 | [cite: 2, 189] |
stats.未结案总数 | 未结案数量 | [cite: 2, 190] |
stats.当前涉案总金额 | 涉案总金额 | 单位：万元 [cite: 2, 190] |
cases[] | 案件信息列表 | [cite: 2, 190] |
cases[].类型 | 案件类型 | 民事案件、刑事案件、执行案件等 [cite: 191, 213, 235] |
cases[].案号 | 案号 | [cite: 191] |
cases[].经办法院 | 经办法院 | [cite: 192] |
cases[].案件进展阶段 | 进展阶段 | 如：已结案、未结案 [cite: 193, 267] |
cases[].立案日期 | 立案日期 | [cite: 194] |
cases[].立案案由 | 案由 | [cite: 194] |
cases[].结案方式 | 结案方式 | 如：判决、调解、撤诉、终结本次执行程序 [cite: 196, 239] |
cases[].诉讼地位 | 诉讼地位 | 如：原告、被告、被执行人 [cite: 196, 239] |
dishonest[] | 失信被执行人列表 | [cite: 2, 281] |
dishonest[].执行法院 | 执行法院 | [cite: 275] |
dishonest[].履行情况 | 履行情况 | 如：全部未履行 [cite: 277] |
dishonest[].行为情形 | 失信行为 | 如：有履行能力而拒不履行... [cite: 277] |
dishonest[].发布日期 | 发布日期 | [cite: 278] |
restricted[] | 限制高消费列表 | [cite: 2, 282] |
restricted[].案号 | 案号 | [cite: 282] |
restricted[].执行法院 | 执行法院 | [cite: 283] |
restricted[].发布日期 | 发布日期 | [cite: 283] |
5. 合同履约风险 (data.合同履约风险.数据)
| 字段名 | 含义 | 说明 |
|---|---|---|
proposal | 总体建议 | 对企业履约能力的综合评价 [cite: 2, 287] |
riskTotalScore | 风险总分 | [cite: 332] |
riskInfoList[] | 风险列表 | [cite: 2, 287] |
riskInfoList[].bigRiskName | 风险大类名称 | 如：企业信誉、主体资格、履约能力 [cite: 287, 302, 310] |
riskInfoList[].bigRiskScore | 风险大类得分 | [cite: 287, 302, 311] |
...riskInfoList[] | 风险详细项列表 | |
...reviewItems | 风险审查项 | 如：当前是否被列入为限制高消费 [cite: 289] |
...reviewResult | 风险审查结果 | 审查项的具体情况描述 [cite: 289] |
...itemScore | 风险项得分 | [cite: 288] |
...itemSuggest | 风险项建议 | [cite: 289] |
6. 天眼风险 (data.天眼风险.数据)
| 字段名 | 含义 | 说明 |
|---|---|---|
riskLevel | 综合风险等级 | [cite: 2, 440] |
riskList[] | 风险信息列表 | [cite: 2, 440] |
riskList[].name | 风险分类名称 | 自身风险、周边风险、历史风险、预警提醒 [cite: 441, 504, 516, 542] |
riskList[].count | 风险事件总条数 | |
...list[] | 具体风险类型列表 | |
...list[].title | 风险类型标题 | 如：失信被执行人、经营异常、裁判文书 [cite: 453, 459, 487] |
...list[].tag | 风险标签 | 高风险、警示、提示信息 [cite: 442, 460, 543] |
...list[].total | 该类型总条数 | [cite: 442] |
...list[].list[] | 风险事件详情 | |
...list[].list[].title | 风险事件标题 | 风险事件的摘要信息 [cite: 445] |
...list[].list[].desc | 风险事件描述 | [cite: 446] |
五、应用价值分析
企业风险报告API是一款强大的风控工具，其应用价值体现在多个业务层面：
- 企业尽职调查
在投资、并购或筛选合作伙伴时，此API可提供一站式的背景审查。开发者可以通过调用接口，快速获取目标企业的工商、司法、税务、行政处罚等多维度信息，全面评估其法律风险、财务风险和合规状况 ，极大提升决策效率和准确性。
- 金融机构风控
对于银行、小贷公司等金融机构，此API是信贷审批和供应链金融风控的核心工具。通过 司法涉诉 模块可识别失信、限高、执行案件 ；通过 合同履约风险模块可评估其履约能力；通过 债务债权 模块可分析其债务趋势 。这些数据帮助机构量化企业风险水平，制定科学的授信策略。
- 动态风险监管与预警
天眼风险 模块提供了“自身风险”、“周边风险”和“预警提醒” 等动态信息。开发者可将此API集成到自有监管平台，实现对企业及其关联方（如法人、股东）风险的实时监控。当企业出现“经营异常”、“法人变更” 或新增“法律诉讼” 时，系统可自动触发预警。
- 企业合规自检
企业也可利用此API进行合规自检。通过定期查询自身的风险报告，及时发现 欠税、环保处罚 、行政处罚等问题，完善内部控制和风险管理体系，避免因合规问题导致的业务中断或声誉受损。
六、总结
天眼API 提供的 企业风险报告API是一款功能全面、数据维度广泛的专业风险评估服务。它通过标准化的RESTful API形式，将海量的工商、司法、税务、环保等数据整合输出，并提供了量化的风险评分和专业的风险分析，极大降低了开发者获取和分析企业风险数据的门槛。
对于需要构建企业风控模型、进行尽职调查或实现自动化风险监控的开发者而言，该API提供了稳定（99.9%可用性）、高性能（平均响应<2秒） 且易于集成的解决方案。建议开发者在接入时，充分利用返回数据中的风险等级 、风险评分以及 天眼风险 模块，构建多层次、自动化的风险预警机制。
