HTTP 422 Unprocessable Content przy poprawnym JSON
Poradnik techniczny · Kacper Bernecki
POST jest składniowo prawidłowy, lecz endpoint zwraca 422 i nie tworzy rekordu. Serwer rozumie format żądania, ale wartości danych nie spełniają reguł walidacji biznesowej.
Jak ustalić źródło błędu
Sprawdź body odpowiedzi walidacyjnej i wskaż konkretne pole oraz warunek odrzucenia.
Porównaj schemat klienta i serwera, zwłaszcza enum, daty, wymagane pola i typy liczb.
Co zrobić krok po kroku
1. Popraw mapowanie pól i waliduj dane przed wysłaniem bez osłabiania reguł serwera. Przy formularzach wieloetapowych porównaj również dane po przejściu między krokami, bo klient może gubić ukryte pola.
2. Pokaż błąd użytkownikowi przy odpowiednim polu i zachowaj wprowadzone dane do poprawienia.
Jak sprawdzić wynik
Poprawne dane tworzą rekord, a nieprawidłowe dostają zrozumiałe 422 bez częściowego zapisu.
Czego nie robić
Nie zamieniaj każdego 422 w ogólny komunikat „brak połączenia”. Klient powinien zachować pola formularza, aby nie wymagać ponownego wpisywania wszystkich danych.