GET tournaments
根据指定的体育项目和语言,获取相应的锦标赛列表。
端点
GET /v4/tournaments请求参数
- sportId
(number)* — 所请求锦标赛所属体育项目的 ID。例如::10. - language
(a2)— (可选)返回锦标赛信息所使用的语言。默认值为en表示英文。
请求示例
GET /v4/tournaments?sportId=10&language=en响应示例
[
{
"tournamentId": 1,
"tournamentSlug": "uefa-euro",
"tournamentName": "UEFA Euro",
"categorySlug": "international",
"categoryName": "International",
"futureFixtures": 0,
"upcomingFixtures": 0,
"liveFixtures": 0
},
{
"tournamentId": 7,
"tournamentSlug": "uefa-champions-league",
"tournamentName": "UEFA Champions League",
"categorySlug": "international-clubs",
"categoryName": "International Clubs",
"futureFixtures": 108,
"upcomingFixtures": 0,
"liveFixtures": 0
},
{
"tournamentId": 8,
"tournamentSlug": "laliga",
"tournamentName": "LaLiga",
"categorySlug": "spain",
"categoryName": "Spain",
"futureFixtures": 300,
"upcomingFixtures": 0,
"liveFixtures": 0
}
]响应 (200 OK)
当请求成功时,服务器会返回状态码 200 并返回一个包含锦标赛信息的 JSON 数组。 数组中的每个对象包含以下字段:
- tournamentId
(number)— 锦标赛的唯一标识符。 - tournamentSlug
(string)— 适合用于 URL 的锦标赛名称形式。 - tournamentName
(string)— 锦标赛名称。 - categorySlug
(string)— 适合用于 URL 的类别名称形式。 - categoryName
(string)— 锦标赛所属类别的名称。 - futureFixtures
(number)— 24 小时之后开始的比赛数量。 - upcomingFixtures
(number)— 24 小时之内即将开始的比赛数量。 - liveFixtures
(number)— 当前正在进行中的比赛数量。
备注
- 端点冷却时间:1000ms
- 请确保
sportId有效,以便获取到相关的锦标赛数据。 - 响应为一个数组,如果在给定参数下未找到任何锦标赛,该数组可能为空。
