400 Bad Request la /products/:id: variabila de cale nu are valoare
URL-ul conține o variabilă de cale (:id), dar în Params → Path Variables valoarea ei e goală, deci cererea pleacă literal cu „:id”. Completează valoarea în tabelul Path Variables (sau folosește {{productId}} acolo).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Postman, un segment care începe cu două puncte (/products/:id) e o variabilă de cale. Valoarea ei se completează în tabul Params, secțiunea Path Variables. Dacă rămâne goală, Postman trimite cererea cu textul :id, iar serverul răspunde după cum îl tratează: 400 (id invalid), 404 (resursă inexistentă) sau chiar 500.
În API-ul demo, răspunsul e 400 cu mesajul „id-ul produsului trebuie să fie un număr întreg”.
Variabilele de cale sunt utile pentru documentație (apar ca parametri descriși) și se pot combina cu variabile obișnuite: valoarea lui id poate fi {{productId}}. Atenție: :id funcționează doar ca segment întreg de cale, nu în query string și nici în host.
De ce apare: cauzele frecvente
1Valoarea lipsește din Path Variables
GET {{baseUrl}}/products/:id
Path Variables: id = (gol)GET {{baseUrl}}/products/:id
Path Variables: id = 7Cu valoare completată, URL-ul final devine /products/7.
2Variabilă de cale combinată greșit
GET {{baseUrl}}/products/:{{productId}}GET {{baseUrl}}/products/:id
Path Variables: id = {{productId}}Sintaxa :id și {{...}} nu se combină în cale; valoarea dinamică se pune în tabel.
Repară eroarea, direct în pagină
Cererea „Un produs” are URL-ul {{baseUrl}}/products/:id, dar valoarea lui id din Path Variables e goală, deci serverul răspunde 400. Completează id cu 7, salvează cererea și trimite-o: trebuie să primești 200, cu produsul Mouse wireless.
Indiciu
Tabul Params, secțiunea Path Variables.
Reparația
Params → Path Variables: id = 7. Salvează și trimite.
De ce merge
Fără valoare, URL-ul final conținea literal :id, iar serverul nu-l putea interpreta ca număr. Cu valoarea 7, cererea devine GET /products/7. Variabila de cale :id se completează în tabul Params. Fără valoare, URL-ul se termină cu slash, iar serverul nu primește un id valid. Cu valoarea completată, cererea ajunge la produsul cerut.
Cum o eviți pe viitor
- Completează valorile din Path Variables când salvezi cererea, cu un exemplu valid.
- Descrie fiecare parametru în coloana Description, ca documentația generată să fie utilă.
- Când primești 400 sau 404 pe un endpoint cu
:, verifică în Console URL-ul final.
Întrebări frecvente
De ce nu apare cu roșu ca {{variabilele}}?
Variabilele de cale nu sunt variabile de environment, deci editorul nu le marchează ca nerezolvate.
Pot seta variabila de cale din script?
Indirect: pui {{productId}} ca valoare în tabel și setezi productId din script.
Erori înrudite
Unresolved Variable: {{productId}} Postman nu găsește variabila în niciun scope activ și o va trimite ca text. Definește-o (în collection, environment sau din script), verifică numele exact și environment-ul selectat; abia apoi trimite cererea. 404 Not Found Serverul nu are resursa sau ruta cerută: calea e scrisă greșit (singular/plural, versiune lipsă), id-ul nu există sau metoda și calea nu se potrivesc. Compară URL-ul final din Console cu documentația și verifică id-ul. 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. Î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.
