Lesen Sie jede Seite, beachten Sie die Ratenbegrenzungen und beheben Sie Fehler sicher.
Ratenbegrenzungen
Limits sind konfigurierbar. GET und /v1/operations/capabilities melden requestsPerMinute und authenticationRequestsPerMinutePerIp. Nach einem 429-Fehler berücksichtigen Sie „Retry-After“ und warten Sie länger, falls die Drosselung anhält. Batch-Lesevorgänge akzeptieren bis zu 100 IDs; einzelne Endpunkte können niedrigere Seiten- oder Nutzlastlimits haben.
Lies jede Seite
Verwenden Sie die Fortsetzungsregel für den aufgerufenen Endpunkt und behalten Sie die gleichen Filter bei. Listen können sich beim Lesen ändern; verwenden Sie Snapshots, wenn Sie eine konsistente Kopie benötigen.
Paginierung Fortfahren mit Anhalten, wenn Cursor next als after übergeben. Nächster Eintrag: null. Offset mit nextOffset nextOffset als offset übergeben. nextOffset ist null. Offset mit hasMore Offset um die Anzahl der zurückgegebenen Elemente erhöhen. hasMore ist falsch. Software Den numerischen Wert von next als after übergeben; Neustart bei Änderung von updatedAtUtc. Nächster Eintrag: null. Ereignisfeed next als after übergeben. hasMore ist falsch. Fehlerbehandlung
Fehlercode und HTTP-Status lesen. Falls die Antwort requestId enthält, diesen Wert beim Support angeben.
HTTP-Status Was ist zu tun? 400 Anfrage korrigieren. 401 Anmeldeinformationen prüfen oder neues Zugriffstoken anfordern. 403 Bereich, Berechtigungen und Zugriffsaktivierung prüfen. 404 Die Ressource fehlt möglicherweise oder liegt außerhalb Ihres Bereichs. 409 Lesen Sie den Fehlercode und den aktuellen Status, bevor Sie entscheiden. 410 Der Snapshot oder der Ereigniscursor ist abgelaufen. Beginnen Sie eine neue Baseline. Wenn ein Schreibvorgang ein Timeout verursacht
Ein Timeout oder ein 503-Fehler beweist nicht, dass die Aktion fehlgeschlagen ist. Bei Schreibvorgängen, die eine Vorgangsbestätigung zurückgeben, suchen Sie vor einem erneuten Versuch in GET und /v1/operations/by-key?idempotencyKey={key} nach. Verwenden Sie für Wartungsarbeiten die ursprüngliche Idempotency-Key und den zugehörigen Body wieder.