Skip to main content
本页列举了线上传输中使用的每一套固定词汇表。这些值是公共契约的一部分：现有值是冻结的（含义永不改变，也不会消失），新值只会以追加方式加入 —— 请在客户端中优雅地处理未知值。

​
statusId（赛事 / 期货生命周期）

每个赛事和期货的生命周期。冻结集合： 说明：
  • statusName 是翻译后的显示标签（跟随语言前缀）；statusId 是稳定的键 —— 请始终基于 ID 做分支判断。
  • 状态只会向前推进（0 → 1 → 2，或任意状态 → 3）；永远不会回退。

​
period

比分、统计和盘口数据都以一套通用赛段词汇表为键，因此相同的键适用于所有运动。一个赛段的具体含义取决于该运动的结构 —— 请使用赛事的 expectedPeriods 和 periodLength 来解读（例如 p1 在足球中是半场，在 NBA 篮球中是一节，在网球中是一盘，在电竞中是一张地图）。

​
全场键

​
编号赛段

​
组合赛段

连续赛段之和，用于以组合赛段提供盘口的场景：

​
子赛段键（盘内的局）

赛段词汇表是仅追加的：新的运动可能引入额外的键（例如飞镖 leg 或电竞回合的子赛段网格）。切勿硬编码一份穷举列表 —— 请优雅地处理未知的赛段键。

​
settlementStatus

结算端点返回的逐选项评级： 对于非明确评级（CANCELLED / UNDECIDED），结算行会带有一个 reason 字符串来解释原因。

​
开放词汇表（非枚举）

以下词汇表是随时间增长的字符串集合 —— 单个值稳定，但永不穷尽：
  • marketType —— 盘口种类（1x2、totals、spreads、players-shots 等）。参见概念 → 盘口与选项。
  • eventType —— events 频道上的比赛中动作类型（goal、card_yellow、corner_taken、substitution、var 等）。
  • statType —— stats 频道上的可计数统计聚合（score、corners、cards、aces 等）。
请将它们视为不透明标识符：匹配您支持的值，忽略其余值。