Paginazione
Gli elenchi usano la paginazione a cursore: è stabile anche quando arrivano nuovi tocchi mentre stai leggendo.
Parametri
limit: elementi per pagina, da 1 a 100 (predefinito 20).cursor: il valore next_cursor della pagina precedente. Trattalo come una stringa opaca.
curl "https://api.taplogic.it/v1/scans?limit=100" \
-H "Authorization: Bearer $TAPLOGIC_API_KEY"Risposta
has_more dice se ci sono altre pagine. next_cursor è null sull'ultima pagina. Gli elementi sono in ordine dal più recente.
{
"object": "list",
"data": [ { "id": "cm3scn0042", "object": "scan" } ],
"has_more": true,
"next_cursor": "WyIyMDI2LTExLTE4VDA5OjIwOjAwLjAwMFoiLCJjbTNzY24wMDQyIl0"
}Leggere tutto
async function* tuttiITocchi(filtri = {}) {
let cursore;
do {
const query = new URLSearchParams({ ...filtri, limit: "100", ...(cursore ? { cursor: cursore } : {}) });
const risposta = await fetch(`https://api.taplogic.it/v1/scans?${query}`, {
headers: { Authorization: `Bearer ${process.env.TAPLOGIC_API_KEY}` },
});
const pagina = await risposta.json();
if (!risposta.ok) throw new Error(pagina.error.code);
yield* pagina.data;
cursore = pagina.next_cursor;
} while (cursore);
}
for await (const tocco of tuttiITocchi({ from: "2026-11-01T00:00:00Z" })) {
console.log(tocco.id);
}Un cursore resta valido finché non cambi i filtri. Con filtri diversi riparti senza cursore.