
一、企业风险报告的必要性
在企业尽职调查、信贷风控评估、供应链管理、投融资审查以及政府监管审查等众多场景中,企业风险评估能力是进行投资决策与合规管理的关键依据。
企业风险报告API 是集工商、司法、税务、环保等多维度数据于一体的综合风险评估接口,能为企业、银行、保险、投资机构提供权威、实时的风险数据支持。
本文将深入解析该API的调用方法、数据结构与核心字段,帮助开发者快速集成,基于企业大数据构建更加完善的风控系统、尽调分析工具与合规监管平台。
https://api.tybigdata.com/enterprise-risk-reportPOSTapplication/jsonAPI-Key身份验证;请求体需进行加密(示例中提供加密函数占位符)。主要参数说明:
参数名 | 类型 | 说明 |
|---|---|---|
api_code | string | 固定为 "QYFXBG001" |
ent_name | string | 查询的企业名称 |
credit_code | string | 企业统一社会信用代码(可选) |
token | string | 调用凭证 |
curl -X POST "https://api.tybigdata.com/enterprise-risk-report" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"api_code": "QYFXBG001",
"ent_name": "海南XXXX大数据科技有限公司",
"credit_code": "91460100MA001ABCDE"
}'import requests
import json
import time
import hashlib
# === 加密函数占位符 ===
def encrypt_payload(data, secret_key):
"""
对请求体进行加密处理(示例占位函数)
实际使用中应替换为天远API提供的加密算法
"""
raw = json.dumps(data) + secret_key
return hashlib.sha256(raw.encode('utf-8')).hexdigest()
# === API请求示例 ===
url = "https://api.tybigdata.com/enterprise-risk-report"
api_key = "YOUR_API_KEY"
secret_key = "YOUR_SECRET_KEY"
payload = {
"api_code": "QYFXBG001",
"ent_name": "海南XXXX大数据科技有限公司"
}
# 加密请求体
signature = encrypt_payload(payload, secret_key)
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
"X-Signature": signature
}
try:
response = requests.post(url, headers=headers, json=payload, timeout=10)
response.raise_for_status()
data = response.json()
if data.get("code") == 0:
print("✅ 查询成功:", data["message"])
print("风险等级:", data["data"]["天眼风险"]["riskLevel"])
else:
print("❌ 查询失败:", data.get("message"))
except requests.exceptions.Timeout:
print("请求超时,请检查网络连接。")
except requests.exceptions.RequestException as e:
print("请求异常:", str(e))企业风险报告API 的返回数据以JSON格式呈现,主要分为以下模块:
数据层级结构:
data
├── 工商信息
│ ├── BASIC
│ ├── SHAREHOLDER
│ ├── PERSON
│ └── YEARREPORT*
├── 法人风险
├── 合同履约风险
├── 投融资风险
├── 债务债权
├── 司法涉诉
└── 天眼风险字段名 | 含义 | 说明 |
|---|---|---|
riskLevel | 综合风险等级 | 取值:无风险、低风险、中风险、高风险 |
riskList | 风险信息列表 | 包含自身风险、周边风险、预警提醒等数据 |
type | 风险类型代码 | 对应风险类别(0-预警、1-自身、2-周边、3-历史) |
title | 风险事件标题 | 对应风险简述 |
desc | 风险事件描述 | 风险内容简要说明 |
字段名 | 含义 | 说明 |
|---|---|---|
risk_level | 风险等级 | 企业涉诉风险等级 |
risk_score | 风险分值 | 数值0–100,越高风险越大 |
当前案件总数 | 案件数量 | 包含民事、刑事、执行、破产等 |
失信被执行人数 | 企业被列为失信被执行人的次数 | 反映信用风险 |
限高案件数 | 限制高消费记录数量 | 履约能力风险指标 |
字段名 | 含义 | 说明 |
|---|---|---|
ENTNAME | 企业名称 | 主体名称 |
CREDITCODE | 统一社会信用代码 | 唯一标识 |
FRNAME | 法定代表人 | 当前法人 |
REGCAP | 注册资本 | 货币单位人民币 |
DOM | 住所 | 企业注册地址 |
ENTTYPE | 企业类型 | 如有限责任公司 |
ENTSTATUS | 经营状态 | 如“在营(开业)” |
字段名 | 含义 | 说明 |
|---|---|---|
legalPersonName | 法人姓名 | 当前法人代表 |
regStatus | 企业状态 | 在营、注销等 |
dishonest | 是否失信 | 布尔值,true代表被列入失信名单 |
limitConsumption | 是否限高 | 是否被法院限制高消费 |
implementCount | 执行案件数 | 当前执行中案件数量 |
企业可通过API自动化生成风险报告,结合内部ERP或CRM系统,实现客户、供应商、合作伙伴的全周期风险管理。
银行及金融机构可在贷款审批、保理融资、供应链金融等场景中集成该API,对企业还款能力与信用风险进行精准评估。
投资机构可利用企业风险报告API筛选投资标的,结合司法涉诉与财务风险指标进行尽调分析。
监管部门可依托API数据进行企业动态风险预警、异常经营识别与行业风险监控。
企业风险报告API 具备数据权威性高、结构标准化、易集成、可扩展等特性。
通过本文提供的示例代码与字段解析,开发者可快速完成API接入与应用场景落地,从而构建智能化、可视化的企业风险监控系统。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。