Paginação

Os endpoints de listagem são baseados em páginas. A exportação de auditoria é baseada em cursor, para que possa retomar uma exportação longa sem perder a ordenação.

Listas baseadas em páginas

Passe os parâmetros de consulta page (começando em 1) e page_size. As respostas incluem um objeto pagination:

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

Itere até 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);

Use um page_size limitado (a API impõe um teto) e prefira filtros search em vez de percorrer todas as páginas.

Exportação baseada em cursor (eventos de auditoria)

GET /v1/audit/events devolve um cursor em vez de contagens de páginas:

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

Retome passando o cursor de volta como cursor_created_at e cursor_id (com o 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);