Fehler, Kontingente und Limits

Fehlerumschlag, Statuscodes und Verhalten bei Kontingent-/Billing-Ausfällen.

1 Min. Lesezeit 3 Abschnitte

Fehlerumschlag#

Fehlerantworten enthalten die Felder error, message, statusCode und requestId.

Fehlerantwort

{
  "error": "ForbiddenError",
  "message": "Erforderliche Berechtigungen: links:write",
  "statusCode": 403,
  "requestId": "…"
}

Statuscodes#

Code	Bedeutung
`400`	Ungültiger Body oder Cursor
`401`	Schlüssel fehlt, ist ungültig, widerrufen oder abgelaufen
`403`	Erforderlicher Scope fehlt
`409`	Idempotenz-Konflikt (gleicher Schlüssel, andere Payload)
`429`	Kontingent überschritten; warten Sie die `Retry-After`-Zeit ab
`503`	Mutation während eines Billing-Ausfalls; mit demselben Idempotency-Key erneut versuchen

Kontingente#

Jeder Aufruf der Developer API wird auf Ihre monatliche Nutzung monthlyApiCalls angerechnet; Link-, Tree-, Board-, Route- und Event-Aktionen verbrauchen zusätzlich die Ressourcenkontingente des Tarifs. Idempotente Wiederholungen erhöhen die Zähler nicht doppelt. Ihre aktuelle Nutzung sehen Sie im Tab „Nutzung“ der Konsole.

Bei einem Ausfall beim Lesen/Prüfen der Abrechnung laufen schreibgeschützte Anfragen kontrolliert weiter; nur Mutationen werden mit 503 gestoppt.

Fehlt etwas oder ist etwas falsch? Schreiben Sie dem Support-Team; die Angabe des X-Request-Id-Werts aus der Antwort beschleunigt die Lösung.