导入
赛程端点
学习如何使用赛事端点获取赛事信息。
我们可以使用 fixtures 端点 获取比赛信息。该端点每 15 秒更新一次。此端点的基础 URI 为 https://v3.football.api-sports.io/fixtures。
查询参数
以下是 fixtures 端点的查询参数：
| 参数 | 类型 | 分类 | 描述 |
|---|---|---|---|
| id | 整数 | 可选 | 指定比赛的 ID。 |
| live | 字符串 | 可选 | 若值为 all，则获取所有正在进行的比赛数据；若为联赛 ID，则获取指定联赛的比赛数据。 |
| date | 字符串 | 可选 | 指定要查看的比赛日期，格式为 "YYYY-MM-DD"。 |
| league | 整数 | 可选 | 指定要获取比赛的联赛 ID，可通过 leagues 端点获取该 ID。 |
| season | 整数 | 可选 | 指定要查看的比赛赛季年份，格式为 "YYYY"。 |
| team | 整数 | 可选 | 指定要获取比赛的球队 ID，可通过 teams 端点获取该 ID。 |
| last | 整数 | 可选 | 指定要获取的最近比赛数量，应为两位数字。 |
| next | 整数 | 可选 | 指定要获取的未来比赛数量，应为两位数字。 |
| from | 字符串 | 可选 | 指定查询的起始日期，格式为 "YYYY-MM-DD"。 |
| to | 字符串 | 可选 | 指定查询的结束日期，格式为 "YYYY-MM-DD"。 |
| round | 字符串 | 可选 | 指定要查看的比赛轮次，轮次编号可通过 rounds 端点获取。 |
| status | 字符串 | 可选 | 指定比赛的状态，有效状态列表见下表。 |
| timezone | 字符串 | 可选 | 指定要查看比赛的时间区域，有效时区可通过 timezone 端点获取。 |
fixtures 端点的有效状态
以下是可在 fixtures 端点中使用的有效状态列表：
| 状态 | 全称 |
|---|---|
| TBD | 未确定时间 |
| NS | 未开始 |
| 1H | 上半场，开赛 |
| HT | 半场休息 |
| 2H | 下半场，下半场开始 |
| ET | 加时赛 |
| P | 点球进行中 |
| FT | 比赛结束 |
| AET | 加时赛后比赛结束 |
| PEN | 点球大战后比赛结束 |
| BT | 加时赛中场休息时间 |
| SUSP | 比赛暂停 |
| INT | 比赛中断 |
| PST | 比赛推迟 |
| CANC | 比赛取消 |
| ABD | 比赛弃权 |
| AWD | 技术性失利 |
| WO | 一方弃权获胜 |
| LIVE | 进行中 * |
使用场景
获取某支球队的比赛信息
可以使用 team 和 season 参数结合 fixtures 端点，获取特定球队在某一赛季的所有比赛信息。点击“运行”按钮以获取比赛数据。
1import requests 2import json 3 4URL = ('https://v3.football.api-sports.io/fixtures?' 5 'team=33&' # 33 是曼联的球队 ID 6 'season=2019' 7 ) 8 9header = { 10 'x-rapidapi-host': "v3.football.api-sports.io", 11 'x-rapidapi-key': "{{API_key}}" 12} 13 14response = requests.request("GET", URL, headers=header).json() 15print(json.dumps(response, indent=4))
我们将获得该赛季中指定球队的所有比赛信息。通过修改第 5 行中的球队 ID，可获取其他球队的比赛数据。
球队 ID 可通过 teams 端点获取，具体方法参见 球队信息 课程。
获取实时进行的比赛列表
要获取正在进行的比赛列表，使用 live 参数，并将其值设为 all。下方组件展示了该端点的使用方式。点击“运行”按钮以调用此接口。
1import requests 2import json 3 4URL = ('https://v3.football.api-sports.io/fixtures?' 5 'live=all' 6 ) 7 8header = { 9 'x-rapidapi-host': "v3.football.api-sports.io", 10 'x-rapidapi-key': "{{API_key}}" 11} 12 13response = requests.request("GET", URL, headers=header).json() 14print(json.dumps(response, indent=4))
获取某个联赛的比赛信息
可以通过 league 参数结合 fixtures 端点获取某个联赛的比赛信息，同时必须提供 season 参数。点击“运行”按钮以获取联赛比赛数据。
1import requests 2import json 3 4URL = ('https://v3.football.api-sports.io/fixtures?' 5 'league=61&' # 61 是法国甲级联赛的联赛 ID 6 'season=2019' 7 ) 8 9header = { 10 'x-rapidapi-host': "v3.football.api-sports.io", 11 'x-rapidapi-key': "{{API_key}}" 12} 13 14response = requests.request("GET", URL, headers=header).json() 15print(json.dumps(response, indent=4))
通过修改第 5 行的联赛 ID，可获取其他联赛的比赛信息。
联赛 ID 可通过 leagues 端点获取，具体方法参见 后端接口 课程。