Rate-Limits und Fehlercodes

Das Anfragelimit (Rate Limit) schützt die API vor Überlastung und Missbrauch. Wenn Sie in kurzer Zeit zu viele Anfragen senden, antwortet der Server mit HTTP 429 Too Many Requests und dem Header Retry-After, der angibt, wie viele Sekunden Sie warten müssen.

Aktuelle Limits

• Das Limit beträgt 60 Anfragen pro Minute pro Token. Es gilt gleichermaßen für alle Tarife (Trial, Standard, Profi und Business).
• LAN-Agenten haben ein separates Limit von 120 Anfragen pro Minute pro Agent.
• Das Limit wird für jedes Token separat berechnet (nicht für den gesamten Nutzer). Wenn Sie eine höhere Gesamtobergrenze benötigen, erstellen Sie mehrere Tokens für unterschiedliche Anwendungen (zum Beispiel separat für CI/CD und separat für das Dashboard).

Fehlercodes

• 401 Unauthorized - fehlendes oder ungültiges Token.
• 403 Forbidden - die Aktion ist in Ihrem Tarif nicht verfügbar (zum Beispiel das Erstellen eines Monitors nach Ablauf des Tarifs oder über das Limit Ihres Tarifs hinaus).
• 404 Not Found - die Ressource (Monitor, Vorfall) existiert nicht oder Sie haben keinen Zugriff darauf.
• 429 Too Many Requests - das Anfragelimit wurde überschritten. Warten Sie die im Header Retry-After angegebene Anzahl Sekunden.
• 5xx - Fehler auf der Serverseite. Versuchen Sie es erneut mit schrittweise verlängerter Verzögerung (exponential backoff - zum Beispiel 1, 2, 4, 8 Sekunden).

Empfehlungen für die Praxis

• Speichern Sie die Antworten von Lese-Endpoints im Zwischenspeicher (Cache). Verfügbarkeitsdaten ändern sich nicht jede Sekunde, Sie müssen sie also nicht so oft abrufen.
• Verwenden Sie wo möglich anstelle von wiederholten Abfragen (Polling) lieber Webhooks - der Server ruft Sie selbst an, wenn ein Ereignis eintritt.
• Fügen Sie bei Batch-Operationen zwischen den Anfragen eine kurze Verzögerung ein, damit Sie sich dem Limit nicht nähern.