Læs hver side, respekter hastighedsgrænser, og gendan sikkert fra fejl.
Hastighedsgrænser
Grænser kan konfigureres. GET /v1/operations/capabilities rapporterer requestsPerMinute og authenticationRequestsPerMinutePerIp. Efter en 429 skal du respektere Retry-After og vente længere, hvis begrænsningen fortsætter. Batchlæsninger accepterer op til 100 ID'er; individuelle slutpunkter kan have mindre side- eller nyttelastgrænser.
Læs hver side
Brug fortsættelsesreglen for det slutpunkt, du kaldte, og behold de samme filtre. Lister kan ændres, mens du læser dem; brug snapshots, når du har brug for en ensartet kopi.
Paginering Fortsæt med Stop når Markør Send next som after. næste er null. Forskydning med nextOffset Send nextOffset som offset. nextOffset er null. Offset med hasMore Øg offset med antallet af returnerede varer. hasMore er falsk. Software Send den numeriske next-værdi som after; genstart hvis updatedAtUtc ændres. næste er null. Hændelsesfeed Send next som after. hasMore er falsk. Håndter fejl
Læs fejlkoden samt HTTP-status. Hvis svaret inkluderer requestId, skal du angive den, når du kontakter support.
HTTP-status Hvad skal man gøre? 400 Ret anmodningen. 401 Kontroller legitimationsoplysninger, eller hent et nyt adgangstoken. 403 Kontroller omfang, tilladelser og om adgang er aktiveret. 404 Ressourcen mangler muligvis eller er uden for dit område. 409 Læs fejlkoden og den aktuelle tilstand, før du træffer en beslutning. 410 Snapshot- eller hændelsesmarkøren udløb. Start en ny baseline. Hvis en skrivning får timeout
En timeout eller 503 beviser ikke, at handlingen mislykkedes. For skrivninger, der returnerer operationskvitteringer, skal du slå GET /v1/operations/by-key?idempotencyKey={key} op, før du prøver igen. Genbrug den originale Idempotency-Key og brødtekst til vedligeholdelsesoprettelse.