实时事件流
比分与关键事件推送
进球、得分、换人、红黄牌、阶段开始与结束等节点在发生后的短时间内完成推送，适合需要即时刷新页面或触发提醒的业务。
- 事件级推送，按场次订阅
- 支持断线重连与事件补发
- 可只接收指定赛事与球队
接入服务的关键数值
以下数值为近期统计口径下的参考表现，用于说明接口的稳定性与响应水平，具体指标会在接入方案中逐项确认。
99.9%
月度接口可用性
环比提升
1.2s
事件平均推送延迟
环比下降
24组
可对接字段组
保持稳定
3类
数据域覆盖范围
按需扩展
可以接入哪些数据能力
按数据新鲜度分成三类接入方式，可以单独使用，也可以组合接入同一套系统。
常见的五类接入场景
不同团队对数据新鲜度和字段深度的要求差别很大，下面按场景列出建议的接入方式，便于快速定位。
01
赛事信息站点与资讯页
需要页面上的比分、赛程与赛果保持更新，通常采用实时事件流配合定时查询，减少页面手工维护。
02
球队与球迷社区类应用
围绕特定球队或联赛提供关注功能，建议按球队维度订阅事件，同时同步球队与球员资料字段。
03
数据看板与内部报表
以赛后统计与历史归档为主，按固定周期批量拉取，无需实时推送，追求字段口径的长期一致。
04
提醒与消息通知类功能
对延迟敏感，建议使用事件推送并在客户端做去重处理，避免网络抖动造成的重复通知。
05
系统迁移与数据补齐
新系统上线前需要历史数据支撑，可按赛季提交回补清单，我们会评估可交付范围与时间安排。
字段口径与更新说明
同一场比赛在不同数据源中的统计口径可能不同，接入前我们会与您逐项确认字段含义，避免展示层出现歧义。
- 赛事标识全局唯一，长期稳定
- 比分字段区分全场与分阶段
- 球员统计按场次与赛季两个维度
- 时间字段统一时间戳，附时区标识
- 字段变更提前通知，保留过渡期
联调与交付支持
从提交需求到正式跑通，对接过程按阶段推进，每个阶段都有明确的交付内容与确认节点。
- 需求确认数据类型与并发量评估
- 测试凭据提供样例返回与错误码
- 联合调试对接人跟进问题排查
- 正式切换灰度运行后全量接入
- 后续维护字段扩展与配额调整
接入前常被问到的问题
以下是技术对接过程中出现频率较高的几个问题，如果情况比较特殊，可以直接通过需求表单说明。
请准备业务用途说明、需要的数据类型、预估并发量与调用峰值时段、服务器所在区域，以及一位技术对接人。信息越完整，评估排期与配额建议越快。
常规赛事在事件发生后 1 至 2 秒内完成推送，网络抖动或数据源波动时会延长。页面上的平均延迟按月度统计，个别场次会高于该数值。
常规赛事的比分、赛程与基础统计可按赛季回补；更早年份的字段完整度视数据源保留情况而定，提交回补清单后我们会给出可交付范围。
超出配额时会返回限流状态码并附带重试建议时间，短时突发可以在申请后临时提额；长期超出则按实际调用量重新协商配额。
可以按业务需要裁剪返回字段以减少传输体积，也可以在数据源支持的前提下扩展技术统计类字段，扩展项会在联调阶段逐项确认口径。
联调期间提供测试数据、样例返回与错误码说明，并安排对接人跟进问题排查，直至正式环境稳定跑通。
先说明需求，再确定接入方式
提交接入清单后，我们会根据数据类型与并发量给出建议方案、调用配额与排期安排。
- 按数据类型匹配推送或查询方式
- 提供字段清单与样例返回
- 联调期安排专人跟进问题
需求咨询表单工作日 09:00–18:00 响应，紧急问题可在留言中注明。