n8n 中文文档

HTTP请求节点中的分页

HTTP 请求节点支持分页。本页提供了一些示例配置,包括使用 HTTP 节点变量。

有关节点的更多信息,请参阅HTTP 请求。

提示

API differences API差异

不同的 API 以不同的方式实现分页。有关详细信息,请查看您正在使用的 API 的 API 文档。您需要找出以下信息:

  • API 是否提供下一页的 URL?
  • API 特定的页面大小或页数限制吗?
  • API返回的数据结构。

启用分页

在 HTTP 请求节点中,选择添加选项 > 分页。

使用响应中的 URL 通过 $response 获取下一页

如果 API 在其响应中返回下一页的 URL:

  1. 将 Pagination Mode 分页模式 设置为 Response Contains Next URL 响应包含下一个 URL。 n8n 显示此选项的参数。
  2. 在Next URL 下一个网址中,使用表达式[^1]设置URL。确切的表达式取决于您的 API 返回的数据。例如,如果 API 在响应正文中包含名为 next-page 的参数: javascript {{ $response.body["next-page"] }}

使用 $pageCount 按编号获取下一页

如果您使用的 API 支持按页码定位特定页面:

  1. 将分页模式设置为在每个请求中更新参数。
  2. 将类型设置为查询。
  3. 输入查询参数的名称。这取决于您的 API,通常在其文档中描述。例如,一些 API 使用名为 page 的查询参数来设置页面。因此名称将是 page。
  4. 将鼠标悬停在值上并切换表达式开启。
  5. 输入 {{ $pageCount + 1 }}

$pageCount 是 HTTP 请求节点已获取的页数。它从零开始。大多数 API 分页从一开始计数(第一页是第一页)。这意味着将 +1 添加到 $pageCount 意味着节点在第一次循环时获取第一页,在第二次循环时获取第二页,依此类推。

通过主体参数导航分页

如果您使用的 API 允许您通过主体参数分页:

  1. 将 HTTP 请求方法设置为 POST
  2. 将分页模式设置为在每个请求中更新参数。
  3. 在类型参数中选择主体。
  4. 输入主体参数的名称。这取决于您使用的 API。page 是常见的键名。
  5. 将鼠标悬停在值上并切换表达式开启。
  6. 输入 {{ $pageCount + 1 }}

设置查询中的页面大小

如果您使用的 API 支持在查询中选择页面大小:

  1. 在主节点参数中选择发送查询参数(这是您首次打开节点时看到的参数,而不是选项中的设置)。
  2. 输入查询参数的名称。这取决于您的 API。例如,许多 API 使用名为 limit 的查询参数来设置页面大小。因此名称将是 limit。
  3. 在值中,输入您的页面大小。

[^1]:在 n8n 中,表达式允许您通过执行 JavaScript 代码动态填充节点参数。您可以使用 n8n 表达式语法,使用来自先前节点、其他工作流程或 n8n 环境的数据来定义值,而不是提供静态值。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。