BSPORTS赛事日历
整季赛程按阶段组织，逐场带上半场比分与补时时长。赛程页、排播表与数据看板可以共用同一条时间轴，不用各自维护一份。
看字段与阶段划分
02 / 模块一览
七组数据模块，对应七种团队
如果不确定该从哪一块开始，先看每张卡片下方标注的适用团队——那通常就是您所在岗位每天都在处理的事。
阵容与伤停
出场状态、伤停部位与预计回归轮次、停赛累积一次给全，赛前两小时仍会刷新。
看状态分级裁判指派
谁执法哪一场，以及这名裁判过往的执法场次与出牌节奏，赛前就能写进前瞻稿。
看更新方式季票信息比较
把两支球队放在同一张表上比价格、比权益、比球迷结构，票务与会员团队做定价和推荐时直接引用。
看比较维度升降级形势推演
结合剩余赛程与联赛规程，算出每支球队的保级与冲超可能，赛季末的每一轮都能重新推一遍。
看推演条件俱乐部简史档案
历史赛季战绩与更名沿革，做专题、做卡片、做资料页时随取随用。
看档案结构多语种数据接口
12 种语言的字段输出，实时推送、批量导出、页面嵌入三种交付方式任选，平均响应时间低于 800 毫秒。
看交付方式
03 / 赛事日历
BSPORTS赛事日历：把一整季拆成能滚动的四个阶段
开季、中段、冲刺、收官，每个阶段球迷关心的问题不一样，需要的字段也不一样。日历按阶段切换字段组合，您的赛程页跟着阶段走就行，不用自己判断什么时候该展示什么。
开球时间在赛前 72 小时锁定，场地与轮次一并确认。这个阶段的排播表可以一次排到三个月后，适合提前做内容规划。
- kickoff 开球时间，协调世界时输出
- venue 比赛场地与轮次
- squad_status 注册名单与转会窗变动
半场比分随比赛进行写入，上下半场分界点单独标记。做实时比分条与半场小结的团队，读这一层就够了。
- ht_score 半场比分，与全场比分分开存
- status 未开赛 / 进行中 / 已结束 / 延期
- minute 当前进行分钟数
积分差距与剩余赛程开始影响推演结果，日历会把同轮次的其他场次一起返回，方便做「本轮看点」这类聚合内容。
- stage 阶段标记为「冲刺」
- round_peers 同轮次全部场次
- added_time 补时时长，以第四官员举牌为准
收官阶段的补时普遍拉长，附加赛与相互战绩条款开始生效。日历会额外返回规程相关的判定提示，供赛季总结页面引用。
- extra_round 附加赛与保级附加轮次
- h2h_note 相互战绩相关提示
- final_flag 该场是否为赛季最后一场
| 字段 | 内容 | 说明 | 更新时机 |
|---|---|---|---|
| match_id | 赛事编号 | 唯一标识一场比赛 | 赛季初生成 |
| stage | 赛季阶段 | 开季 / 中段 / 冲刺 / 收官 | 阶段切换时 |
| ht_score | 半场比分 | 上下半场分界时的比分 | 随比赛进行 |
| added_time | 补时时长 | 以第四官员举牌为准 | 每半场结束前 |
| status | 比赛状态 | 未开赛 / 进行中 / 已结束 / 延期 | 状态变化即更新 |
| venue | 比赛场地 | 比赛所在球场 | 赛前 72 小时 |
04 / 阵容与伤停
谁上不了场，赛前就该知道
名单模块分三层：一层是注册与出场资格，一层是身体状态，一层是纪律停赛。三层分开存，您可以只用其中一层，也可以整包拉取。
状态分级
- 可出场 已进入本轮名单，无非纪律性限制
- 存疑 带伤或体测未过，赛前会再次刷新
- 伤缺 附带伤停部位与预计回归轮次
- 停赛 注明剩余停赛场次，含杯赛合并计算
谁在用，怎么用
做实时比分与赛前前瞻的编辑，靠这一层判断要不要改标题；做预测类产品的团队，把它当作权重项直接入模；做会员服务的票务方，用预计回归轮次来安排球星相关的推送节奏。
阵容数据与裁判指派信息同源更新，场次名单一变，两边的字段会一起调整。
05 / 裁判指派
谁执法，会改变你怎么讲这场比赛
每场比赛执法的是谁、第几轮公布、有没有临时更换，这些都会写进场次记录。指派信息一旦公布即写入，赛前临时调整同样会刷新到对应场次。
随指派一起给出的衍生字段
执法场次
本赛季与本项赛事的累计执法数量
出牌节奏
场均黄牌与红牌数量，按赛事分别统计
判罚倾向
主客胜率差与点球判罚频次
加时经历
是否执法过加时与点球决胜场次
赛前前瞻里带上执法风格，稿子的信息密度会立刻不一样；数据研究团队可以拿它做判罚一致性的长期观察；球迷社区用它解释为什么这一场哨子特别密。
06 / 季票比较
季票信息比较两队，先看近五个赛季的区间
单看一年的票价容易被促销活动带偏。把两队放在最近五个赛季的区间里比较，价格水位、权益含金量和球迷结构的变化趋势才看得出来。票务与会员团队用它做定价参考，内容团队用它写购票指南。
比较项
A 队
B 队
差值
最低单场折算价
128 元
196 元
+68
最高档套票
4,860 元
6,240 元
+1,380
五年价格涨幅
11%
19%
+8pt
含杯赛场次
6 场
4 场
−2
优先购票轮次
3 轮
5 轮
+2
单季项目
A 队
B 队
差值
主场总场次
21 场
19 场
−2
季票持有比例
72%
58%
−14pt
续订率
86%
79%
−7pt
跨城购票比例
14%
27%
+13pt
家庭套票占比
31%
22%
−9pt
07 / 形势与档案
赛季末的每一轮，都值得重新推一遍
08 / 接口与交付
三种交付方式，挑贴合你技术栈的那种
实时推送
比分、状态与伤停变化在事件发生的同时推给您的服务端，适合实时比分条、直播页和赛事提醒。
批量导出
按赛事、赛季或日期区间拉取整块数据，适合历史分析、赛季报告与离线建模。
页面嵌入
赛程表与名单表以现成组件形式嵌进您的页面，不需要单独做一次前端开发。
采编与官方来源统一进入数据层，再由三种交付方式分发到您的产品。
字段确认后在测试环境开通，先用小批量数据跑通，再切到正式通道。多语种输出涵盖中文、英文、西班牙文、葡萄牙文、日文、韩文、德文、法文、阿拉伯文等 12 种语言，字段结构一致，仅语言标签不同。
申请接入测试
09 / 版本与支持
每季度一次版本迭代，当前对外版本 v3.7
接口保持每季度一次版本迭代，新增字段先进入预览通道，稳定后再并入正式版本。每次迭代都会给出变更清单，说明新增了什么、调整了什么、旧字段是否保留。您可以在支持中心按版本号查阅历史变更。
接入之后，字段含义、状态分级、指派规则这类问题由支持团队在工作日 9:00 至 18:00 处理，赛事数据与裁判指派相关的问题优先响应。发现比分或赛果有误，提交后在 4 小时内会得到回应，涉及赛果与比分的更正排在最前。
新增字段多久能正式使用？
新字段先进入预览通道，与合作方一起验证取值和更新频率，确认无误后随下一次版本迭代并入正式版本。
旧版本接口会保留多久？
正式版本更替后，上一版本继续提供服务，变更清单里会写明停用时间点，给迁移留出完整周期。
不同语言的字段结构一样吗？
结构一致，只有面向读者的语言标签不同。您切换语言参数即可，不需要为每种语言单独适配一套解析逻辑。
测试环境什么时候开通？
字段范围确认后即可开通，先用小批量数据跑通流程，再切换到正式通道。具体节奏可以在商务沟通中约定。
发现问题数据怎么反馈？
通过客服邮箱提交场次编号与字段名即可。涉及赛果与比分的更正会在 4 小时内响应并优先处理。