페이지네이션

목록 엔드포인트는 페이지 기반입니다. 감사 내보내기는 커서 기반이므로 순서를 잃지 않고 긴 내보내기를 재개할 수 있습니다.

페이지 기반 목록

page(1부터 시작)와 page_size 쿼리 매개변수를 전달합니다. 응답에는 pagination 객체가 포함됩니다:

{
  "data": [{ "id": "item_1" }],
  "pagination": { "page": 1, "pageSize": 20, "total": 57, "totalPages": 3 }
}

page >= totalPages가 될 때까지 반복합니다:

let page = 1;
let totalPages = 1;
do {
  const result = await fabhub.listItems({ page, pageSize: 100 });
  // handle result.data
  totalPages = result.pagination.totalPages;
  page += 1;
} while (page <= totalPages);

경계가 있는 page_size를 사용하고(API가 이를 제한함) 모든 페이지를 스캔하기보다 search 필터를 선호하세요.

커서 기반 내보내기(감사 이벤트)

GET /v1/audit/events는 페이지 카운트 대신 커서를 반환합니다:

{
  "data": [{ "id": "evt_1" }],
  "pagination": { "hasMore": true, "nextCursor": { "createdAt": "2026-06-19T14:02:00Z", "id": "evt_1" } }
}

커서를 cursor_created_at 및 cursor_id로 다시 전달하여 재개합니다(SDK에서는 listAuditEvents):

let cursor = undefined;
do {
  const page = await fabhub.listAuditEvents({
    limit: 200,
    cursorCreatedAt: cursor?.createdAt,
    cursorId: cursor?.id,
  });
  // handle page.data
  cursor = page.pagination.nextCursor ?? undefined;
} while (cursor);