分页

本指南介绍在查询 Fystack API 时如何处理分页响应。默认情况下，列表响应最多返回 20 条结果。你可以通过添加 limit 参数请求最多 1000 条。如果你使用的是 Fystack 官方 API 客户端库，则无需关心分页，库会在后台自动处理。

只要 API 响应返回的是对象列表，无论数量多少，都支持分页。在分页响应中，对象嵌套在 data 属性中。你可以使用 offset 和 limit 查询参数来浏览各页。

使用 offset 分页的示例

在本示例中，我们请求网络列表的第一页，每页限制 10 条。你可以通过调整 offset 值在各页之间切换。例如，当 limit 为 10 时，要获取第二页，应使用 offset=10。

  • Name
    offset
    Type
    integer
    Description

    在开始收集结果集之前要跳过的条目数。

  • Name
    limit
    Type
    integer
    Description

    限制每页返回的条目数。最大值为 1000。

Pagination using cURL

curl -G https://api.fystack.io/api/v1/networks \
  -d offset=0 \
  -d limit=10

Paginated response

{
  "data": [
    {
      "id": "WAz8eIbvDR60rouK",
      // ...
    },
    {
      "id": "hSIhXBhNe8X1d8Et"
      // ...
    },
    {
      "id": "fbwYwpi9C2ybt6Yb"
      // ...
    }
    // ... 7 more items
  ]
}