第一组 · 档案与前瞻
赛前就先摆上桌的四类档案
这一组解决的是“查得到、对得上”的问题。四类档案各自有固定的字段表，条目量以场次和俱乐部为单位计数，取数时不依赖单场结论。
聚焦任意条目，可展开该项服务的字段清单。
-
01
赛前前瞻档案
赛前 72 小时发布以 48,600 场历史样本为参照，列出对阵双方在六个区域分组中的客场胜率、联赛沿革与补时时长区间。前瞻只描述样本与字段，不给结果判断。
- 客场胜率
- 区域分组
- 历史样本量
- 补时参照
-
02
俱乐部简史档案
随赛季增补1,240 家俱乐部逐队建档，从成立年份、主场容量到联赛沿革与主要荣誉，用于核对球队的历史归属与赛场变更，不收录人物言论。
- 成立年份
- 主场容量
- 联赛沿革
- 主要荣誉
-
03
补时时长档案
终场后同步归档已记录 21,400 场比赛的上下半场补时，区分常规补时与伤停判罚来源，可按赛季与赛事类型回看补时分布，作为前瞻中的时长参照。
- 上半场补时
- 下半场补时
- 判罚来源
- 赛事类型
-
04
出场时间规则库
条款修订后即时同步约 4,800 条规则与术语条目，其中出场时间部分说明换人次数上限、补时是否计入出场、加时阶段的计时方式与伤停处理。
- 换人次数
- 补时计入
- 加时计时
- 伤停处理
规则解读、俱乐部历史与数据方法的展开写法，收录在前瞻与战报内容档案。
第二组 · 实时与图表
哨响之后，数据按自己的节拍推进
这一组的四项服务都挂在比赛进行中的时间线上，刷新节奏各不相同，取用时看清时间戳即可判断该条数据处在哪个阶段。
聚焦任意条目，可展开该项服务的字段清单。
-
05
半场比分流
哨响后 3 分钟内覆盖 48,600 场比赛的半场比分，中场哨响后 3 分钟内更新，按赛事与轮次推送，与射门统计共用同一场比赛编号，便于横向拼接。
- 半场比分
- 比赛编号
- 赛事轮次
- 更新时间戳
-
06
射门统计刷新
每 15 分钟刷新每场固定 14 项字段中的射门、射正、射门转化、控球率与传球成功率按 15 分钟步进刷新，越位、犯规与角球同表并列观察。
- 射门
- 射正
- 射门转化
- 控球率
-
07
赛后战报
终场后 20 分钟内上线终场后 20 分钟内上线，逐场记录比分走势、关键判罚与补时时长；与规则条目合计超过 60,000 条，可按赛季与赛事回溯。
- 比分走势
- 关键判罚
- 补时时长
- 换人记录
-
08
赛季专题时间轴
当前赛季第 5 版把一整季 42 项赛事的节点排进时间轴，六个区域分组的专题各自成线，版本随赛季推进迭代，当前为第 5 版，旧版节点保留可查。
- 赛事节点
- 区域分组
- 版本号
- 赛季阶段
第三组 · 检索与接口
把要找的字段一次定位到位
三项服务面向需要批量取数或反复核对的用法：先检索，再对照术语，最后按需要的格式带走。交付内容与站内展示保持同一套字段名。
聚焦任意条目，可展开该项服务的字段清单。
-
09
赛季与区域双轴检索
随档案更新即可查按赛季与六个区域分组两个维度交叉筛选，落到具体赛事、轮次与俱乐部，结果集直接给出对应的档案条目与战报入口。
- 赛季
- 区域分组
- 赛事
- 俱乐部
-
10
术语对照检索
随规则库更新在约 4,800 条术语与规则条目中做同义对照，同一字段在不同版本中的叫法并列显示，避免引用时把两套口径混在一处。
- 术语名
- 同义写法
- 适用版本
- 字段定义
-
11
开放数据接口
随字段版本发布以 JSON 与 CSV 两种格式交付，字段与站内展示一致；目前与 9 家数据伙伴口径互认，并为 3 家研究机构提供批量调用。
- JSON
- CSV
- 字段版本
- 批量调用
