Přečtěte každou stránku, dodržujte limity rychlosti a bezpečně se zotavte z chyb.
Limity rychlosti
Limity jsou konfigurovatelné. GET /v1/operations/capabilities hlásí requestsPerMinute a authenticationRequestsPerMinutePerIp. Po chybě 429 respektujte Retry-After a čekejte déle, pokud omezování pokračuje. Dávkové čtení akceptuje až 100 ID; jednotlivé koncové body mohou mít menší limity stránek nebo datového zatížení.
Přečtěte si každou stránku
Použijte pravidlo pokračování pro volaný koncový bod a zachujte stejné filtry. Seznamy se mohou během čtení měnit; snímky použijte, když potřebujete konzistentní kopii.
Stránkování Pokračovat s Zastavit, když Kurzor Předat next jako after. další je null. Posunout s nextOffset Předat nextOffset jako offset. nextOffset je null. Offset s hasMore Zvětšit offset o počet vrácených položek. hasMore je false. Software Předat číselnou hodnotu next jako after; restartovat, pokud se updatedAtUtc změní. další je null. Kanál událostí Předat next jako after. hasMore je false. Ošetření chyb
Přečíst chybový kód a stav HTTP. Pokud odpověď obsahuje requestId, uveďte ji při kontaktování podpory.
Stav HTTP Co dělat 400 Opravte požadavek. 401 Zkontrolujte přihlašovací údaje nebo získejte nový přístupový token. 403 Zkontrolujte rozsah, oprávnění a zda je přístup povolen. 404 Prostředek může chybět nebo je mimo váš rozsah. 409 Před rozhodnutím si přečtěte kód chyby a aktuální stav. 410 Platnost snímku nebo kurzoru události vypršela. Spusťte novou základní linii. Pokud vyprší časový limit zápisu
Časový limit nebo chyba 503 nedokazuje, že akce selhala. U zápisů, které vracejí potvrzení operace, vyhledejte před opětovným pokusem GET /v1/operations/by-key?idempotencyKey={key}. Pro vytváření údržby znovu použijte původní Idempotency-Key a tělo.