Rate-Limits und Fehlercodes

3 Min. Lesezeit · API & Integrationen

Rate-Limits verhindern den Missbrauch der API. Bei Überschreitung erhalten Sie HTTP 429 mit Retry-After-Header.

Limits nach Plan

Trial / Standard: 60 Requests / Minute Profi: 300 Requests / Minute Business: 1000 Requests / Minute Das Limit gilt pro Token, nicht pro Benutzer (Sie können mehrere Tokens für verschiedene Use Cases haben).

Fehlercodes

- 401 Unauthorized: fehlendes oder ungültiges Token - 403 Forbidden: Token hat keine Berechtigung für die angegebene Aktion (Read-only-Token auf Write-Endpoint) - 404 Not Found: Ressource existiert nicht - 429 Too Many Requests: Rate-Limit überschritten, warten Sie Retry-After Sekunden - 5xx: Server-Fehler, Retry mit Exponential Backoff

Best Practices

- Cachen Sie Responses für Lesezugriffe (Uptime-Daten ändern sich nicht jede Sekunde) - Verwenden Sie Webhooks statt Polling, wo möglich - Bei Batch-Operationen verwenden Sie eine Verzögerung zwischen Requests