...
Eroare Postman · Variabile nerezolvate și environment-uri

400 Bad Request la /products/:id: variabila de cale nu are valoare

Pe scurt

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

Greșit
JavaScript
GET {{baseUrl}}/products/:id
Path Variables: id = (gol)
Corect
JavaScript
GET {{baseUrl}}/products/:id
Path Variables: id = 7

Cu valoare completată, URL-ul final devine /products/7.

2Variabilă de cale combinată greșit

Greșit
JavaScript
GET {{baseUrl}}/products/:{{productId}}
Corect
JavaScript
GET {{baseUrl}}/products/:id
Path Variables: id = {{productId}}

Sintaxa :id și {{...}} nu se combină în cale; valoarea dinamică se pune în tabel.

Repară tu

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.

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

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