团队信息

到目前为止讨论的 API 端点仅提供与平台相关的信息，对前端没有实际用途。在接下来的课程中，我们将介绍一些可以用于前端的实际信息端点。

teams 端点 提供可用球队的列表。该端点的基础 URI 为 https://v3.football.api-sports.io/teams。

查询参数

我们可以使用以下查询参数来调用此端点：

使用此端点时，必须至少指定一个参数。如果不带任何查询参数调用该端点，将返回错误。

使用场景

通过球队名称获取球队信息

下方代码示例展示了如何使用 GET 请求通过球队名称获取球队信息。我们在 第 5 行 使用 name 作为查询参数。点击“运行”按钮即可获取球队信息。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/teams?'
5       'name=manchester united'
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))

该端点返回球队的名称、场馆容量、图片链接、场地类型、地址以及场馆 ID。同时提供球队名称、所属国家名称、标识该球队是国家队还是俱乐部的标志、成立年份、队徽以及球队 ID。只需修改 第 5 行 的球队名称，即可获取其他球队的信息。

获取某联赛某一赛季的所有球队信息

我们可以通过 league 和 season 参数获取某个联赛在特定赛季的所有球队信息。点击“运行”按钮发起 GET 请求，查看球队详情。

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/teams?'
5       'league=39&'  # 39 是英格兰超级联赛的联赛 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 和 第 6 行 的年份，即可获取其他联赛和年份的数据。

注意：联赛 ID 可通过「后端端点」一课中介绍的方法获取。

搜索球队

1import requests
2import json
3
4URL = ('https://v3.football.api-sports.io/teams?'
5       'search=evert'
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))

返回的信息与前两种情况一致。只需将 第 5 行 的 evert 替换为其他球队名称的首字母缩写，即可获取其他球队的信息。同样，也可以通过将 evert 替换为国家名称的首字母缩写，来搜索某个国家的所有球队。