实时比分推送
比分与比赛阶段发生变化时即时下发，客户端无需高频轮询。
爱体育电子官方网站的体育数据接口面向开发团队提供赛事数据的标准化输出。同一场比赛的比分变化、事件时间线、阵容与技术统计，会在同一套字段命名下返回，省去多源拼装和口径校正的重复工作。你既可以用推送通道订阅实时变化，也可以按需轮询获取赛程、赛果与历史数据，两种方式共用同一份字段字典。
调用方式
两条通道，一套字段
同一个赛事编号下，实时数据与查询数据指向同一份主数据，不会出现两套命名互相打架的情况。
- 推送通道：按赛事或单场比赛订阅，比分与关键事件发生变化时即时下发，适合直播页面与实时看板。
- 轮询通道：按赛程、赛果、统计等资源分页查询，适合批量同步、离线归档与定时任务。
- 统一响应：所有接口返回结构一致的 JSON 数据体，状态码、错误码与分页字段命名保持统一。
- 鉴权方式：密钥签名校验，可按业务线拆分密钥，便于独立统计调用量与排查问题。
数据覆盖
赛前、赛中、赛后串在同一条主键上
从基础资料到逐分钟事件，都用稳定的唯一编号串联。前端页面、数据大屏和后台分析拿到的是同一组事实。
- 基础资料：赛事、赛季、球队、球员与场馆等主数据，附带可长期使用的唯一编号。
- 实时数据：比分、阶段、计时、犯规、换人、伤停补时与关键事件时间线。
- 技术统计：控球、射门、传球、攻防区域等统计项，标注统计口径与更新节点。
- 历史回溯：按日期或赛季查询历史赛果与统计，用于模型训练与赛后复盘。
能力清单
按需组合的六类接口
可以只接其中一项，也可以组合成完整的数据链路。字段与主键在各类接口之间互相打通，不必为跨接口关联另做映射。
赛程与赛果查询
按日期、联赛、球队组合筛选，支持分页与增量拉取。
技术统计接口
分项统计与球队对比数据，按比赛与阶段给出结构化结果。
阵容与事件
首发、替补、换人与关键事件时间线，便于生成直播战报。
历史数据服务
多赛季归档数据支持批量导出，用于分析模型与内容生产。
赛事基础资料
联赛、球队、球员与场馆主数据，命名与编号长期保持稳定。
调用规范
把联调成本压下来的几件事
接口上线后真正耗时的是字段确认与异常排查，所以在规范、示例与支持上留足余量。
请求协议
使用 HTTPS 访问，支持 GET 与 POST，参数与响应统一采用 UTF-8 编码，请求头携带业务标识与时间戳。
响应格式
统一 JSON 数据体，包含业务状态码、提示信息与数据区，分页字段固定，便于封装通用解析层。
频率控制
按密钥维度限流，超限时返回明确错误码与恢复建议，方便客户端实现退避重试而不是盲目重发。
版本策略
新增字段默认向后兼容，不改变既有字段位置与含义；调整或下线会提前公告并保留过渡期。
调试支持
提供沙箱环境、常见语言调用示例与字段字典，联调期间可按需开通临时调用量。
监控与排障
接口可用性与响应延迟可自助查看，出现异常时在服务群同步处理进度与原因说明。
常见问题
接入前后常被问到的细节
如果这里没有覆盖你的情况，可以直接把场景发给对接人，我们按实际业务来判断。
准备业务用途说明、预计调用量与接入环境三项即可。审核通过后下发测试密钥，同时提供字段字典与调用示例，联调阶段可随时在服务群内确认细节。
不同项目与数据类型的节奏不一样，比分与关键事件属于高频更新，统计数据会在阶段节点后补齐。具体推送间隔与兜底轮询建议会写在字段字典中，接入方可以据此设置本地缓存和刷新策略。
提供 HTTPS 接口和消息推送两种方式，前者适合按需查询，后者适合实时变化的场景。两种方式共用同一份字段命名与错误码定义，切换或混用不会增加额外的适配工作。
密钥按业务线拆分，每条密钥独立统计调用量并单独限流。测试与生产可以分别申请，生产密钥可查看调用趋势，接近阈值时会提前提醒，避免影响线上业务。
字段字典会说明每一项的统计口径、取值范围与更新节点。发现与预期不一致时，把赛事编号、接口名与返回报文一起发到服务群，技术团队会核对数据源并给出结论，必要时补充说明文档。
新增字段默认向后兼容，不会改变已有字段的位置与含义。涉及字段调整或下线的变更会提前公告并保留过渡期，过渡期内新旧字段并行返回，方便你安排版本迭代。