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.
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:
{"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
GET {{baseUrl}}/products?limit=0GET {{baseUrl}}/products?limit=10API-ul acceptă limit între 1 și 50.
2JSON invalid în body
{"email": "ana@magazin.test", "password": "Parola123!",}{"email": "ana@magazin.test", "password": "Parola123!"}Virgula de la final face JSON-ul invalid.
3Id de tip greșit
GET {{baseUrl}}/products/abcGET {{baseUrl}}/products/7Id-ul trebuie să fie număr întreg.
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.
Reparația
Params: limit = 10. URL-ul devine {{baseUrl}}/products?limit=10.
De ce merge
Serverul a răspuns 400 și a spus exact de ce: limit trebuie să fie între 1 și 50. O valoare din interval face cererea validă. 400 înseamnă că serverul a înțeles cererea, dar a respins-o ca formă. Mesajul din body indică parametrul greșit; după corectare, aceeași cerere trece de validare și primește răspunsul normal.
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
messagespune 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
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. 400 Bad Request: Expected double-quoted property name in JSON at position 55 Body-ul trimis nu e JSON valid, iar parserul serverului s-a oprit la poziția indicată: de obicei o virgulă la final, ghilimele simple, chei fără ghilimele sau un comentariu. Corectează JSON-ul (editorul Postman subliniază greșeala) și trimite din nou. 415 Unsupported Media Type Serverul nu acceptă formatul body-ului trimis, de obicei pentru că antetul Content-Type nu e cel așteptat: body raw lăsat pe Text în loc de JSON, form-data în loc de JSON sau JSON în loc de x-www-form-urlencoded. Alege tipul corect de body în Postman. Î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.
