导入
球员信息
学习如何使用 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 | 对象 | 包含所查询球员相关统计数据的对象。 |