订阅实时赛况 - AnySport

赛况数据流推送对应 REST 的实时赛况接口，是四种推送数据流里信息量最大的一种，包含进球、红黄牌、角球、换人等全部关键事件，以及控球坐标和技术统计，适合驱动比赛详情页的文字直播时间线。

订阅 / 取消

方向	code	说明
客户端订阅	`20000`	`data` 必填（可为 `{}`）
服务端订阅成功	`20001`	`msg=ok`
客户端取消	`21000`
服务端取消成功	`21010`	`msg=ok`

实时赛况订阅示例

{
  "code": 20000,
  "trace": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "data": {
    "api_key": "YOUR_API_KEY",
    "match_id": null
  }
}

推送外层字段（`situation_update`）

字段	必填	类型	说明
`type`	是	string	固定 `situation_update`
`data`	是	object	单场赛况数据（见下表）
`timestamp`	是	string	服务端推送时间（ISO-8601）

`data` 字段说明

字段	是否一定有	类型	说明
`type`	通常有	string	数据类型标识，一般为 `situation`
`match_id`	通常有	string	比赛 ID
`home_team`	通常有	string	主队名称
`away_team`	通常有	string	客队名称
`league`	可能为空	string	联赛名称
`match_time`	可能为空	string	开赛时间
`status`	可能为空	string	比赛状态（如 `live` / `finished`）
`minute`	可能为空	int	当前比赛分钟
`ball_xy`	可能为空	string	球坐标，格式如 `"0.52,0.48"`
`events_json`	可能为空	object/array	事件明细（进球、红黄牌、换人等）
`stats_json`	可能为空	object/array	技术统计
`source_updated_at`	可能为空	string	数据源更新时间
`push_ts`	可能为空	string	上游推送时间
`received_at`	可能为空	string	服务端接收时间

推送字段在无数据时可能省略（null 字段通常不输出）。客户端应按「字段可能缺失」做兼容。events_json/stats_json 的具体结构与 REST 实时赛况中的 events/stats 字段一致。

实时赛况推送示例

{
  "type": "situation_update",
  "data": {
    "type": "situation",
    "match_id": "1234567",
    "home_team": "Manchester United",
    "away_team": "Arsenal",
    "league": "Premier League",
    "match_time": "2026-07-13T15:00:00Z",
    "status": "live",
    "minute": 67,
    "ball_xy": "0.52,0.48",
    "events_json": {},
    "stats_json": {},
    "source_updated_at": "2026-07-13T15:67:01Z",
    "push_ts": "2026-07-13T15:67:01.123Z",
    "received_at": "2026-07-13T15:67:01.200Z"
  },
  "timestamp": "2026-07-13T15:67:01.250Z"
}