422 Unprocessable Entity
Body-ul e JSON valid, dar datele încalcă regulile: un câmp obligatoriu lipsește, un email are format greșit, o valoare e în afara limitelor sau are tipul greșit. Citește lista de erori din răspuns (de obicei pe câmpuri) și corectează exact câmpurile indicate.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
422 înseamnă că serverul a înțeles cererea (format corect, JSON valid), dar datele nu trec validarea. Un API bun spune exact ce e greșit:
{"error": "validation_error", "details": [{"field": "email", "message": "nu are un format valid"}]}Cauze frecvente:
- câmp obligatoriu lipsă sau gol;
- format invalid (email fără @, dată greșită);
- valoare în afara limitelor (cantitate 0, parolă prea scurtă);
- tip greșit:
"quantity": "2"(text) în loc de2(număr), des întâlnit când pui variabile între ghilimele în body; - o variabilă nerezolvată, trimisă ca text
{{email}}.
Pentru testare, 422 e rezultatul dorit al testelor negative de validare. Verifici și că details numește câmpul corect.
De ce apare: cauzele frecvente
1Email fără @
{"email": "radu.exemplu.test", ...}{"email": "radu@exemplu.test", ...}Validarea cere formatul nume@domeniu.
2Număr trimis ca text
{"productId": 7, "quantity": "{{cantitate}}"}{"productId": 7, "quantity": {{cantitate}}}Fără ghilimele, valoarea rămâne număr în JSON.
3Câmp obligatoriu lipsă
{"email": "radu@exemplu.test"}{"email": "radu@exemplu.test", "password": "Parola123!"}Serverul cere toate câmpurile obligatorii.
Repară eroarea, direct în pagină
Cererea „Înregistrare” trimite emailul radu.exemplu.test, fără @, iar serverul răspunde 422 cu detalii pe câmpul email. Corectează emailul în {{$randomEmail}} (un email valid, unic la fiecare trimitere), salvează cererea și trimite-o: trebuie să primești 201.
Indiciu
Citește details din răspunsul 422.
Reparația
{
"name": "Radu Ene",
"email": "{{$randomEmail}}",
"password": "Parola123!"
}De ce merge
Răspunsul 422 numea exact câmpul greșit (email). Cu un email în format valid, validarea trece; variabila dinamică evită și conflictul 409 la rulările următoare. 422 înseamnă că JSON-ul e corect ca formă, dar valorile încalcă regulile de validare. După ce fiecare câmp respectă regulile din documentație, serverul acceptă datele și răspunde cu succes.
Alte forme ale mesajului
422 Unprocessable Entity: Datele trimise nu sunt valide.{"error": "validation_error"}HTTP 422
Cum o eviți pe viitor
- Citește
detailsdin răspuns: arată exact câmpul și regula încălcată. - Pune variabilele numerice fără ghilimele în body.
- Construiește teste negative pentru fiecare regulă de validare documentată.
- Citește lista de erori din body: fiecare câmp invalid apare separat, cu motivul.
Întrebări frecvente
Ce diferență e între 422 și 400?
400: cererea e greșit formată. 422: formatul e bun, dar datele nu respectă regulile. Unele API-uri folosesc 400 pentru ambele.
De ce primesc 422 doar în Runner?
Un rând din fișierul de date are o valoare goală sau invalidă pentru acel câmp.
Erori înrudite
400 Bad Request Serverul a primit cererea, dar o consideră greșit formată: un parametru invalid, JSON stricat, un câmp de tip greșit. Citește body-ul răspunsului (de obicei spune exact ce parametru e greșit) și corectează cererea. 409 Conflict Cererea intră în conflict cu starea curentă a resursei: emailul e deja folosit, stocul nu ajunge, comanda nu mai poate fi anulată sau o cheie de idempotență a fost refolosită. Citește codul din body și schimbă datele (de exemplu un email unic cu {{$randomEmail}}). AssertionError: expected { Object (id, name, ...) } to have property 'pret' Obiectul verificat nu are câmpul cerut de test. Fie testul folosește un nume greșit (pret în loc de price), fie verifici alt obiect decât crezi (lista în loc de primul element), fie API-ul a scos câmpul. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
