接口订阅：给开发同学的接入方式
提供 REST 查询接口与事件推送通道，统一 JSON 结构，字段命名带业务语义前缀。支持按赛事、球队、时间区间做增量拉取，返回结果附带数据版本与生成时间，便于做幂等处理。
- 测试密钥一个工作日内发放，沙箱与生产字段完全一致
- 请求频率按套餐分层，超限时返回明确的状态码与说明
- 提供字段字典与示例响应，联调问题当天响应
服务指标
用可核对的数字说明数据能力
下列指标取自连续运行周期的采集记录，反映的是服务当前的稳定水平，而不是理论峰值。每一项目标都标明了统计范围，便于你在评估时对照自己的业务节奏。
120项
常态化跟踪赛事
口径：含联赛、杯赛与邀请赛在内的常规赛季赛事数量
860点/场
场均结构化字段
口径：赛程、阵容、事件与技术统计字段的合计值
≤5秒
关键事件推送延迟
口径：进球、换人、判罚等事件的采集到推送间隔
99.9%
接口月度可用率
口径：按自然月统计，不含计划内维护窗口
指标口径说明：以上数据基于常规赛季节点的连续采样统计，赛事密度较低的时间段数值会相应回落，实际服务范围以需求沟通时确认的赛事清单为准。
服务分层
从赛前到赛后，五层数据逐级递进
每往下一层，数据的加工深度与可用场景都会增加。你可以只取其中一层，也可以整条链路接入，字段之间保持一致的主键与时间戳，不需要额外做关联对齐。
-
01
基础赛程层全项目覆盖
提供赛事名称、轮次、开赛时间、比赛场馆与参赛双方信息，按赛事日历滚动更新，支持按项目、联赛与时间区间筛选。变更与延期会在赛后回写状态字段，避免出现时间对不上的情况。
-
02
阵容与状态层赛前 60 分钟
输出首发与替补名单、球员位置、号码与出场状态，赛前通常提前 60 分钟更新至最新版本。临场调整会同步覆盖，接口中保留版本号，方便你判断是否为最终名单。
-
03
实时事件层秒级推送
比分变化、进球、换人、红黄牌、暂停与技术暂停等事件按发生顺序推送，每条事件带赛事主键、时间刻度与事件类型编码。推送通道与查询接口共用同一份数据，二选一接入即可。
-
04
技术统计层终场后 30 分钟
覆盖控球、射门、传球成功率、篮板、助攻、犯规等细分项，逐场逐队量化输出。统计值在终场后统一校验入库，若后续出现官方修正，会以增量记录的方式同步，不影响历史查询结果。
-
05
历史战绩层多赛季回溯
提供过往赛季的赛程、赛果与统计明细，可用于趋势对比、内容复盘与模型训练。主流联赛的回溯深度更完整，具体起始时间会在数据清单中逐项标注，不会按不存在的区间提供数据。
交付方式
接口、看板与文件，按团队分工各取所需
技术团队关心字段结构与请求限制，运营团队关心页面上能不能直接看。同一份数据源同时支持两种视角，字段命名保持一致，核对时不会出现两套口径。
可视化看板：给运营同学的视图
把赛程、比分与关键统计整理成可直接查阅的面板，切换赛事即可看到对应明细，无需再对着接口返回值做二次整理。
批量文件：给分析同学的底稿
按赛事周期打包输出结构化文件，包含赛程、赛果与统计明细，字段顺序固定，可直接导入分析工具或数据仓库做进一步加工。
组合使用：一套数据，多端一致
接口取数、看板查阅、文件归档可以同时开通。三端共用同一主键与时间戳，运营看到的名次变化和技术拉到的字段值能够相互印证，减少跨部门核对成本。
- 字段字典全站统一，避免同名字段含义漂移
- 数据修正以增量形式同步，历史查询结果保持稳定
- 服务范围调整时提前告知，不留静默变更
口径与校验
把数据怎么来的写清楚
数据能不能用，取决于口径是否说得明白。我们把采集节点、校验规则与状态标记都放在明面上，出现疑问时可以按赛事和时间区间逐条核对。
常见的数据使用困扰
- 同一场比赛在不同系统里比分不一致，找不到谁对
- 字段含义没有说明，接手的人只能靠猜
- 赛事延期后时间未更新，排期与内容计划对不上
- 统计项在终场后被改动，却没有任何变更痕迹
kaiyun 的处理方式
- 每条记录带采集时间与数据版本，可回溯到具体批次
- 字段字典随接口交付，命名规则与取值说明逐项列出
- 赛程状态变更后回写字段，延期与取消都有明确标记
- 统计修正以增量记录同步，历史结果不被静默覆写
校验环节的执行节奏
赛前完成赛程与阵容的双重核对，赛中由事件流实时写入并由规则引擎检查异常值，赛后对技术统计做一次完整校验。校验未通过的记录会标记状态，不会直接进入正式数据集。
时间说明：以上为常规比赛日的执行节奏，多赛事并发或网络波动情况下会相应延长，延长情况会在状态字段中体现。
常见问题
接入前最常被问到的几件事
如果你关心的问题不在下面，可以在页面底部提交需求，服务团队会按你的业务场景给出具体答复。
当前覆盖足球、篮球、网球、排球与电子竞技五大类项目，赛事层级包含顶级联赛、杯赛与常规邀请赛。每类项目均输出赛程、阵容、实时事件与赛后技术统计，具体赛事清单可在需求沟通时按项目逐条核对。
常规比赛日内，进球、换人、红黄牌等关键事件在数秒内推送至接口，比分与阶段状态同步刷新。赛后技术统计在终场后统一校验并入库，通常于终场后 30 分钟内完成。
- 事件推送延迟以赛点采集时间为起点计算
- 并发赛事较多时会按优先级排队处理
可以。接口订阅与可视化看板共用同一份数据源，字段命名与时间戳保持一致，便于运营同事看板核对、技术同事接口取数，避免两端口径不一致。
主流联赛的历史赛程与赛果可回溯多个赛季，技术统计的回溯深度按项目不同，足球与篮球可提供更完整的逐场细分数据。具体起始时间会在数据清单中标注，避免按不存在的区间做拉取。
测试密钥通常在提交需求后的一个工作日内发放，联调顺利的情况下，接口正式上线一般需要 3 至 7 个工作日。如果涉及批量文件的历史回补或字段映射调整，时间会相应延长。
可提交口径核对工单，说明赛事、时间区间与字段名，服务团队会给出采集节点、校验规则与计算方式的说明，必要时提供同场次样本数据用于比对。
获取方案
先说明用途，再谈数据范围
提交后服务团队会按你的项目类型整理一份数据清单，包含可用字段、更新节奏与接入方式，方便内部评估。
-
01
先说用途，不推多余模块
内容展示、运营核对、产品取数，需求不同对应字段范围也不同，方案里只保留用得上的部分。
-
02
给出可核对的清单
赛事范围、字段数量、更新频率、回溯区间逐项写清，评估时有据可依。
-
03
联调阶段有人对接
提供字段说明与示例响应，联调过程中的疑问当天给答复。