---
title: "分页"
description: "本指南介绍在查询 Fystack API 时如何处理分页响应"
url: https://docs.fystack.io/zh/pagination
last_updated: 2026-11-13
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.fystack.io/llms.txt
> Use it to discover all available pages before exploring further.

# 分页

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

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

## 使用 offset 分页的示例

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

- `offset` (integer): 在开始收集结果集之前要跳过的条目数。
- `limit` (integer): 限制每页返回的条目数。最大值为 1000。

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

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