跳到主要内容

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

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

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

API 差异说明

不同 API 采用不同的分页实现方式。具体细节请查阅您所用 API 的文档。需要重点关注以下信息：

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

启用分页功能#​

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

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

若 API 在响应中返回下一页 URL：

  1. 将 分页模式 设置为 响应包含下一页 URL，系统将显示该选项的参数配置项
  2. 在 下一页 URL 字段中，使用表达式设置 URL。具体表达式取决于 API 返回的数据结构，例如当 API 在响应体中包含名为 next-page 的参数时：

{{ $response.body["next-page"] }}

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

若您使用的 API 支持通过页码定位特定页面：

  1. 将 分页模式 设置为 每次请求更新参数
  2. 将 类型 设置为 查询
  3. 输入查询参数的 名称。具体名称取决于您使用的 API，通常在其文档中有说明。例如，部分 API 使用名为 page 的查询参数来设置页码，此时 名称 应填写为 page
  4. 悬停于 值 字段并切换开启 表达式 开关
  5. 输入 {{ $pageCount + 1 }}

$pageCount 表示 HTTP 请求节点已获取的页面数量，初始值为零。大多数 API 分页从 1 开始计数（第一页为页码 1）。这意味着对 $pageCount 执行 +1 操作后，节点将在首次循环时获取第一页，第二次循环时获取第二页，依此类推。

通过正文参数实现分页导航#​

若您使用的 API 支持通过正文参数进行分页：

  1. 将 HTTP 请求方法设置为 POST
  2. 将 分页模式 设置为 每次请求更新参数
  3. 在 类型 参数中选择 正文
  4. 输入正文参数的 名称。具体名称取决于您使用的 API，page 是常见的键名
  5. 悬停于 值 字段并切换开启 表达式 开关
  6. 输入 {{ $pageCount + 1 }}

在查询中设置页面大小#​

若您使用的 API 支持在查询中选择页面大小：

  1. 在主节点参数中（首次打开节点时可见的参数，非选项内的设置）选择 发送查询参数
  2. 输入查询参数的 名称。具体名称取决于您使用的 API。例如，许多 API 使用名为 limit 的查询参数来设置页面大小，此时 名称 应填写为 limit
  3. 在 值 字段中输入所需的页面大小