33、API 分页机制：原理、实现与优化策略

API 分页机制：原理、实现与优化策略

1. 分页模式概述

在处理大量数据时，分页是一种常见且有效的策略。我们的分页模式依赖于游标（cursor）的概念，使用不透明的页面令牌（page tokens）来大致表示页码。由于页面令牌的不透明性，API 在响应中不仅要返回结果块，还要返回下一个令牌，这一点非常重要。对于大型单一资源，同样的分页模式也可应用于每个资源，通过多页数据逐步构建资源内容。

为了实现“从上次中断处继续”的功能，有效查看可用数据的特定“窗口”，我们依赖三个不同的字段来传达意图：
- pageToken ：表示一个不透明的标识符，仅对 API 服务器有意义，用于指示如何继续之前开始的结果迭代。
- maxPageSize ：允许消费者指定在给定响应中希望返回的最大结果数量。
- nextPageToken ：API 服务器使用该字段告知消费者如何通过额外请求获取更多结果。

以下是将此模式转换为 API 定义的示例：

abstract class ChatRoomApi {
  @get("/chatRooms")
  ListChatRooms(req: ListChatRoomsRequest): ListChatRoomsResponse;
}

interface ListChatRoomsRequest {
  pageToken: string;  // #A
  maxPageSize: number;  // #A
}

interface Lis