Les hver side, respekter hastighetsgrenser og gjenopprett trygt fra feil.
Hastighetsgrenser
Grenser kan konfigureres. GET /v1/operations/capabilities rapporterer requestsPerMinute og authenticationRequestsPerMinutePerIp. Etter en 429, respekter Nyt forsøk og vent lenger hvis begrensningen fortsetter. Batch-lesninger godtar opptil 100 ID-er; individuelle endepunkter kan ha mindre side- eller nyttelastgrenser. (Retry-After)
Les hver side
Bruk fortsettelsesregelen for endepunktet du kalte, og behold de samme filtrene. Lister kan endres mens du leser dem; bruk øyeblikksbilder når du trenger en konsistent kopi.
Paginering Fortsett med Stopp når Markør Send next som after. neste er null. Forskyvning med nextOffset Send nextOffset som offset. nextOffset er null. Offset med hasMore Øk offset med antall returnerte varer. hasMore er usann. Programvare Send den numeriske next-verdien som after; start på nytt hvis updatedAtUtc endres. neste er null. Hendelsesfeed Send next som after. hasMore er usann. Håndter feil
Les feilkoden samt HTTP-statusen. Hvis svaret inkluderer requestId, oppgi den når du kontakter kundestøtte.
HTTP-status Hva du skal gjøre 400 Rett forespørselen. 401 Sjekk legitimasjon eller skaff deg et nytt tilgangstoken. 403 Sjekk omfang, tillatelser og om tilgang er aktivert. 404 Ressursen kan mangle eller være utenfor ditt omfang. 409 Les feilkoden og gjeldende status før du bestemmer deg. 410 Snapshot- eller hendelsesmarkøren utløp. Start en ny grunnlinje. Hvis en skriving får tidsavbrudd
En tidsavbrudd eller 503 beviser ikke at handlingen mislyktes. For skrivinger som returnerer operasjonskvitteringer, slå opp GET /v1/operations/by-key?idempotencyKey={key} før du prøver på nytt. For vedlikeholdsoppretting, bruk den originale Idempotency-Key og brødteksten på nytt.