Leggere ogni pagina, rispettare i limiti di frequenza e ripristinare in modo sicuro la connessione in caso di errori.
Limiti di frequenza
I limiti sono configurabili. GET e /v1/operations/capabilities segnalano requestsPerMinute e authenticationRequestsPerMinutePerIp. Dopo un errore 429, rispettare l'opzione "Riprova dopo" e attendere più a lungo se la limitazione della frequenza persiste. Le letture batch accettano fino a 100 ID; i singoli endpoint possono avere limiti di pagina o di payload inferiori. (Retry-After)
Leggi ogni pagina
Utilizza la regola di continuazione per l'endpoint chiamato, mantenendo gli stessi filtri. Gli elenchi possono cambiare durante la lettura; utilizza gli snapshot quando hai bisogno di una copia coerente.
Paginazione Continua con Interrompi quando Cursore Passa next come after. Il successivo è null. Offset con nextOffset Passa nextOffset come offset. nextOffset è null. Offset con hasMore Aumenta l'offset del numero di elementi restituiti. hasMore è falso. Software Passa il valore numerico di next come after; riavvia se updatedAtUtc cambia. Il successivo è null. Feed eventi Passa next come after. hasMore è falso. Gestione errori
Leggi il codice di errore e lo stato HTTP. Se la risposta include requestId, citalo quando contatti l'assistenza.
Stato HTTP Cosa fare 400 Correggere la richiesta. 401 Verificare le credenziali o ottenere un nuovo token di accesso. 403 Verificare l'ambito, le autorizzazioni e se l'accesso è abilitato. 404 La risorsa potrebbe essere mancante o al di fuori del tuo ambito. 409 Leggi il codice di errore e lo stato corrente prima di decidere. 410 Lo snapshot o il cursore dell'evento sono scaduti. Avvia una nuova baseline. Se una scrittura va in timeout
Un timeout o un errore 503 non dimostra che l'azione non è riuscita. Per le scritture che restituiscono ricevute di operazione, consulta GET e /v1/operations/by-key?idempotencyKey={key} prima di riprovare. Per la creazione di manutenzione, riutilizza l'originale Idempotency-Key e il relativo corpo.