4.5 核心接口精讲①：赛事、赛程与今日总览

这一篇拆解赛事域的四个接口。它们是所有分析的入口。

一、/today/digest 今日赛事总览（5 点）#

用途#

一次性获取当天值得关注的比赛概览，是「每日选题」场景的最佳入口。

什么时候用#

• 做每日速览类内容；
• 批量筛选当天要重点分析的场次；
• 做自动化选题脚本。

相比 /fixtures 的优势#

二、/fixtures 比赛日程（2 点）#

常用参数#

返回内容#

每场比赛的基本信息 + fixture_id。这个 ID 是后续所有详情类接口的钥匙。

三、/fixtures/{id} 单场比赛详情（2 点）#

用途#

获取单场比赛的基础信息：时间、场地、双方、当前状态、比分（如已开始或结束）。

典型用法#

• 赛前确认比赛时间与场地；
• 赛后获取最终比分；
• 作为其他详情接口的前置校验。

成本提示#

只有 2 点，是全场最便宜的信息接口之一。如果你只需要「这场比赛谁对谁、什么时间」，用它即可，不要调 50 点的 match-pack。

四、/h2h 两队交锋历史#

用途#

获取两队历史交锋记录，用于背景铺垫。

使用时的重要提醒#

历史交锋的参考综合性价比，被普遍高估。
三年前的交锋由不同教练、不同阵容完成，对当前比赛的参考意义有限。
正确用法：只取最近 3~5 次交锋，且要检查当时的双方教练与核心球员是否仍在队。

五、赛事域实战流程#

1. /today/digest → 快速扫一遍今天有哪些值得看；
2. 选定目标场次 → 用 /fixtures 或 digest 拿到 fixture_id；
3. /fixtures/{id} → 确认基础信息（2 点，便宜）；
4. 需要深度 → 调 /match-pack/{id}（50 点）。

六、一个成本优化技巧#

如果你要分析 10 场比赛：

先筛选，再深挖。这是最有效的省钱策略。

下一步该看什么#

• 旗舰接口详解 → 4.6 match-pack 精讲
• 球队与球员接口 → 4.7 精讲③