HTTP请求节点中的分页功能#
HTTP请求节点支持分页功能。本页提供了一些示例配置,包括使用HTTP节点变量。
有关该节点的更多信息,请参阅HTTP Request。
API差异
不同的API以不同的方式实现分页功能。请查阅您所使用的API文档以获取详细信息。您需要了解的内容包括:
- API是否提供了下一页的URL?
- API是否有特定的页面大小或页码限制?
- API返回的数据结构。
启用分页#
在HTTP请求节点中,选择添加选项 > 分页。
使用响应中的URL通过$response获取下一页#
如果API在其响应中返回下一页的URL:
- 将分页模式设置为响应包含下一个URL。n8n会显示此选项的参数。
- 在Next URL中,使用表达式来设置URL。具体表达式取决于API返回的数据。例如,如果API在响应体中包含一个名为
next-page的参数:1{{ $response.body["next-page"] }}
使用$pageCount按页码获取下一页#
如果您使用的API支持按编号定位特定页面:
- 将分页模式设置为在每个请求中更新参数。
- 将类型设置为查询。
- 输入查询参数的名称。这取决于您的API,通常在其文档中有描述。例如,某些API使用名为
page的查询参数来设置页码。因此名称应为page。 - 悬停在Value上并切换Expression为开启状态。
- 输入
{{ $pageCount + 1 }}
$pageCount 表示HTTP请求节点已获取的页数,初始值为零。大多数API分页从1开始计数(第一页为第1页)。这意味着在$pageCount上添加+1后,节点将在第一次循环时获取第1页,第二次循环时获取第2页,依此类推。
通过请求体参数实现分页导航#
如果您使用的API允许通过请求体参数进行分页:
- 将HTTP请求方法设置为POST
- 将分页模式设置为在每次请求中更新参数。
- 在Type参数中选择Body。
- 输入正文参数的名称。这取决于您使用的API。
page是一个常见的键名。 - 悬停在值上并切换表达式为开启状态。
- 输入
{{ $pageCount + 1 }}
在查询中设置页面大小#
如果您使用的API支持在查询中选择页面大小:
- 在主节点参数中选择发送查询参数(这是您首次打开节点时看到的参数,而非选项内的设置)。
- 输入查询参数的名称。这取决于您的API。例如,许多API使用名为
limit的查询参数来设置页面大小。因此名称应为limit。 - 在Value中,输入您的页面大小。