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

400 Bad Request

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

400 Bad Request e răspunsul general pentru „cererea ta nu e corectă”. Serverul a ajuns să o proceseze, dar ceva din ea nu respectă regulile: un parametru de query în afara limitelor, un JSON invalid, un antet greșit, un id care nu e număr.

Informația utilă e în body. Un API bine făcut spune ce nu e în regulă, de exemplu:

JSON
{"error": "bad_request", "message": "Parametrul limit trebuie să fie între 1 și 50."}

Unele API-uri folosesc 400 și pentru validarea datelor, altele 422; ambele variante sunt acceptate dacă sunt consecvente. Ca tester, 400 e rezultatul așteptat al multor teste negative (parametri invalizi). Problema apare doar când îl primești la o cerere pe care o credeai corectă.

De ce apare: cauzele frecvente

1Parametru în afara limitelor

Greșit
JavaScript
GET {{baseUrl}}/products?limit=0
Corect
JavaScript
GET {{baseUrl}}/products?limit=10

API-ul acceptă limit între 1 și 50.

2JSON invalid în body

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

Virgula de la final face JSON-ul invalid.

3Id de tip greșit

Greșit
JavaScript
GET {{baseUrl}}/products/abc
Corect
JavaScript
GET {{baseUrl}}/products/7

Id-ul trebuie să fie număr întreg.

Repară tu

Repară eroarea, direct în pagină

Cererea „Prima pagină” trimite limit=0, iar API-ul răspunde 400: limit trebuie să fie între 1 și 50. Schimbă parametrul limit în 10, salvează cererea și trimite-o: trebuie să primești 200.

Indiciu

Parametrii de query se editează în tabul Params.

Alte forme ale mesajului

  • 400 Bad Request: Parametrul limit trebuie să fie între 1 și 50.
  • HTTP 400

Cum o eviți pe viitor

  • Citește documentația parametrilor (limite, tipuri, valori permise).
  • Citește mereu body-ul răspunsului 400 înainte de a schimba ceva.
  • Pentru valorile limită, scrie teste negative care așteaptă intenționat 400.
  • Citește întotdeauna body-ul unui 400: câmpul message spune ce parametru a fost respins.

Întrebări frecvente

Ce diferență e între 400 și 422?

400: cererea e greșit formată (sintaxă, parametri). 422: formatul e bun, dar datele încalcă regulile. Unele API-uri folosesc doar 400.

E bug dacă primesc 400?

Nu, dacă cererea chiar e greșită. E bug dacă serverul răspunde 400 la o cerere validă sau 500 la una invalidă.

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.