> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 分页

> 偏移量分页、页面大小上限，以及连接式响应结构。

整个 API 的列表操作使用偏移量输入进行分页，并返回连接风格的对象。根据界面不同，存在两种页面大小规则。

## 请求结构

在操作的 `paginate` 参数中传入偏移量输入：

| 输入                                                                  | 被用于                                               | `limit` 最大值      | 字段                |
| ------------------------------------------------------------------- | ------------------------------------------------- | ---------------- | ----------------- |
| [`OffsetInput`](/api-reference/types/offset-input)                  | 标准列表（`getTransactions`, `getUserCashBalances`, …） | **20**           | `limit`, `offset` |
| [`BulkPaginationInput`](/api-reference/types/bulk-pagination-input) | 批量 API 列表                                         | **100**（同时也是默认值） | `limit`, `offset` |

```graphql theme={null}
query {
  getTransactions(
    filter: { }
    paginate: { limit: 20, offset: 0 }
  ) {
    transactions { transactionId amount createdAt }
    totalCount
    hasNextPage
  }
}
```

## 响应结构

分页查询返回一个包含条目和分页元数据的连接对象——例如 [`TransactionConnection`](/api-reference/types/transaction-connection)：

* 条目列表（例如 `transactions`）
* `totalCount` — 符合筛选条件的条目总数
* `hasNextPage` — 是否还有更多结果

其他连接类型遵循相同模式：[`UserCashBalanceConnection`](/api-reference/types/user-cash-balance-connection), [`DeclinedTransactionConnection`](/api-reference/types/declined-transaction-connection), 以及 [`PlaidBankTransactionPage`](/api-reference/types/plaid-bank-transaction-page)。

## 遍历完整结果集

当 `hasNextPage` 为 `true` 时，将 `offset` 按 `limit` 递增：

1. 请求 `{ limit: 20, offset: 0 }`。
2. 如果 `hasNextPage` 为 `true`，请求 `{ limit: 20, offset: 20 }`，然后是 `40`，以此类推。
3. 当 `hasNextPage` 为 `false` 时停止。

<Note>
  如果在分页过程中创建了新记录，结果可能会在页面之间发生移动——交易列表按最新优先排序。对于大型导出，请按固定日期范围进行筛选，以便在遍历时保持基础集合稳定。
</Note>