国家列表 - AnySport

返回可用的国家/地区目录（除具体国家外，也包含 WorldCup、Africa 这类跨国家的赛事分组，本质上是联赛所属的”顶层分类”）。通常作为整个筛选链路的第一级：拿到 country_id 后可传入联赛列表按国家过滤联赛，再逐级取得 league_id、season 用于赛程、积分榜等接口。数据基本静态，建议客户端做本地缓存，无需频繁调用。

接口路径

GET /v1/soccer/countries

入参说明

参数	类型	必填	默认	说明
`lang`	string	否	en	名称类字段语言，`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准
`page`	int	否	1	页码，从 1 开始
`limit`	int	否	50	每页条数，范围 1~100

出参说明（data: 数组）

字段	类型	说明
`country_id`	string	国家 ID（`asx_` 前缀）
`name`	string	国家名

响应外层为统一信封：success / data / meta（total、page、limit、total_pages、timestamp）/ traceId。

入参示例

GET /v1/soccer/countries?lang=en&limit=5

出参示例

国家列表接口响应示例（节选）

{
  "success": true,
  "data": [
    {
      "country_id": "asx_e18197c190ef4b678d07834c38c10c2e",
      "name": "Africa"
    },
    {
      "country_id": "asx_f4700680835741f8b72d2b53206b9d9c",
      "name": "Albania"
    }
  ],
  "meta": {
    "total": 186,
    "page": 1,
    "limit": 5,
    "total_pages": 38,
    "timestamp": "2026-07-13T19:18:22.645162500Z"
  },
  "traceId": "792c1447-dcab-435b-bedb-9c99df2f24df"
}