实时比分 - AnySport

按 match_id 查询单场比赛的实时比分与阶段（phase），供客户端轮询获取最新比分。本接口只给”结果”（比分、当前分钟、阶段），不含具体事件（进球者、黄牌、角球等）；需要逐条事件时用实时赛况。典型用于比分条/悬浮比分组件这类只关心”现在几比几、踢到第几分钟”的轻量场景；判断比赛是否结束统一用 phase == "finished"，而不是猜测 status（本接口不下发 status 字段）。

接口路径

GET /v1/soccer/livescore

入参说明

参数	类型	必填	说明
`match_id`	string	是	指定比赛（`as_` id，与 /matches 一致）；实时比分按单场查询
`lang`	string	否	语言，默认 `en`，非法值静默回退默认语言，可选值以 `GET /v1/soccer/languages` 为权威来源
`page` / `limit`	int	否	分页

如何发现”未开始 / 正在进行”的比赛：

/matches/window（推荐）：如 from_days=0&to_days=0 拉当日全部赛程，再按 status 形态判读：未开赛 = HH:MM / Not Started / TBA / 空串，进行中 = 纯数字分钟 / HT；查到的 match_id 可直接用于本接口。
/odds/live 不带 match_id：返回当前在售滚球（进行中）比赛集合。

出参说明（data: 数组）

本地化说明：lang= 非默认语言时，home/away/league（队名/联赛名）暂不随 lang 本地化；phase_label 等 *_label 标签正常生效，phase 原 code 值不变。并非所有取值都有本地化文本；无对应文本时该字段不下发，客户端需容错。

本接口只下发比分信息，不含源状态码（status）字段；比赛阶段/结束判定统一用 phase。如需事件级状态（进球/角球/VAR 等，英文 code）请使用 15 比赛态势接口。

字段	类型	说明
`match_id`	string	比赛 ID（`as_` 前缀，与引用类同 id）
`home`	string	主队名
`away`	string	客队名
`league`	string	联赛名（滚球流命名，如 `World Cup 2026`）
`minute`	int	当前分钟。连续计时：上半场 0-45+、下半场 46-90+、加时 91-120+；补时直接累加，不回表
`phase`	string	阶段枚举：`regular` / `extra_time` / `penalty` / `finished`；判结束用 `phase == finished`
`phase_label`	string	`phase` 的本地化文本（按 `lang` 返回，例如 `lang=zh-CN` 时为「已结束」）；`phase` 原 code 不变，当 `lang` 为非默认语言、且该取值存在本地化文本时下发，无对应文本时不下发，客户端需容错
`home_score`	int	主队当前总进球（含加时进球，不含点球大战）
`away_score`	int	客队当前总进球（含加时进球，不含点球大战）
`ht_score`	string	半场比分（如 `1-0`），未到半场为空
`reg_score`	string	常规 90 分钟结束比分（如 `1-1`），90 分钟未结束为空
`et_score`	string	加时赛结束的累计比分（如 `3-1`），无加时或未播报时为空；与引用类 matches 的 `et_score` 同口径
`penalty_score`	string	点球大战比分，无点球大战为空
`updated_at`	string	更新时间，UTC ISO-8601（带 `Z`）

枚举说明

phase 枚举（4 值）

枚举值	含义
`regular`	常规进行中（默认值）。注意：加时赛进行中的普通攻防帧也归 `regular`（源事件码不区分），只有加时的显式边界帧（加时开球/加时中场/加时下半场开始）瞬间为 `extra_time`；判断”是否在加时”，用 `minute > 90` 更可靠
`extra_time`	加时边界事件帧：加时开球 / 加时中场休息 / 加时下半场开始
`penalty`	点球大战：点球大战开始、罚进/罚失、待罚的帧
`finished`	全场结束：常规全场结束或加时全场结束

入参示例

GET /v1/soccer/livescore?match_id=as_3b37c382f39a4235aa93705f053b2da4

出参示例

HTTP 3-1 含加时

{
  "success": true,
  "data": [
    {
      "match_id": "as_3b37c382f39a4235aa93705f053b2da4",
      "home": "Argentina",
      "away": "Switzerland",
      "league": "World Cup 2026",
      "minute": 120,
      "phase": "finished",
      "home_score": 3,
      "away_score": 1,
      "ht_score": "1-0",
      "reg_score": "1-1",
      "et_score": "3-1",
      "updated_at": "2026-07-12T03:45:50Z"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "total_pages": 1,
    "timestamp": "2026-07-13T19:18:24.905164900Z"
  },
  "traceId": "87775517-5dbe-4005-be80-347fd30ea39a"
}

错误示例

缺 match_id → HTTP 400，error.code INVALID_PARAMS

GET /v1/soccer/livescore?limit=5

​接口路径

​入参说明

​出参说明（data: 数组）

​枚举说明

​phase 枚举（4 值）

​入参示例

​出参示例

​错误示例

接口路径

入参说明

出参说明（data: 数组）

枚举说明

phase 枚举（4 值）

入参示例

出参示例

错误示例