为什么以近五个赛季为基准
季票信息比较两队时，我们取近五个赛季的区间数据。单看一个赛季，主客场分布、杯赛穿插和赛程密度都会明显影响场次数量，结论经不起追问。五个赛季的区间既能把波动摊平，又不会把球队近几年的变化一笔抹掉。
比较结果以区间上下限加中位值的形式给出，您可以直接在会员页上展示「近五季区间」的表述，不用再补一句脚注。
BSPORTS · 查阅与答疑
赛事数据问题，先在这里找答案
伤停怎么定级、裁判名单由谁排、补时算不算进半场比分、接口多久能开好——必一体育把合作方问得最多的七类问题整理在这里。每条先给结论，再讲清适用情形和具体做法，方便您的编辑、运营或技术同事直接拿去用。
4 小时
数据更正请求响应
12 种
接口支持语言
180 余人
采编与多语种团队
01 / 高频问题
最常见的十个问题
这十条几乎每周都会被问到。先看结论，如果还不够用，顺着链接进入对应章节看完整说明。
01 「出战存疑」和「缺阵」有什么区别？
缺阵表示已确认无法出场，包含伤病与停赛两类原因；出战存疑表示赛前尚无定论，通常在首发名单公布前才会收敛为确定状态。两者在您接到数据时的含义完全不同，排产线内容时别混用。
02 伤停信息多久更新一次？
名单公布后立即更新，赛前临场调整在确认后同步。多数联赛在开赛前 60 分钟内还会有一轮变化，做直播图文时建议把刷新窗口留到那时。
03 为什么同一场比赛的裁判信息会变？
临场替换、裁判自身伤病、行程调整都会触发变更。我们随场次一起更新，变更前的记录保留在历史版本里，方便往回追溯。
04 国内 BSPORTS 裁判名单按什么顺序排列？
先按场次时间，再按岗位：主裁、助理裁判、第四官员、视频助理裁判依次往下。整条名单与伤停数据同源更新，不会出现一边已换人、另一边还是旧值的情况。
05 半场比分包含补时阶段的进球吗？
包含。半场比分以主裁吹响半场结束哨时的比分为准，上半场补时内的进球计入上半场。做比分卡片时按这个值取，不会出现上下半场相加对不上的情况。
06 补时时长是怎么记录的？
以第四官员举牌显示的时间为准，上下半场分别记录为整数分钟。这个值不含哨响后实际多出的时间，做赛况时间轴时请以记录值为基准。
07 季票信息比较两队时用多长时间的数据？
以近五个赛季的区间数据为基准。单个赛季的主客场分布和赛程密度差异太大，只看一年很容易把结论带偏。
08 升降级判定看哪一条规程？
依据联赛规程第 12 条。涉及附加赛、相互战绩这类特殊情形时，按当赛季规程的补充条款处理，逐条比对后再出结论。
09 接口从申请到能用大概要多久？
字段确认后即开通测试环境，正式密钥在商务流程走完后下发。如果您的团队已经有明确字段清单，这一步通常一两天内就能开始联调。
10 发现数据和官方公布的不一致，怎么反馈？
发邮件到客服邮箱，写清赛事、场次时间、字段名和您看到的取值。涉及赛果与比分的更正优先处理，收到后 4 小时内响应。
02 / 伤停与阵容
必一伤停的定级方式与停赛累计
伤停数据会被行情、媒体和票务同时引用，一个模糊的说法足以让整条内容链出问题。所以每个状态都对应明确的判断条件：到那一刻如果没有定论，我们不会替球队下结论。
状态分四级，字段名与含义一一对应
- status
- 四级取值：缺阵、出战存疑、已恢复、停赛。缺阵用于已确认无法出场，原因可能是伤病也可能是停赛处罚。
- reason
- 标注触发原因。伤病记录部位，停赛记录累积黄牌或红牌，便于您在页面上直接生成一句可读的说明。
- since
- 状态生效的场次编号，用来追溯变化是从哪一场开始的，回看赛季走势时不必翻日志。
- return_hint
- 预计回归窗口，以「下一轮」「赛季末」这类相对表述给出，只在俱乐部或赛前发布确认后才填写。
- suspension_count
- 停赛累积数。联赛与杯赛分别计算，杯赛的黄牌通常不带入联赛，跨赛事统计时需要分开取。
更新节奏跟着名单走，不跟着日历走
伤停状态在首发名单公布后立即刷新，随后进入临场观察期。换人热身、赛前突发伤病都会在这一段出现，我们按确认信息同步，而不是按固定时间点批量重写。做直播互动的团队，建议把轮询频率压到开赛前的那一小时。
停赛累计怎么算
累计黄牌达到当赛季规程规定的张数后触发停赛，红牌按情节追加。同一名球员在不同赛事中的累计各自独立，只有规程明确写明合并计算时才归并。复出后的第一场通常仍会保留一个观察标记，避免状态跳变让您的页面出现突兀的空白。
03 / 裁判与指派
裁判名单里有什么，指派为什么会变
国内 BSPORTS 裁判名单按场次逐条列出岗位分配，比赛时间、赛事名称与轮次作为前缀字段。您拿到的不是一份人名表，而是可以直接嵌进赛程页的结构化指派信息。
-
一条记录包含哪些岗位
主裁、两名助理裁判、第四官员，以及启用视频助理裁判的赛事中的视频助理裁判团队。每个岗位独立成字段，缺失时会明确标记为该场次未设置，而不是留空。
-
什么时候发布
跟随赛事官方公布节奏同步上线，通常在开赛前若干天首次可见，赛前 24 小时内进入高频更新窗口。这段时间的变化最集中，也是编辑部最容易踩坑的地方。
-
为什么同一场比赛会换人
临场替换、裁判伤病、行程或天气导致的赛程调整，都可能让指派发生变化。每一次变更我们都保留旧值和时间戳，方便您核对某条内容发布时看到的是哪一版。
-
和伤停数据同源更新
裁判指派与伤停追踪共用同一套场次更新机制，一次场次变化会同时推动两侧刷新，避免您的页面出现一边已经换裁判、另一边还停在旧阵容的局面。
04 / 日历与赛果
赛事日历字段与赛果取值
赛事日历按赛季阶段划分场次，比分、补时和状态各自独立成字段。下面这张表是您接入时最常核对的几项，取值规则一并列出，省去来回确认的沟通成本。
| 字段 | 取值规则 | 使用时注意 |
|---|---|---|
| half_time_score | 以半场结束哨响时的比分为准 | 上半场补时内的进球计入上半场 |
| added_time_1h | 第四官员举牌显示的分钟数 | 记录为整数，不含哨响后实际多出的时间 |
| added_time_2h | 下半场举牌显示的分钟数 | 伤停与换人累计已包含在内 |
| stage | 开季、中段、冲刺、收官四段 | 影响列表排序与页面上色 |
| match_status | 已完赛、进行中、延期、取消 | 延期场次保留原始轮次，方便对照 |
阶段划分会改变字段的展示优先级：冲刺与收官阶段，积分与净胜球相关字段会前置；开季与中段则更强调轮次和赛程密度。同一套接口在不同阶段的返回顺序不同，前端请按字段名取值，不要依赖列顺序。
05 / 季票与升降级
季票信息比较两队，以及升降级怎么判
依据联赛规程第 12 条
升降级判定依据联赛规程第 12 条。同分时的排序依次看相互战绩、净胜球与进球数，具体顺序按各联赛规程文本执行，不套用统一模板。补时时长以第四官员举牌为准，这一点在计算净胜球时同样适用。
涉及附加赛、递补名额、赛季末特殊条款时，推演会先比对当赛季规程的补充说明，再给出结论。我们在结论后附上引用的条款编号，方便您直接回应读者的追问。
升降级形势推演覆盖 96 个联赛的赛季末规则。如果您的平台需要展示「还差几分保级」这类动态提示，可以直接取推演结果，不必自行实现同分排序逻辑。
06 / 接入与账号
数据接入、账号权限与响应时效
数据接入支持三种方式，看您的团队更习惯哪一种。测试环境在字段确认后开通，不用等商务流程走完才能动手。
-
01
实时推送
适合直播赛况页、比分提醒和即时资讯流。推送按场次订阅，赛场事件发生后秒级到达，您只需处理增量。
-
02
批量导出
适合赛季数据复盘、内容归档和数据仓库同步。可以按联赛、赛季阶段或时间区间拉取，一次拿全。
-
03
页面嵌入
适合票务、会员和俱乐部官网。赛程、积分与伤停模块可直接嵌入既有页面，样式跟随您的站点。
账号权限分三级
- 只读 调用数据接口，适合内容与运营团队日常取数。
- 可订阅 在只读基础上管理推送订阅与回调地址，适合技术对接人。
- 可管理 增加成员账号与密钥轮换权限，适合您的平台负责人。
几件常被问到的时间
- 字段确认后 开通测试环境，当天即可开始联调。
- 接口版本 每季度迭代一次，当前对外版本 v3.7。
- 客服在线 工作日 9:00–18:00，赛事数据与裁判指派问题优先处理。
接口平均响应时间低于 800 毫秒，单日调用量约 2.6 亿次，支持中文、英文、西班牙文、葡萄牙文、日文、韩文、德文、法文、阿拉伯文等 12 种语言。您可以在数据服务目录里对照字段清单，确认哪些能覆盖您当前的内容规划。
07 / 更正与反馈
发现数据不一致，四步走完
采编团队核对现场记录、官方赛程公告与联赛规程文本，字段生成后再做一次校验。即便如此，赛果与比分仍可能出现偏差，我们把它当成必须优先处理的事。
-
01
提交
发邮件到客服邮箱，写清赛事名称、场次时间、字段名，以及您看到的取值和依据来源。
-
02
受理
收到后 4 小时内响应。涉及赛果与比分的更正进入优先队列，其余按提交顺序排。
-
03
比对
回查现场记录与官方公告，确认是采集偏差还是公布口径差异，必要时联系赛事方核实。
-
04
回执
无论是否修改，都会告知处理结果与依据。修正后的字段与历史版本一并可查。