Logo
Section 1 / 4

球员信息

学习如何使用 Api-Football 获取球员的详细信息。

导入

球员信息

学习如何使用 Api-Football 获取球员的详细信息。

我们喜欢了解自己最喜爱球员的每一个细节。无论这些信息是关于他的个人资料还是统计数据,我们都希望全面掌握。Api-Football 可以帮助我们收集这些信息。

获取球员信息

Players 端点返回拥有完整个人资料和统计数据的球员信息。

注意: 由于球员转会,同一赛季中可能在两支球队都有统计数据。

该端点使用分页系统;我们可以使用 page 参数在不同页面之间切换。

参数类型分类描述
id整数必需我们想要查询的球员 ID。可通过 Players 端点获取球员 ID。
team整数可选我们希望获取其信息的球队 ID。可通过 Teams 端点获取球队 ID。
league整数可选我们希望获取其信息的联赛 ID。可通过 Leagues 端点获取该 ID。
season整数可选我们希望查看信息的年份,格式为 "YYYY"。此参数需要与 id、league 或 team 之一同时使用。
search字符串可选我们希望查询的球员姓名首字母。至少需要四个字符。必须与 league 或 team 参数一起使用。
page整数可选我们希望查看的页码。默认值为 1。

我们可以使用 team 和 search 参数来查询特定球员的信息。下方的代码组件展示了如何搜索球员。点击“运行”按钮即可获取球员信息。

1const endpointUrl = new URL('https://v3.football.api-sports.io/players'); 2 3const queryParameters = new URLSearchParams({ 4 search: 'cavani', 5 team: '85' // 85 是巴黎圣日耳曼队的球队 ID 6}); 7 8headerParameters = { 9 'x-rapidapi-host': 'v3.football.api-sports.io', 10 'x-rapidapi-key': '{{API_KEY}}' 11} 12 13const options = { 14 method: 'GET', 15 headers: headerParameters 16}; 17 18async function searchPlayer() { 19 try { 20 endpointUrl.search = queryParameters; 21 const response = await fetch(endpointUrl, options); 22 printResponse(response); 23 } 24 catch (error) { 25 printError(error); 26 } 27} 28 29searchPlayer();

我们也可以使用 id 和 season 参数来获取某位球员在单个赛季中的详细信息。下方代码已修改为查询特定球员在单个赛季的信息。点击“运行”按钮即可获取该球员的数据。

1const date = new Date(); 2const endpointUrl = new URL('https://v3.football.api-sports.io/players'); 3 4const queryParameters = new URLSearchParams({ 5 id: '19088', // 19088 是迪恩·亨德森的球员 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 fetchPlayerInfo() { 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 30fetchPlayerInfo();

让我们看看代码的修改之处:

  • 第 4 至 7 行: 修改了查询参数。我们可以在第 5 行更改球员 ID,以获取其他球员的信息。
  • 第 19 行: 将函数名更改为 fetchPlayerInfo()。

同样地,我们可以使用 team 和 season 参数来获取某支球队在单个赛季中的球员信息。下方代码已相应调整。点击“运行”按钮即可获取球员数据。

1const date = new Date; 2const endpointUrl = new URL('https://v3.football.api-sports.io/players'); 3 4const queryParameters = new URLSearchParams({ 5 team: '85', // 85 是巴黎圣日耳曼队的球队 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 fetchPlayerInfo() { 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 30fetchPlayerInfo();

我们在 第 4 至 7 行 修改了查询参数以获取所需信息。通过更改第 6 行的年份,还可以获取其他赛季的数据。

响应字段类型描述
player对象包含所查询球员信息的对象。
statistics对象包含所查询球员相关统计数据的对象。

赛程(Fixtures)

球队阵容