...
Eroare Postman · Coduri de status 4xx și 5xx: ce înseamnă și cum le repari

422 Unprocessable Entity

Pe scurt

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:

JSON
{"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 de 2 (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ă @

Greșit
JavaScript
{"email": "radu.exemplu.test", ...}
Corect
JavaScript
{"email": "radu@exemplu.test", ...}

Validarea cere formatul nume@domeniu.

2Număr trimis ca text

Greșit
JavaScript
{"productId": 7, "quantity": "{{cantitate}}"}
Corect
JavaScript
{"productId": 7, "quantity": {{cantitate}}}

Fără ghilimele, valoarea rămâne număr în JSON.

3Câmp obligatoriu lipsă

Greșit
JavaScript
{"email": "radu@exemplu.test"}
Corect
JavaScript
{"email": "radu@exemplu.test", "password": "Parola123!"}

Serverul cere toate câmpurile obligatorii.

Repară tu

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.

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 details din 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

← Toate erorile Postman

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.