请求与响应结构

请求结构

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 和查询参数组成，具体取决于用户访问的接口类型。我们将在后续课程中详细讲解这些基础 URI 及其对应的查询参数。

响应结构

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

响应头结构

响应头包含四个元素：

• x-ratelimit-requests-limit 告知用户根据当前订阅套餐每日分配的请求数量。
• x-ratelimit-requests-remaining 提供当前订阅下剩余的每日请求数量。
• X-RateLimit-Limit 表示每分钟允许的最大 API 调用次数。
• X-RateLimit-Remaining 告知用户在达到每分钟调用限制前还剩余多少次调用机会。

JSON 响应内容

响应中的 JSON 数据部分提供用户所请求接口所需的具体信息，不同接口返回的信息各不相同。我们将在后续课程中逐一分析每个接口的响应参数。

用户可能在响应中收到错误信息，格式如下：

1
2{
3    "api": {
4        "results": 0,
5        "error": "错误信息文本"
6    }
7}

使用免费订阅时，每天允许 100 次请求。超过此数量后，系统将返回上述错误信息。