请求与响应结构

请求结构

Api-Football 接口的请求包含一个请求头和一个接口地址。

请求头结构

请求头包含两个元素：

• x-rapidapi-host 为 v3.football.api-sports.io 或 api-football-v1.p.rapidapi.com，具体取决于您注册时选择的平台。在本例中，由于我们通过 Api-Football 官网注册，因此使用 v3.football.api-sports.io。
• x-rapidapi-key 为用户的 API 密钥。

接口地址结构

接口地址由基础 URI 和查询参数组成，具体取决于用户访问的接口类型。

响应结构

响应包含一个响应头和一个 JSON 格式的响应对象。

响应头结构

响应头包含四个元素：

• x-ratelimit-requests-limit 告知用户根据订阅计划每天分配的请求数量。

• x-ratelimit-requests-remaining 提供用户当前剩余的每日请求数量。

• x-ratelimit-limit 包含每分钟允许的最大 API 调用次数。

• x-ratelimit-remaining 告知用户在达到每分钟调用上限前还剩余多少次 API 调用。

JSON 响应内容

响应中的 JSON 数据提供了调用该接口所需的具体信息，不同接口返回的信息各不相同。我们在之前的课程中已详细分析了各个接口的响应参数。

用户可能会收到错误信息，格式如下：

1"errors": {
2    "token": "Error/Missing application key. Go to https://www.api-football.com/documentation-v3 to learn how to get your API application key."
3}

注意： 使用免费订阅时，每天允许 100 次请求。超过此限制后，系统将返回请求次数超限的错误信息。