首发阵容 - AnySport

按 match_id 返回该场比赛主客双方的阵型、首发与替补名单（predicted 标注是否为赛前预测阵容，赛前和赛后语义略有不同）。典型用于比赛详情页的”阵容”板块，可结合 formation 渲染出场位置图。注意本接口在无阵容数据时返回 404，这与本文档大多数接口”查无数据返回 200+空数组/空数组”的约定不同，客户端需要单独处理这个错误分支。

接口路径

GET /v1/soccer/lineups

入参说明

参数	类型	必填	说明
`match_id`	string	是	比赛 ID（`as_` 前缀，全接口统一）
`lang`	string	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准

该场比赛无阵容数据时返回 404（NOT_FOUND）。

出参说明（data: 对象）

字段	类型	说明
`match_id`	string	比赛 ID（`as_` 前缀，全接口统一）
`home`	object	主队阵容，结构见下
`away`	object	客队阵容，结构同 home

home / away 对象结构：

字段	类型	说明
`team_id`	string	球队 ID（`ast_`）
`team_name`	string	球队名
`formation`	string	阵型（如 `4-1-3-2`）
`predicted`	boolean	是否为预测阵容
`starters`	array	首发球员列表，元素结构见下
`substitutes`	array	替补球员列表，元素结构同 starters

starters[] / substitutes[] 元素结构：

字段	类型	说明
`player_id`	string	球员 ID（`asp_`）
`name`	string	球员姓名
`number`	string	球衣号码
`position`	string	球员位置枚举，见下方”枚举说明”
`position_label`	string	`position` 对应的本地化文本（按 lang 返回，例如 `lang=zh-CN` 时为「守门员」）；`position` 原 code 不变；当 lang 为非默认语言、且该取值存在本地化文本时下发；并非所有取值都有本地化文本，无对应文本时该字段不下发，客户端需容错

*_label 约定：position 始终保留原 code 值不变，另以平行本地化标签 position_label 返回该取值的本地化文本（按 lang）；并非所有取值都有本地化文本，无对应文本时该 label 不下发，客户端需容错。

枚举说明

position（球员位置）

枚举值	含义
`G`	守门员（Goalkeeper）
`D`	后卫（Defender）
`M`	中场（Midfielder）
`F`	前锋（Forward）

以上为常见取值，个别场次可能出现其他标注。

入参示例

GET /v1/soccer/lineups?match_id=as_3b37c382f39a4235aa93705f053b2da4&lang=en

出参示例

阵容接口出参示例，HTTP 200，已完赛场次（节选）

{
  "success": true,
  "data": {
    "match_id": "as_3b37c382f39a4235aa93705f053b2da4",
    "home": {
      "team_name": "Argentina",
      "formation": "4-1-3-2",
      "starters": [
        {
          "player_id": "asp_6f890f89feb54c82b38c46ddd89b8a1e",
          "name": "Emiliano Martínez",
          "number": "23",
          "position": "G"
        },
        {
          "player_id": "asp_0628f0c4282348cfaeadf206f652f65b",
          "name": "Nahuel Molina",
          "number": "26",
          "position": "D"
        }
      ],
      "substitutes": "…(略)"
    },
    "away": "…(结构同 home, 略)"
  }
}

​接口路径

​入参说明

​出参说明（data: 对象）

​枚举说明

​入参示例

​出参示例

接口路径

入参说明

出参说明（data: 对象）

枚举说明

入参示例

出参示例