API pubblica

Scorrere i risultati e restare nei limiti

Gli endpoint di elenco paginano per cursore e non per offset, quindi segui il cursore che la risposta ti dà invece di calcolarne uno. Guarda gli header di rate limit e usa updatedSince per interrogare invece di rileggere tutto.

Verificato il 20 agosto 2026

Passaggi

1. Segui il cursore di ogni risposta finché non ne torna più nessuno. Non costruire cursori da solo.
2. Tieni una dimensione di pagina ragionevole — pagine più grandi significano meno richieste, ma più lente.
3. Interroga con updatedSince invece di percorrere l’intera collezione a intervalli.
4. Leggi gli header di rate limit e rallenta prima di essere rifiutato, non dopo.
5. Conserva il requestId di tutto ciò che fallisce, per l’assistenza.

Come verificare il risultato

Una scorsa completa restituisce ogni oggetto una volta sola, e un’interrogazione ripetuta legge solo ciò che è cambiato.

Che cosa va storto di solito

• Costruire pagine per offset, che scivolano quando i dati cambiano sotto.
• Rileggere tutto ogni minuto e sbattere contro il limite.
• Riusare un cursore scaduto e ottenere un errore di cursore non valido.