422 Unprocessable Content oznacza, że serwer rozumie typ treści, a składnia żądania jest poprawna, ale nie może przetworzyć zawartych w nim instrukcji. Na przykład treść JSON parsuje się bez problemu, ale pole z adresem e-mail jest nieprawidłowe albo wymagana wartość wykracza poza dopuszczalny zakres.
WebDAV (RFC 4918) wprowadził ten kod jako „Unprocessable Entity”, a RFC 9110 włączył go do podstawowego HTTP pod nową nazwą. Wiele frameworków i API, takich jak Ruby on Rails i Laravel, używa go przy błędach walidacji i zwraca w treści komunikaty dla poszczególnych pól.
Stosuj 400 i 422 konsekwentnie: 400 dla żądań, których nie da się sparsować, a 422 dla żądań, które da się sparsować, ale które nie przechodzą walidacji.
Przykładowa odpowiedź
HTTP/1.1 422 Unprocessable Content
Date: Fri, 06 Nov 2026 10:15:32 GMT
Content-Type: application/json
Content-Length: 77
{"message":"Validation failed","errors":[{"field":"email","code":"invalid"}]}SEO i sprawdzanie przekierowań
Kod 422 jest przeznaczony dla API i przetwarzania formularzy. Roboty używają GET i nie powinny go widzieć; strona, która zwraca 422 na GET, jest traktowana jak błąd 4xx i nie zostaje zaindeksowana.
Typowe przyczyny i zastosowania
- Wysłany formularz lub wywołanie API nie przechodzi walidacji: brakuje pola, adres e-mail jest nieprawidłowy albo nazwa użytkownika jest zajęta.
- Dokument JSON jest poprawny składniowo, ale nie pasuje do schematu API.
- Treść żądania
PROPPATCHlubLOCKw WebDAV jest poprawnym składniowo dokumentem XML, ale jest semantycznie błędna.