# Fehler und Statuscodes

Behandeln Sie API-Fehler nach HTTP-Status, strukturiertem Code und `x-request-id`. Halten Sie Zugangsdaten und Anfrageinhalte aus Logs heraus.

| Status | Bedeutung | Clientreaktion |
| --- | --- | --- |
| `400` | Ungültige Anfrage | Eingabe korrigieren, nicht unverändert wiederholen. |
| `401` | Anmeldung fehlgeschlagen | Kontotoken erneuern oder ersetzen. |
| `403` | Funktion oder Tarif verweigert | Berechtigung und Modell prüfen. |
| `404` | Route oder Ressource fehlt | /v1-Pfad und ID prüfen. |
| `429` | Anfragegrenze erreicht | Reset abwarten und Parallelität reduzieren. |
| `5xx` | Dienstfehler | Sichere Arbeit mit begrenzten, gestreuten Pausen wiederholen. |

Unbekannte Routen liefern `NOT_FOUND`, Validierungsfehler `VALIDATION_ERROR` und unerwartete Fehler `INTERNAL_ERROR`. Anbietermeldungen können wechseln; steuern Sie den Ablauf nicht anhand ihres Wortlauts.

**Erwartetes Ergebnis:** Der Client korrigiert dauerhafte Fehler oder wiederholt sicher und begrenzt, während die Anfrage-ID für den Support erhalten bleibt.