团队信息

获取球队信息

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

请求参数

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

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

下方小工具中的代码展示了如何使用 GET 请求，通过球队名称获取球队信息。点击“运行”按钮即可获取球队信息。

1const endpointUrl = new URL('https://v3.football.api-sports.io/teams');
2
3const queryParameters = new URLSearchParams({
4  name: 'manchester united'
5});
6
7headerParameters = {
8  'x-rapidapi-host': 'v3.football.api-sports.io',
9  'x-rapidapi-key': '{{API_KEY}}'
10};
11
12const options = {
13  method: 'GET',
14  headers: headerParameters
15};
16
17async function fetchTeamInfo() {
18  try {
19    endpointUrl.search = queryParameters;
20    const response = await fetch(endpointUrl, options);
21    printResponse(response);
22  } 
23  catch (error) {
24    printError(error);
25  }
26}
27
28fetchTeamInfo();

通过此端点，我们还可以使用 league 和 season 参数获取某个联赛中所有球队的信息。下面的代码展示了如何使用这两个参数。点击“运行”按钮，发起 GET 请求并查看球队信息。

注意： 不能单独使用 league 参数，必须同时提供 season 参数。

1const date = new Date();
2const endpointUrl = new URL('https://v3.football.api-sports.io/teams');
3
4const queryParameters = new URLSearchParams({
5  league: '39', // 39 是英格兰超级联赛的联赛 ID
6  season: date.getFullYear() // 当前年份
7});
8
9headerParameters = {
10  'x-rapidapi-host': 'v3.football.api-sports.io',
11  'x-rapidapi-key': '{{API_KEY}}'
12};
13
14const options = {
15  method: 'GET',
16  headers: headerParameters
17};
18
19async function fetchLeagueTeams() {
20  try {
21    endpointUrl.search = queryParameters;
22    const response = await fetch(endpointUrl, options);
23    printResponse(response);
24  } 
25  catch (error) {
26    printError(error);
27  }
28}
29
30fetchLeagueTeams();

注意： 我们可以通过“联赛”端点获取联赛 ID，具体方法请参见附录中的【支持端点】课程。

1const endpointUrl = new URL('https://v3.football.api-sports.io/teams');
2
3const queryParameters = new URLSearchParams({
4  search: 'evert'
5});
6
7headerParameters = {
8  'x-rapidapi-host': 'v3.football.api-sports.io',
9  'x-rapidapi-key': '{{API_KEY}}'
10};
11
12const options = {
13  method: 'GET',
14  headers: headerParameters
15};
16
17async function searchTeam() {
18  try {
19    endpointUrl.search = queryParameters;
20    const response = await fetch(endpointUrl, options);
21    printResponse(response);
22  } 
23  catch (error) {
24    printError(error);
25  }
26}
27
28searchTeam();