Ratenbegrenzung
Wie viele API-Anfragen Sie stellen können und woran Sie erkennen, dass Sie das Limit bald erreichen.
Authentifizierte API-Anfragen sind auf 3600 Anfragen pro Stunde und Projekt begrenzt. Alle API-Token eines Projekts teilen sich dieses Kontingent; zusätzliche Token erhöhen es also nicht. Anfragen aus einer Console-Sitzung zählen zu einem separaten Kontingent pro Benutzer.
Jede authentifizierte Antwort zeigt Ihnen den aktuellen Stand:
| Header | Bedeutung |
|---|---|
RateLimit-Limit | Erlaubte Anfragen pro Zeitfenster (3600) |
RateLimit-Remaining | Verbleibende Anfragen im aktuellen Zeitfenster |
RateLimit-Reset | Sekunden bis zum Zurücksetzen des Zeitfensters |
HTTP/1.1 200 OK
RateLimit-Limit: 3600
RateLimit-Remaining: 3542
RateLimit-Reset: 1834Ist das Kontingent aufgebraucht, antwortet die API mit 429 Too Many Requests, dem Code rate_limit_exceeded und
einem Retry-After-Header (in Sekunden). Warten Sie so lange, bevor Sie es erneut versuchen. Die odx CLI und der
Terraform-Provider erledigen das automatisch.
Einige Endpunkte haben eigene, strengere Limits:
- Änderungen am Reverse DNS: 60 pro Stunde und Projekt.
- Registrierung, Anmeldung, Zwei-Faktor-Codes, Passwort-Zurücksetzung und Bestätigungs-E-Mails sind zum Schutz vor Missbrauch pro IP-Adresse und pro Konto begrenzt. Das betrifft nur die Console.
Effizientes Polling
Die meisten Anfragen in Skripten fragen den Status von Aktionen ab. Fragen Sie alle ein bis
zwei Sekunden ab statt in einer engen Schleife, und listen Sie Ressourcen mit per_page=50 (dem Maximum) auf, um
weniger Seiten abrufen zu müssen.