HTTP 422 Unprocessable Content

Die Syntax ist korrekt und der Server hat die Anfrage verstanden, aber der Inhalt ist semantisch falsch – ein gültiges Datum in der Vergangenheit, wo ein zukünftiges Datum erforderlich ist, eine Überweisung, die ein Konto überziehen würde.

Definiert in RFC 9110 §15.5.21 — 422 Unprocessable Content · MDN-Referenz

In RFC 4918 §11.2 für WebDAV als "Unprocessable Entity" definiert, wurde es später in RFC 9110 verallgemeinert und umbenannt.

Wo Ihnen HTTP 422 in der Praxis begegnet

Validierungsfehler: eine E-Mail, die keine ist, ein Enddatum vor dem Startdatum, eine Menge null in einer Bestellposition, ein Feld, das für sich korrekt und im Kontext falsch ist.

Warum Sie ihn testen sollten

Der Unterschied zu 400 ist der Punkt: 400 heißt „ich konnte das nicht lesen“, 422 heißt „ich habe es gelesen, und nein“. Clients sollten beides Nutzern unterschiedlich anzeigen.

Was Ihr Client bei einem 422 tun sollte

Versuchen Sie es nicht erneut. Ordnen Sie die feldbezogenen Fehler dem Formular zu, das der Benutzer gerade ansieht – dies ist die einzige Fehlerklasse, bei der die API dem Client genau mitteilen kann, was zu beheben ist, und ein Client, der sie auf "invalid input" reduziert, verwirft diese Information.

422 und die Codes, mit denen er verwechselt wird

Endpunkte, die 422 zurückgeben

73 Endpunkte dieses Playgrounds antworten mit 422. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

…und 48 weitere Endpunkte im Katalog.

Fragen zu HTTP 422

Ist Port 422 nur für WebDAV?
Er stammt von dort (RFC 4918), ist aber inzwischen in RFC 9110 standardisiert und wird in REST-APIs breit für Validierung genutzt.
Wie sollte eine 422er Karosserie aussehen?
Eine Liste von Fehlern auf Feldebene: welches Feld, welche Regel und was empfangen wurde.

Weitere Client-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert