API-Fehler

Die API meldet Fehler mit Standard-HTTP-Statuscodes und einem einheitlichen Antwort-Body. Erfolgreiche Antworten geben Daten direkt zurück, ohne Umschlag.

Fehlerformat

Bei einem Fehler ist der Antwort-Body ein JSON-Objekt mit einem Feld error, das eine menschenlesbare Meldung enthält:

{"error":"reaction not found"}

Orientieren Sie sich in erster Linie am HTTP-Statuscode; den Text aus error verwenden Sie für Logs und Benutzerhinweise.

Statuscodes

  • 200 OK — Anfrage erfolgreich, Daten im Body.
  • 201 Created — neue Ressource erstellt (bei manchen POST-Endpunkten).
  • 204 No Content — Erfolg ohne Body (bei manchen Löschoperationen).
  • 400 Bad Request — ungültiger Body oder Anfrageparameter.
  • 401 Unauthorized — Token fehlt, ist ungültig oder abgelaufen; oder die Route ist per persönlichem Token nicht zugänglich.
  • 402 Payment Required — Aktion stößt an Tarif- oder Kontingentgrenze (z. B. eigener Medienspeicher erfordert Premium).
  • 403 Forbidden — dem Token fehlt der erforderliche Zugriffsbereich für diese Route.
  • 404 Not Found — Ressource nicht gefunden oder gehört Ihnen nicht.
  • 409 Conflict — Zustandskonflikt (z. B. Duplikat eines eindeutigen Werts).
  • 422 Unprocessable Entity — Body syntaktisch gültig, aber die fachliche Validierung schlägt fehl.
  • 429 Too Many Requests — Anfragelimit überschritten (siehe Limits).
  • 500 Internal Server Error — interner Serverfehler; bitte später erneut versuchen.

Fehlerbehandlung

Codes 2xx gelten als Erfolg. Bei 401/403 — Token und Zugriffsbereiche prüfen. Bei 4xx (außer 429) — Anfrage nicht unverändert wiederholen, sondern korrigieren. Bei 429 und 5xx ist eine Wiederholung mit exponentiellem Backoff angebracht.

Nächste Schritte