Zum Inhalt springen

Fehlercodes und Rate-Limits

API-Referenz · Zuletzt aktualisiert am 16.08.2026

Auf dieser Seite
  1. Fehlercodes
  2. Anfragebudget
  3. Welche Fehler dürfen wiederholt werden?

Fehler verwenden denselben Umschlag wie erfolgreiche Antworten. data und meta sind dann null, während errors den maschinenlesbaren Grund enthält:

{
  "data": null,
  "meta": null,
  "errors": [
    {
      "status": 422,
      "code": "invalid_parameter",
      "message": "Der Parameter … ist ungültig."
    }
  ]
}

Heute enthält das Array höchstens einen Fehler. Behandle es dennoch als Array und verzweige über code, nicht über den deutschen Meldungstext. Unbekannte Codes wertest du anhand des HTTP-Status aus.

Fehlercodes#

Code Status Bedeutung und Reaktion
invalid_token 401 Token fehlt, ist fehlerhaft oder wurde ersetzt. Konfiguration prüfen und gegebenenfalls neu verbinden.
entitlement_paused 403 Tarif deckt Verknüpfung oder Feed derzeit nicht. Kein automatischer Token-Wechsel.
feed_not_found 404 Feed wurde nicht gefunden oder ist für diese Verknüpfung nicht verfügbar.
post_not_found 404 Post existiert nicht mehr oder gehört nicht zu diesem Feed.
invalid_parameter 422 Mindestens ein Query-Parameter ist ungültig. Anfrage korrigieren, nicht unverändert wiederholen.
rate_limited 429 Anfragebudget erschöpft. Retry-After abwarten.
server_error 5xx Vorübergehender Serverfehler. Mit wachsender Wartezeit erneut versuchen.
not_found 404 Route oder Ressource nicht gefunden.
forbidden 403 Zugriff nicht erlaubt.
bad_request 400 Anfrage ist syntaktisch oder fachlich ungültig.

Anfragebudget#

Das Limit gilt je API-Verknüpfung und Minute:

Tarif Anfragen je Minute
Pro 300
Business 600

Jede authentifizierte API-Antwort liefert:

Kopfzeile Bedeutung
X-RateLimit-Limit Maximale Anfragen im aktuellen Fenster
X-RateLimit-Remaining Noch verfügbare Anfragen
X-RateLimit-Reset Unix-Zeitpunkt, zu dem das Fenster zurückgesetzt wird
Retry-After Bei 429: Wartezeit in Sekunden

Reduziere die Abruffrequenz bereits, wenn Remaining niedrig wird. Bei einer 429-Antwort ist Retry-After verbindlich; zusätzliche sofortige Versuche verlängern die Störung nur.

Welche Fehler dürfen wiederholt werden?#

  • Netzwerkfehler und 5xx: mit exponentieller Wartezeit und Zufallsanteil erneut versuchen.
  • 429: exakt nach Retry-After beziehungsweise nach dem Reset erneut anfragen.
  • 401: Konfiguration prüfen; keine Endlosschleife mit demselben Token.
  • 403: Tarif oder Freigabe klären; automatische Wiederholungen helfen kurzfristig nicht.
  • 404: Feed-Umfang neu abrufen; bei einzelnen Posts lokale Zuordnung erst im sicheren Vollabgleich bereinigen.
  • 400 und 422: Anfrage korrigieren; unveränderte Wiederholung vermeiden.

Ein praxisnahes Backoff-Schema steht unter Fehler und Rate-Limits behandeln.

Passt dazu

Frage nicht beantwortet? Schreib uns — wir ergänzen die Seite.