HTTP请求节点中的分页
HTTP 请求节点支持分页。本页提供了一些示例配置,包括使用 HTTP 节点变量。
有关节点的更多信息,请参阅HTTP 请求。
提示
API differences API差异
不同的 API 以不同的方式实现分页。有关详细信息,请查看您正在使用的 API 的 API 文档。您需要找出以下信息:
- API 是否提供下一页的 URL?
- API 特定的页面大小或页数限制吗?
- API返回的数据结构。
启用分页
在 HTTP 请求节点中,选择添加选项 > 分页。
使用响应中的 URL 通过 $response 获取下一页
如果 API 在其响应中返回下一页的 URL:
- 将 Pagination Mode 分页模式 设置为 Response Contains Next URL 响应包含下一个 URL。 n8n 显示此选项的参数。
- 在Next URL 下一个网址中,使用表达式[^1]设置URL。确切的表达式取决于您的 API 返回的数据。例如,如果 API 在响应正文中包含名为
next-page的参数:javascript {{ $response.body["next-page"] }}
使用 $pageCount 按编号获取下一页
如果您使用的 API 支持按页码定位特定页面:
- 将分页模式设置为在每个请求中更新参数。
- 将类型设置为查询。
- 输入查询参数的名称。这取决于您的 API,通常在其文档中描述。例如,一些 API 使用名为
page的查询参数来设置页面。因此名称将是page。 - 将鼠标悬停在值上并切换表达式开启。
- 输入
{{ $pageCount + 1 }}
$pageCount 是 HTTP 请求节点已获取的页数。它从零开始。大多数 API 分页从一开始计数(第一页是第一页)。这意味着将 +1 添加到 $pageCount 意味着节点在第一次循环时获取第一页,在第二次循环时获取第二页,依此类推。
通过主体参数导航分页
如果您使用的 API 允许您通过主体参数分页:
- 将 HTTP 请求方法设置为 POST
- 将分页模式设置为在每个请求中更新参数。
- 在类型参数中选择主体。
- 输入主体参数的名称。这取决于您使用的 API。
page是常见的键名。 - 将鼠标悬停在值上并切换表达式开启。
- 输入
{{ $pageCount + 1 }}
设置查询中的页面大小
如果您使用的 API 支持在查询中选择页面大小:
- 在主节点参数中选择发送查询参数(这是您首次打开节点时看到的参数,而不是选项中的设置)。
- 输入查询参数的名称。这取决于您的 API。例如,许多 API 使用名为
limit的查询参数来设置页面大小。因此名称将是limit。 - 在值中,输入您的页面大小。
[^1]:在 n8n 中,表达式允许您通过执行 JavaScript 代码动态填充节点参数。您可以使用 n8n 表达式语法,使用来自先前节点、其他工作流程或 n8n 环境的数据来定义值,而不是提供静态值。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。