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

Unresolved Variable: {{productId}}

Pe scurt

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.

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

Ce înseamnă

„Unresolved Variable” apare la mouse-over peste o variabilă colorată cu roșu în URL, antete sau body. Nu e o eroare a serverului: e avertismentul lui Postman că, la Send, {{productId}} va pleca exact așa, ca text.

Ce se întâmplă apoi depinde de locul variabilei:

  • în host: ENOTFOUND;
  • în cale: GET /products/{{productId}}, la care serverul răspunde 400 sau 404;
  • în body: serverul primește "{{email}}" și răspunde 422;
  • în antet: Authorization: Bearer {{token}} → 401.

Cauze: variabila nu a fost creată, are alt nume, e într-un environment neselectat, ar fi trebuit setată de un script care nu a rulat (o cerere anterioară din flux) sau e o variabilă de date folosită în afara Runner-ului.

De ce apare: cauzele frecvente

1Variabila nu e definită nicăieri

Greșit
JavaScript
GET {{baseUrl}}/products/{{productId}}
Corect
JavaScript
Collection → Variables: productId = 7
GET {{baseUrl}}/products/{{productId}}

O variabilă de colecție e disponibilă pentru toate cererile din colecție.

2Scriptul care o setează nu a rulat

Greșit
JavaScript
GET {{baseUrl}}/orders/{{orderId}}   # înainte de POST /orders
Corect
JavaScript
POST /orders → pm.collectionVariables.set("orderId", ...)
GET {{baseUrl}}/orders/{{orderId}}

Variabilele setate din scripturi există doar după ce scriptul a rulat.

3Nume scris diferit

Greșit
JavaScript
pm.collectionVariables.set("productID", 7)
GET .../products/{{productId}}
Corect
JavaScript
pm.collectionVariables.set("productId", 7)

productID și productId sunt variabile diferite.

Repară tu

Repară eroarea, direct în pagină

Cererea „Un produs” are URL-ul {{baseUrl}}/products/{{productId}}, dar productId nu există nicăieri și serverul răspunde 400. Adaugă în colecția „Magazin” variabila productId cu valoarea 7 și trimite din nou cererea: trebuie să primești 200 (produsul Mouse wireless).

Indiciu

Variabilele colecției sunt în tabul Variables al colecției.

Alte forme ale mesajului

  • Unresolved variable: {{token}}
  • {{productId}} is not defined

Cum o eviți pe viitor

  • Uită-te după roșu în URL înainte de Send.
  • Definește variabilele de colecție cu o valoare implicită rezonabilă.
  • În cererile care depind de altele, verifică variabila în pre-request și oprește cu un mesaj clar dacă lipsește.
  • Trece cu mouse-ul peste variabilă: Postman îți arată valoarea și scope-ul din care vine.

Întrebări frecvente

De ce serverul răspunde 400 și nu Postman o eroare?

Postman trimite cererea oricum, cu textul variabilei, iar serverul o refuză ca date invalide.

Pot vedea toate variabilele active?

Da, iconița „ochi” de lângă selectorul de environment arată valorile din environment și globale; variabilele colecției sunt în tabul Variables al colecției.

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.