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.