Paginazione

Gli endpoint di elenco sono basati su pagine. L'esportazione di audit è basata su cursore, così puoi riprendere un'esportazione lunga senza perdere l'ordinamento.

Elenchi basati su pagine

Passa i parametri di query page (con base 1) e page_size. Le risposte includono un oggetto pagination:

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

Itera fino a 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);

Usa un page_size limitato (l'API lo limita) e preferisci i filtri search rispetto alla scansione di ogni pagina.

Esportazione basata su cursore (eventi di audit)

GET /v1/audit/events restituisce un cursore invece dei conteggi di pagina:

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

Riprendi passando di nuovo il cursore come cursor_created_at e cursor_id (con l'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);