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

​
请求结构

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

​
响应结构

分页查询返回一个包含条目和分页元数据的连接对象——例如 TransactionConnection：
  • 条目列表（例如 transactions）
  • totalCount — 符合筛选条件的条目总数
  • hasNextPage — 是否还有更多结果
其他连接类型遵循相同模式：UserCashBalanceConnection, DeclinedTransactionConnection, 以及 PlaidBankTransactionPage。

​
遍历完整结果集

当 hasNextPage 为 true 时，将 offset 按 limit 递增：
  1. 请求 { limit: 20, offset: 0 }。
  2. 如果 hasNextPage 为 true，请求 { limit: 20, offset: 20 }，然后是 40，以此类推。
  3. 当 hasNextPage 为 false 时停止。
如果在分页过程中创建了新记录，结果可能会在页面之间发生移动——交易列表按最新优先排序。对于大型导出，请按固定日期范围进行筛选，以便在遍历时保持基础集合稳定。