比赛详情 - AnySport

按 match_id 查询单场比赛的完整基础信息，字段结构与赛程列表单条记录完全一致（相当于按 match_id 精确查询的快捷方式），适合用作比赛详情页顶部的基本信息栏（对阵、比分、状态、联赛/赛季、场馆）。注意 match_id 不存在时返回 200 + 空数组，不是 404，客户端需要自行判断数组是否为空来识别”查无此场”。

接口路径

GET /v1/soccer/matches/{match_id}

入参说明

参数	位置	必填	说明
`match_id`	path	是	比赛 ID（`as_` 前缀，全接口统一）
`lang`	query	否	可选值以 `GET /v1/soccer/languages`（19）为权威来源（如 `en` / `zh-CN`）；非法值静默回退默认语言

match_id 不存在时返回 200 且 data 为空数组（不是 404）。

出参说明

同赛程列表（/matches）单条结构，data 为含 1 元素的数组：

字段	类型	说明
`match_id`	string	比赛 ID（`as_` 前缀，全接口统一）
`date`	string	开赛日期 `YYYY-MM-DD`（UTC，ISO）
`time`	string	开赛时间 `HH:mm`（UTC）
`status`	string	三种形态，完整枚举见下方”枚举说明”
`status_label`	string	比赛状态本地化文本（如 zh-CN 下 `完场`）；`status` 原值不变，当 lang 为非默认语言、且该取值存在本地化文本时下发，无对应文本时该字段不下发、客户端需容错（`HH:MM`/纯数字分钟形态无 label）
`league`	string	联赛名
`league_id`	string	联赛 ID（`asl_`）
`season`	string	赛季
`home`	object	主队 `{ name, team_id }`
`away`	object	客队 `{ name, team_id }`
`ht_score`	string	半场比分
`ft_score`	string	常规 90 分钟比分
`et_score`	string	加时结束的累计比分（= ft + 加时段；仅加时赛场次返回）
`penalty_score`	string	点球大战比分（仅点球决胜场次返回）
`venue`	string	场馆（可能为空）

*_label 约定：当 lang 为非默认语言时，status 保留原值，另新增平行本地化标签 status_label（仅文字状态可能有本地化文本）；并非所有取值都有本地化文本，无对应文本时该字段不下发，客户端需容错。队名/联赛名（home/away/league）暂不随 lang 本地化。

枚举说明

status 有三种形态： 1). 文字状态（含义分类如下）：

分类	枚举值	含义
未开赛	`Not Started`	未开始
未开赛	`TBA`	时间待定（To Be Announced）
未开赛	“（空串）	未排期/未标注，视为未开赛
进行中	`HT`	中场休息
进行中	`ET`	加时赛进行中
进行中	`P`	点球大战进行中
进行中	`Break Time`	加时上下半场之间/加时与点球大战之间的休息（官方词表收录）
已结束	`FT`	常规时间结束（Full Time，最常见）
已结束	`AET`	加时赛后结束（After Extra Time）
已结束	`Pen.`	点球大战决出（Penalties）
已结束	`Awarded`	判负/判胜（Technical loss，弃权、资格问题等行政判定）
已结束	`WO`	弃权/不战而胜（Walkover）
延期	`Postp.`	延期（Postponed）
延期	`Delayed`	推迟开赛
取消	`Cancl.` / `Cancelled`	取消
中断	`Abandoned` / `Aban.`	比赛中断废弃
中断	`Susp.`	暂停（开赛后中断）
中断	`Int.`	中断（Interrupted）

2). HH:MM 形态（如 15:00、19:45）：未开赛，值即 UTC 开赛时间（与 time 字段一致）。 3). 纯数字形态（如 9、45、88）：进行中，值即当前比赛分钟。

入参示例

GET /v1/soccer/matches/as_3b37c382f39a4235aa93705f053b2da4?lang=en

出参示例

HTTP 200，阿根廷 vs 为累计口径：ft_score 1-1 + 加时段 2-0

{
  "success": true,
  "data": [
    {
      "match_id": "as_3b37c382f39a4235aa93705f053b2da4",
      "date": "2026-07-12",
      "time": "01:00",
      "status": "AET",
      "league": "World Cup",
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2026",
      "home": {
        "name": "Argentina",
        "team_id": "ast_9137ee449e3b40a68149ca319373adaf"
      },
      "away": {
        "name": "Switzerland",
        "team_id": "ast_499130f3976546089056d8d747b6c059"
      },
      "ht_score": "1-0",
      "ft_score": "1-1",
      "et_score": "3-1",
      "venue": ""
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 1,
    "total_pages": 1,
    "timestamp": "2026-07-13T19:18:24.456028400Z"
  },
  "traceId": "5578181f-8743-4561-9a2e-bdd337a6ec9c"
}

​接口路径

​入参说明

​出参说明

​枚举说明

​入参示例

​出参示例

接口路径

入参说明

出参说明

枚举说明

入参示例

出参示例