射手榜 - AnySport

给定 league_id + season（必填），返回该赛季的球员数据排行榜，通过 kind 参数在进球（默认）、助攻、牌数三种榜单间切换。适合做”金靴榜/助攻王/纪律榜”这类赛事个人数据页面；三种榜单结构完全一致，只是 value 含义不同（进球数/助攻数/牌数），前端可复用同一套渲染逻辑。

接口路径

GET /v1/soccer/topscorers

入参说明

参数	类型	必填	说明
`league_id`	string	是	联赛 ID（`asl_`）
`season`	string	是	赛季（如 `2026`）；可由 `/seasons` 获取
`kind`	string	否	榜单类型：`goals`(默认)/`assists`/`cards`
`lang`	string	否	`en` / `zh-CN`，非法值静默回退默认语言，可选值以 `GET /languages`（19）为准

出参说明（data: 数组）

字段	类型	说明
`rank`	int	排名
`player_id`	string	球员 ID（`asp_`）
`player_name`	string	姓名
`team_id`	string	球队 ID
`team_name`	string	队名
`value`	int	对应 kind 的数值（进球/助攻/牌数）

入参示例

GET /v1/soccer/topscorers?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&season=2026&kind=goals&lang=en

出参示例

HTTP 200，total=50，节选

{
  "success": true,
  "data": [
    {
      "rank": 1,
      "player_id": "asp_dcd517a27bac41fd8657dffd91bc2f74",
      "player_name": "Lionel Messi",
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "team_name": "Argentina",
      "value": 8
    },
    {
      "rank": 2,
      "player_id": "asp_7b9e560a44b149b698e9715717611fa5",
      "player_name": "Kylian Mbappe",
      "team_id": "ast_99cc49049ab642909e034538476c64ee",
      "team_name": "France",
      "value": 8
    },
    {
      "rank": 3,
      "player_id": "asp_ec6dd3316b1a4e22bac6fa22a0744aa2",
      "player_name": "Erling Haaland",
      "team_id": "ast_f5a0ef581314471a89a41abf397b4416",
      "team_name": "Norway",
      "value": 7
    }
  ],
  "meta": {
    "total": 50,
    "timestamp": "2026-07-13T19:18:23.748207300Z"
  },
  "traceId": "304191b0-f1d2-4187-ae74-499b3e4620ae"
}

错误示例

缺 season → HTTP 400，error.code = INVALID_PARAMS

GET /v1/soccer/topscorers?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&kind=goals