全部教程

原创专题

n8n HTTP 分页：按 API 契约检查下一页与停止条件

先读接口分页规则，再选参数更新或下一页 URL；核对页数、重复数据与终止状态。

AI Nav City撰写 / 更新 资料核验

为 AI 工作流取资料时，首个 HTTP 响应可能只是第一页。本文目标是写清一个合成两页接口的分页契约与验收表。前提是拥有接口访问许可、了解分页文档，并能编辑 HTTP Request；没有请求真实接口、读取凭据或运行节点。

操作与验收顺序

  1. 阅读分页契约

    找出下一页定位方式与结束标记。[1]

  2. 选择分页模式

    按参数更新或响应下一页 URL 配置。[1]

  3. 检查完整性

    核对记录 ID、页数、重复和结束标记。[1]

分步检查输入、操作和结果；执行范围见末节。

从接口说明开始

原创样例第一页含 demo-1、demo-2 和 next 字段，第二页含 demo-3 且 next 为空。预期完整集合含三个不同 ID。先确认服务使用页码、游标还是下一页 URL，以及每页大小和终止条件；不要把 $pageCount 当成所有接口都能直接接受的参数。样例中的 next 命名只是练习契约。[1]

两种模式分别适用什么

HTTP Request 的 Pagination Mode 有 Off、Update a Parameter in Each Request 和 Response Contains Next URL。前者动态更新各次请求的参数；后者用表达式设置 Next URL。根据官方接口响应结构配置表达式，先确认下一页字段确实存在；如果接口给的是游标而非 URL，应按其参数契约处理。[1]

查看每页的请求与响应

官方分页变量包括 $pageCount、$request 和 $response；$response 可访问 body、headers、statusCode。用它们核对接口返回的下一页位置，记录已取页数和 ID 集合。分页和对多条输入的 Batching 是不同配置，不能设置了 Items per Batch 就推断已遍历服务端所有页面。[1]

停止条件和验收范围

下一页重复、ID 重复、认证失败或无法判断终止时，暂停继续请求并检查接口契约；采用时还应设符合接口限额的请求边界。本文离线核对了两页合成记录的去重集合与空 next 标记，没有运行 n8n、调用接口或验证限流行为。真实分页完成仍要用实际请求与响应验收。[1]

本文来源

本站原创整理；官方说明与编辑建议分别标注。

  1. n8n · 核验来源
    查看资料

文中工具

工具目录

n8n

通过节点和工作流连接外部服务、处理数据并加入 AI 步骤，用于业务流程自动化。