数据接口 · 供报表 / BI 取数
本接口把站内人工核校过的行业情报,以扁平表结构 对外输出,供帆软 FineReport / FineBI、Excel Power Query 等工具直接作为数据源调用。按板块返回,无需登录,支持跨域。
当前数据量
— 条目总数
— 板块数
— 含发布日期
— 站点版本
— 数据生成时间
01
端点一览
全部 GET · UTF-8 · 允许跨域
端点 说明 典型用途
/api/v1/meta.json
接口目录:板块清单、各板块条数、数据生成时间、字段中英对照
报表初始化、字段对照
/api/v1/news.json
全量扁平列表,全部板块合并,约 300 行
全量明细表、自定义筛选
/api/v1/board/{code}.json
单板块。code 取 groups / vendors / retail / cases / models
分板块报表,一个板块一个数据集
/api/v1/latest.json
各板块最新 10 条,按板块分组
首页看板、每日速览
/api/v1/news.csv
全量数据 CSV(UTF-8 带 BOM,中文表头)
不支持 JSON 的版本兜底
02
字段说明
JSON 用英文键 · CSV 用中文表头
JSON 字段 中文列名 类型 说明
item_id 条目ID 文本 由 来源链接 + 标题 哈希生成,长期稳定,可用于增量比对
board_code 板块编码 文本 groups / vendors / retail / cases / models
board_name 板块名称 文本 板块中文名
section_name 所属小节 文本 板块内二级分类(如「五大发电集团」「火电 / 热电」)
title 标题 文本 完整标题(含关键数据,多在 60–120 字)
title_short 短标题 文本 截断至 40 字,适合窄列
org 主体单位 文本 业主 / 厂商 / 机构名。约 8% 条目为空 ,未做推断
published_at 发布日期 日期 新闻发生日期 YYYY-MM-DD 。原文未明确标注年份的留空
collected_at 入库日期 日期 本批次入库日期,每行必有,可用于按批次统计
sort_index 板块内序号 整数 板块内页面顺序,越小越新 ;无日期条目可用它排新旧
tags 标签 文本 多个标签以「、」分隔,如「中标」「角色重构」
source_name 来源媒体 文本 原始媒体 / 平台名称
source_url 原文链接 URL 指向原始信源,可用于溯源核验
page_url 站内页面 URL 该条目所在的站内页面
is_new 是否新增 Y/N 是否为本批次新增条目
关于日期口径 ——约 一半 的条目,原文只写了「10 月 30 日」这类不含年份的日期,无法确定年份,接口一律留空,不用猜测值填充 。做「按时间排序」时请用
ORDER BY published_at DESC NULLS LAST, sort_index ASC ;只做「最新 N 条」时直接用 sort_index 更可靠。
03
帆软接入
FineReport / FineBI 三种方式
方式一:JSON 数据集(推荐)
数据准备 → 添加数据 → JSON 数据源 / 远程 URL → 填入
https://news.teincent.com/api/v1/board/cases.json
→ 数据路径填写 $.items[*] (写 items 也能识别,但带 [*] 才是标准 JsonPath 写法)→ 解析后 15 个字段自动成为列。
方式二:SQL 数据集 + JSON_TABLE(需 FineReport 11.0+)
数据准备 → 添加数据 → SQL 数据集 ,直接粘贴下方语句即可。与常见样例相比有三处必须注意:
① 第二参数是 '$.items[*]' ,结尾的 [*] 不能省 ——接口返回的是带元信息的对象,数组在 items 里;只有以 [*] 结尾的路径才会把数组的每个元素展开成一行 ,写成 '$.items' 只会当成单个值处理(取不到行),写 '$' 同样取不到。常见样例里能用 '$' ,是因为那种接口的根本身就是数组 ;
② sort_index 必须声明为 INTEGER ,声明成 VARCHAR 后 ORDER BY 会按字典序变成 0,1,10,11,…,16,2,3,取「最新」直接取错;
③ 判断「最新」用 sort_index (0 为最新且每条都有值),不要用 published_at ——它约一半为空,按空值排序会踩坑。
-- 取售电板块最新 1 条
SELECT *
FROM JSON_TABLE(
HTTP_GET('https://news.teincent.com/api/v1/board/retail.json'),
'$.items[*]'
COLUMNS (
item_id VARCHAR(32) PATH '$.item_id',
board_code VARCHAR(16) PATH '$.board_code',
board_name VARCHAR(32) PATH '$.board_name',
section_name VARCHAR(64) PATH '$.section_name',
title VARCHAR(512) PATH '$.title',
title_short VARCHAR(128) PATH '$.title_short',
org VARCHAR(128) PATH '$.org',
published_at VARCHAR(16) PATH '$.published_at',
collected_at VARCHAR(16) PATH '$.collected_at',
sort_index INTEGER PATH '$.sort_index',
tags VARCHAR(64) PATH '$.tags',
source_name VARCHAR(64) PATH '$.source_name',
source_url VARCHAR(256) PATH '$.source_url',
page_url VARCHAR(128) PATH '$.page_url',
is_new VARCHAR(2) PATH '$.is_new'
)
) AS t
WHERE sort_index = 0
常用变体 :
-- 最新 5 条
... ORDER BY sort_index LIMIT 5
-- 只要明确标注了发布日期的,按日期倒序取最新 1 条
... WHERE published_at <> '' ORDER BY published_at DESC LIMIT 1
-- 板块做成报表参数,code 取 groups / vendors / retail / cases / models
HTTP_GET('https://news.teincent.com/api/v1/board/' || '${board}' || '.json')
若该版本 JSON_TABLE 不认 INTEGER 类型,先改
DECIMAL(4,0) (仍是数值比较,WHERE sort_index = 0 不用改);
若还不认,再退到 VARCHAR(4) 并把条件写成 WHERE sort_index = '0' (字典序下 '0' 仍最小,取单条结果不受影响,但不要用它做 Top N 排序)。
方式三:CSV 兜底
若当前版本无 JSON 数据源插件、也不支持 HTTP_GET,直接取
https://news.teincent.com/api/v1/news.csv ,UTF-8 带 BOM、中文表头,导入即成表,无需再做字段映射。
分板块建数据集
每个板块一套数据集,只换 code:
board/groups.json 、
board/vendors.json 、
board/retail.json 、
board/cases.json 、
board/models.json 。
报表页取「最新」
用 latest.json (各板块最新 10 条),或对板块数据集加过滤 sort_index < 10 ,两者等价;只要单条就用方式二里的 WHERE sort_index = 0 。
04
调用示例
# 1. 看目录与板块条数
curl https://news.teincent.com/api/v1/meta.json
# 2. 取「电厂落地案例」板块
curl https://news.teincent.com/api/v1/board/cases.json
# 3. 取各板块最新 10 条
curl https://news.teincent.com/api/v1/latest.json
# 返回结构(board/*.json 与 news.json)
{
"apiVersion": "v1",
"generatedAt": "2026-11-04T16:40:00+08:00",
"board": "cases",
"boardName": "电厂落地案例",
"count": 103,
"items": [
{
"item_id": "cases-71e90e79b9",
"board_code": "cases",
"section_name": "火电 / 热电",
"title": "国能浙江舟山电厂 · 海岛煤电\"角色重构\"样本……",
"org": "国能浙江舟山发电有限责任公司(国家能源集团)",
"published_at": "2026-11-03",
"collected_at": "2026-11-04",
"sort_index": 0,
"tags": "深度调峰",
"source_name": "中国电力报",
"source_url": "https://news.bjx.com.cn/html/20261103/1518757.shtml",
"is_new": "Y"
}
]
}
05
使用约定
服务条款与限制
更新频率 ——每个工作周更新一次,随站点版本发布同步重建,generatedAt 字段可判断数据新鲜度。
缓存策略 ——响应带 Cache-Control: public, max-age=300 ,5 分钟内重复请求不会回源,建议报表侧缓存不低于 10 分钟。
稳定性 ——item_id 由内容哈希生成,历史条目的 ID 不会因新增条目而变化,可放心用于增量同步与去重。
使用边界 ——数据为公开信息汇编,每条均附原始信源链接;引用请保留 source_name 与 source_url ,本站不对二次加工后的口径负责。
限流 ——匿名开放,单 IP 建议不超过 60 次/分钟;如需高频批量拉取,请改用 news.csv 全量文件,一次取完。
v1 接口 字段口径与站点页面保持一致 · 站点版本 —
关于本页 :本页为对外数据接口的说明与接入指引。接口数据由 _tools/build_api.py 从站内 5 个内容页自动派生,与页面内容保持同源;站点每次更新后接口同步重建,generatedAt 为数据生成时间。
页面:首页 · 发电集团 · 软件厂商 · 售电业务 · 落地案例 · 大模型与来源 · 更新日志