智智慧电厂行业情报站
首页 / 数据接口

数据接口 · 供报表 / 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 三种方式
  1. 方式一:JSON 数据集(推荐)
    数据准备 → 添加数据 → JSON 数据源 / 远程 URL → 填入 https://news.teincent.com/api/v1/board/cases.json → 数据路径填写 $.items[*](写 items 也能识别,但带 [*] 才是标准 JsonPath 写法)→ 解析后 15 个字段自动成为列。
  2. 方式二: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 排序)。
  3. 方式三:CSV 兜底
    若当前版本无 JSON 数据源插件、也不支持 HTTP_GET,直接取 https://news.teincent.com/api/v1/news.csv,UTF-8 带 BOM、中文表头,导入即成表,无需再做字段映射。
  4. 分板块建数据集
    每个板块一套数据集,只换 code: board/groups.json、 board/vendors.json、 board/retail.json、 board/cases.json、 board/models.json。
  5. 报表页取「最新」
    用 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 接口字段口径与站点页面保持一致 · 站点版本 —