HTTP Request 节点中的分页

HTTP Request 节点支持分页。本页提供一些配置示例，包括使用 HTTP 节点变量。

该节点的更多信息请参阅 HTTP Request。

信息

API 差异

不同 API 的分页实现方式不同。请查看所用 API 的文档，确认以下信息：

启用分页

在 HTTP Request 节点中，选择 Add Option（添加选项） > Pagination（分页）。

如果 API 在响应中返回下一页 URL：

将 Pagination Mode（分页模式） 设为 Response Contains Next URL（响应包含下一页 URL）。n8n 会显示对应参数。
在 Next URL（下一页 URL） 中，使用表达式¹设置 URL。具体表达式取决于 API 返回的数据。例如，API 在响应体中提供名为 next-page 的参数：
```
{{ $response.body["next-page"] }}
```

如果所用 API 支持通过页码指定某一页：

将 Pagination Mode（分页模式） 设为 Update a Parameter in Each Request（每次请求更新一个参数）。
将 Type（类型） 设为 Query（查询）。
输入查询参数的 Name（名称）。名称取决于 API，通常可在其文档中找到。例如，部分 API 使用名为 page 的查询参数设置页码，此时 Name 应为 page。
将鼠标悬停在 Value（值） 上，开启 Expression（表达式）。
输入 {{ $pageCount + 1 }}。

$pageCount 表示 HTTP Request 节点已获取的页数，从零开始。多数 API 分页从一开始，即第一页为 1。因此，将 +1 加到 $pageCount 上，节点就会在第一次循环获取第一页，第二次获取第二页，依此类推。

如果所用 API 允许通过请求体参数分页：

将 HTTP 请求方法设为 POST。
将 Pagination Mode（分页模式） 设为 Update a Parameter in Each Request（每次请求更新一个参数）。
在 Type（类型） 参数中选择 Body（请求体）。
输入请求体参数的 Name（名称）。具体取决于 API，page 是常见键名。
将鼠标悬停在 Value（值） 上，开启 Expression（表达式）。
输入 {{ $pageCount + 1 }}。

如果所用 API 支持通过查询参数选择每页大小：

在节点主参数中选择 Send Query Parameters（发送查询参数）。这是首次打开节点时看到的参数，而非选项内部的设置。
输入查询参数的 Name（名称）。具体取决于 API。例如，许多 API 使用名为 limit 的参数设置每页大小，此时 Name 应为 limit。
在 Value（值） 中输入每页大小。