Odczytuj każdą stronę, przestrzegaj limitów przepustowości i bezpiecznie odzyskuj dane po błędach.
Limits przepustowości
Limits są konfigurowalne. GET /v1/operations/capabilities zgłasza requestsPerMinute i authenticationRequestsPerMinutePerIp. Po błędach 429 respektuj opcję Retry-Aft i odczekaj dłużej, jeśli ograniczenie przepustowości nadal występuje. Odczyty wsadowe akceptują do 100 identyfikatorów; poszczególne punkty końcowe mogą mieć mniejsze limity stron lub danych. (Retry-After)
Przeczytaj każdą stronę
Użyj reguły kontynuacji dla wywołanego punktu końcowego, zachowując te same filtry. Listy mogą się zmieniać podczas odczytu; użyj migawek, gdy potrzebujesz spójnej kopii.
Paginacja Kontynuuj z Zatrzymaj, gdy Kursor Przekaż next jako after. Następny to null. Przesunięcie z nextOffset Przekaż nextOffset jako offset. nextOffset to null. Przesunięcie o hasMore Zwiększ przesunięcie o liczbę zwróconych elementów. hasMore ma wartość false. Oprogramowanie Przekaż wartość liczbową next jako after; uruchom ponownie, jeśli updatedAtUtc ulegnie zmianie. Następny to null. Kanał zdarzeń Przekaż next jako after. hasMore ma wartość false. Obsługa błędów
Odczytaj kod błędu oraz status HTTP. Jeśli odpowiedź zawiera kod requestId, podaj go podczas kontaktu z pomocą techniczną.
Status HTTP Co zrobić 400 Napraw żądanie. 401 Sprawdź dane uwierzytelniające lub uzyskaj nowy token dostępu. 403 Sprawdź zakres, uprawnienia i czy dostęp jest włączony. 404 Zasób może być nieobecny lub znajdować się poza Twoim zakresem. 409 Przed podjęciem decyzji przeczytaj kod błędu i aktualny stan. 410 Migawka lub kursor zdarzeń wygasł. Rozpocznij nową linię bazową. Jeśli upłynął limit czasu zapisu
Upływ limitu czasu lub błąd 503 nie dowodzi, że akcja się nie powiodła. W przypadku zapisów zwracających potwierdzenia operacji, wyszukaj GET /v1/operations/by-key?idempotencyKey={key} przed ponowną próbą. W przypadku tworzenia w celach konserwacyjnych ponownie użyj oryginalnego Idempotency-Key i treści.