跳至内容

HTTP请求节点中的分页功能#

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

有关该节点的更多信息,请参阅HTTP Request

API差异

不同的API以不同的方式实现分页功能。请查阅您所使用的API文档以获取详细信息。您需要了解的内容包括:

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

启用分页#

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

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

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

  1. 分页模式设置为响应包含下一个URL。n8n会显示此选项的参数。
  2. Next URL中,使用表达式来设置URL。具体表达式取决于API返回的数据。例如,如果API在响应体中包含一个名为next-page的参数:
    1
    {{ $response.body["next-page"] }}
    

使用$pageCount按页码获取下一页#

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

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

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

如果您使用的API允许通过请求体参数进行分页:

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

在查询中设置页面大小#

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

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