API开发者手册：企业风险报告接口接入与返回数据解析

一、引言

在实际项目开发中，企业风险评估是金融风控、供应链管理与投资决策的重要环节。
天远API 提供的 企业风险报告API 能快速整合工商、司法、税务、环保等多维度数据，
帮助开发者在系统中轻松实现企业风险监测与可视化分析。

本文将带你用 Node.js 实现完整的接口调用流程，
包括请求示例、字段解析和典型业务场景，帮助你在实际项目中快速落地。

二、API接口调用示例

调用说明

• 接口地址：https://api.tybigdata.com/enterprise-risk-report
• 请求方式：POST
• 认证方式：API-Key + 签名（需加密）
• 返回格式：JSON

curl示例

curl -X POST "https://api.tybigdata.com/enterprise-risk-report" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api_code":"QYFXBG001","ent_name":"深圳市天远科技发展有限公司"}'

Node.js示例

const axios = require('axios');
const crypto = require('crypto');

// === 加密函数占位符 ===
function makeSignature(payload, secretKey) {
  return crypto.createHash('sha256')
    .update(JSON.stringify(payload) + secretKey)
    .digest('hex');
}

const url = 'https://api.tybigdata.com/enterprise-risk-report';
const apiKey = 'YOUR_API_KEY';
const secretKey = 'YOUR_SECRET_KEY';

const payload = {
  api_code: 'QYFXBG001',
  ent_name: '深圳市天远科技发展有限公司'
};

const signature = makeSignature(payload, secretKey);

axios.post(url, payload, {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'X-Signature': signature,
    'Content-Type': 'application/json'
  }
})
.then(res => {
  const data = res.data;
  if (data.code === 0) {
    console.log('风险等级:', data.data.天眼风险.riskLevel);
  } else {
    console.warn('调用失败:', data.message);
  }
})
.catch(err => {
  console.error('请求异常:', err.message);
});

三、核心数据结构

data
├── 工商信息
├── 法人风险
├── 投融资风险
├── 司法涉诉
└── 天眼风险

四、字段详解（部分）

字段名	含义	说明
riskLevel	风险等级	无风险/低风险/中风险/高风险
riskList	风险事件	详细的风险列表
ENTNAME	企业名称	查询目标企业
CREDITCODE	统一社会信用代码	企业唯一标识

五、应用价值

• 快速集成至Node后端接口，供前端展示企业风险雷达图；
• 适配企业内部BI或风控平台，实现实时风险查询；
• 可结合可视化组件（ECharts）绘制企业风险趋势图；
• 支持批量任务调度，周期性监测重点企业。

六、总结

天远API为开发者提供了标准化RESTful接口与可靠数据源，
通过Node.js调用方式可轻松集成至任意企业级系统，
助力开发者打造高效、精准的企业风险评估工具。