赛季列表 - AnySport

给定 league_id，返回该联赛所有历史赛季，并通过 has_results / has_standings 标注每个赛季是否有赛果、积分榜数据。这两个标志可以在做”赛季选择器”时提前过滤掉没有数据的空赛季，避免用户选中后才发现无内容。本接口也是球队列表、积分榜、射手榜等接口 season 入参的权威取值来源。

接口路径

GET /v1/soccer/seasons

入参说明

参数	类型	必填	说明
`league_id`	string	是	联赛 ID（`asl_`）
`lang`	string	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准

出参说明（data: 数组）

字段	类型	说明
`league_id`	string	联赛 ID
`season`	string	赛季标识（如 `2026`、`2025-2026`；跨年赛季用连字符）
`has_results`	boolean	该赛季是否有赛果数据
`has_standings`	boolean	该赛季是否有积分榜数据

入参示例

GET /v1/soccer/seasons?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&lang=en

出参示例

赛季接口响应示例，HTTP

{
  "success": true,
  "data": [
    {
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2026",
      "has_results": true,
      "has_standings": true
    },
    {
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2025-2026",
      "has_results": false,
      "has_standings": true
    },
    {
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2022",
      "has_results": true,
      "has_standings": true
    },
    {
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2018",
      "has_results": true,
      "has_standings": true
    }
  ],
  "meta": {
    "total": 23,
    "timestamp": "2026-07-13T19:18:22.906708200Z"
  },
  "traceId": "57e2b02e-7232-4430-ad1d-3fab3809ea1b"
}