Skip to content

HTTP 请求节点中的分页#

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

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

API 差异

不同的 API 以不同的方式实现分页。请查看您正在使用的 API 的 API 文档以获取详细信息。您需要了解以下内容：

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

启用分页#

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

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

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

  1. 将分页模式设置为响应包含下一个 URL。n8n 显示此选项的参数。
  2. 在下一个 URL 中，使用表达式设置 URL。确切的表达式取决于您的 API 返回的数据。例如，如果 API 在响应主体中包含名为 next-page 的参数： 
    1
    {{ $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. 在值中，输入您的页面大小。