Erori Postman explicate: ce înseamnă și cum le repari
Mesajele de eroare Postman pe care le primești cel mai des, fiecare explicat pe înțeles: ce înseamnă, de ce apare, cod greșit lângă cod corect și cum o repari. Înveți de la zero cu Curs API Testing cu Postman: primele 10 lecții sunt gratuite.
Pagină coordonată de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
- 122erori
- 9capitole
- 61ușor
- 55mediu
- 6greu
Aici găsești erorile pe care le primești cel mai des când lucrezi cu Postman: cereri care nu primesc răspuns (Could not get response, ECONNREFUSED, ENOTFOUND, certificate SSL), variabile nerezolvate, coduri de status 4xx și 5xx, probleme de autentificare, erori de parsare JSON, erori în scripturile Pre-request și Post-response, teste care pică cu AssertionError, probleme în Collection Runner și erori din Newman și CI. Fiecare eroare e explicată pe înțeles: ce spune mesajul, de ce apare (cu varianta greșită lângă cea corectă), cum o repari și cum o eviți pe viitor.
Erorile sunt grupate pe capitole, după locul în care apar: conexiune, variabile, statusuri, autentificare, JSON, scripturi, teste, Runner și Newman. Caută în pagină mesajul exact din consola Postman, din panoul de răspuns sau din output-ul Newman, citește cauzele și verifică-o pe cea care se potrivește cu situația ta. Pe pagina fiecărei erori ai și un exercițiu „Repară tu” în simulatorul Postman: pornești de la cererea stricată, o repari și trimiți din nou până trece.
Could not get response: conexiune, SSL, proxy și CORS
Error: connect ECONNREFUSED 127.0.0.1:3000 Postman a încercat să se conecteze la portul 3000 de pe calculatorul tău, dar acolo nu ascultă niciun server. Pornește API-ul local (npm start, dotnet run etc.) sau alege environment-ul cu adresa serverului care chiar rulează. Explicația completă → Mediu Repară tu Error: connect ECONNREFUSED ::1:8080 Postman a rezolvat localhost la adresa IPv6 ::1, dar serverul ascultă doar pe IPv4 (127.0.0.1). Folosește în URL 127.0.0.1 în loc de localhost sau pornește serverul să asculte și pe IPv6. Explicația completă → Ușor Repară tu Error: getaddrinfo ENOTFOUND api.magazn.test Numele serverului din URL nu a putut fi găsit în DNS: de obicei e scris greșit, lipsește o parte din domeniu sau serverul e accesibil doar prin VPN. Verifică hostul exact din Console și corectează-l în URL sau în environment. Explicația completă → Ușor Repară tu Error: getaddrinfo ENOTFOUND https Protocolul apare de două ori în URL: baseUrl conține deja https://, iar în cerere ai scris încă o dată https:// în fața lui. Postman citește „https” ca nume de server. Scoate protocolul din cerere și lasă doar {{baseUrl}}/cale. Explicația completă → Mediu Repară tu Error: getaddrinfo EAI_AGAIN api.magazin.test DNS-ul nu a putut răspunde acum (eroare temporară): nu ai internet, VPN-ul a căzut, serverul DNS e indisponibil sau rulezi într-un container fără DNS. Verifică rețeaua și reîncearcă; dacă persistă, problema e în configurarea DNS, nu în API. Explicația completă → Ușor Repară tu Error: ESOCKETTIMEDOUT Serverul nu a trimis niciun răspuns în timpul maxim setat pentru cerere. Mărește timeout-ul (Settings al cererii, Settings global sau --timeout-request în Newman) dacă operația e lentă în mod normal, altfel raportează lentoarea ca problemă de performanță. Explicația completă → Mediu Repară tu Error: connect ETIMEDOUT 10.0.0.5:443 Conexiunea la server nu s-a putut stabili în timp: adresa IP nu e accesibilă din rețeaua ta (firewall, VPN, IP privat) sau serverul e oprit. Verifică dacă folosești adresa corectă, de preferat numele public al serverului, nu un IP intern. Explicația completă → Mediu Repară tu Error: socket hang up Serverul (sau un proxy) a închis conexiunea înainte să trimită un răspuns complet. Cauze tipice: un antet Content-Length scris manual și greșit, HTTP trimis pe un port HTTPS, serverul care cade la cerere sau o limită de timp a proxy-ului. Verifică antetele manuale și logul serverului. Explicația completă → Mediu Repară tu Error: read ECONNRESET Conexiunea a fost închisă brusc de cealaltă parte (server, proxy, firewall sau antivirus) în timp ce Postman citea răspunsul. Reîncearcă, verifică proxy-ul și VPN-ul, iar dacă apare la rafale de cereri, adaugă o pauză între ele. Explicația completă → Ușor Repară tu Could not send request Mesajul general din panoul de răspuns când cererea nu a primit niciun răspuns HTTP. Detaliul de sub el (ECONNREFUSED, ENOTFOUND, timeout, Invalid URL) spune cauza reală; deschide Console ca să vezi URL-ul final și eroarea completă. Explicația completă → Mediu Repară tu Error: self signed certificate Serverul folosește un certificat HTTPS semnat de el însuși, pe care Postman nu îl consideră de încredere. Pentru un mediu local sau de test poți dezactiva „SSL certificate verification” sau, mai bine, adaugi certificatul CA în Settings → Certificates; în producție, certificatul trebuie reparat. Explicația completă → Mediu Repară tu Error: self-signed certificate in certificate chain Lanțul de certificate al serverului se termină într-o autoritate (CA) pe care Postman nu o cunoaște: de obicei CA-ul intern al firmei sau un proxy care inspectează HTTPS. Adaugă certificatul CA în Settings → Certificates (și --ssl-extra-ca-certs în Newman). Explicația completă → Mediu Repară tu Error: unable to verify the first certificate Serverul trimite doar certificatul lui, fără certificatele intermediare, iar Postman nu poate construi lanțul până la o autoritate de încredere. Reparația e pe server (să trimită lanțul complet); temporar, adaugi intermediarul ca CA în Postman. Explicația completă → Mediu Repară tu Error: certificate has expired Certificatul HTTPS al serverului a expirat, iar Postman refuză conexiunea. Reparația e pe server: certificatul trebuie reînnoit. Verifică și ceasul calculatorului: o dată greșită face un certificat valid să pară expirat. Explicația completă → Greu Repară tu Error: Hostname/IP does not match certificate's altnames: Host: 10.0.0.5. is not in the cert's altnames Certificatul serverului e emis pentru un nume (de exemplu api.magazin.test), dar tu te conectezi prin alt nume sau prin IP. Folosește în URL exact numele din certificat, de obicei prin {{baseUrl}}, nu adresa IP. Explicația completă → Greu Repară tu Error: write EPROTO ... SSL routines:ssl3_get_record:wrong version number Ai trimis o cerere HTTPS spre un port care vorbește HTTP simplu (sau spre un proxy greșit). Clientul așteaptă un handshake TLS și primește text HTTP. Folosește http:// pentru serverul fără TLS sau portul HTTPS corect. Explicația completă → Mediu Repară tu 400 The plain HTTP request was sent to HTTPS port Ai trimis cererea cu http:// spre un port pe care serverul (de obicei nginx) așteaptă HTTPS. Serverul răspunde 400 cu o pagină HTML. Schimbă protocolul în https:// sau scoate portul 443 din URL. Explicația completă → Ușor Repară tu Cloud Agent Error: Can't send requests to localhost Folosești Postman în browser cu Cloud Agent, care trimite cererile de pe serverele Postman și nu poate ajunge la localhost-ul tău. Instalează și selectează Desktop Agent, folosește aplicația Postman Desktop sau testează pe un mediu public (ori pe un mock server). Explicația completă → Mediu Repară tu CORS Error: The request has been blocked because of the CORS policy Folosești Postman în browser cu Browser Agent, iar browserul blochează răspunsul pentru că serverul nu permite originea paginii Postman (lipsește Access-Control-Allow-Origin). Comută pe Desktop Agent sau Cloud Agent; dacă testezi chiar CORS-ul API-ului, verifici antetele de răspuns. Explicația completă → Greu Repară tu Error: tunneling socket could not be established, cause=connect ECONNREFUSED 127.0.0.1:8888 Postman încearcă să treacă prin proxy-ul configurat (aici 127.0.0.1:8888), dar proxy-ul nu răspunde. Oprește proxy-ul din Settings → Proxy dacă nu ai nevoie de el, pornește-l (de exemplu Fiddler, Charles) sau corectează adresa proxy-ului firmei. Explicația completă → Variabile nerezolvate și environment-uri
Error: getaddrinfo ENOTFOUND {{baseurl}} Variabila {{baseUrl}} nu s-a rezolvat, așa că Postman a trimis textul ei ca nume de server. De obicei nu e selectat niciun environment sau variabila are alt nume ori e definită în alt environment. Selectează environment-ul corect și verifică numele exact. Explicația completă → Ușor Repară tu 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. Explicația completă → Mediu Repară tu Error: Invalid URI "https:///products" URL-ul final nu are server: variabila pentru host există, dar e goală, deci rămân trei bare. Completează Current value al variabilei în environment-ul selectat (sau Initial value, dacă vrei s-o vadă și colegii). Explicația completă → Ușor Repară tu pm.environment.set nu salvează nimic: No Environment selectat pm.environment.set scrie în environment-ul activ. Dacă e selectat „No Environment”, nu are unde să scrie, deci tokenul nu apare nicăieri, iar cererile următoare pleacă cu {{token}} nerezolvat. Selectează un environment sau salvează valoarea ca variabilă de colecție. Explicația completă → Mediu Repară tu Variabila are altă valoare decât cea setată: precedența scope-urilor Aceeași variabilă există în mai multe scope-uri, iar Postman o folosește pe cea mai îngustă: local, data, environment, colecție, global. Ai schimbat valoarea într-un scope mai larg, dar câștigă cea veche dintr-unul mai îngust. Șterge dublura sau modifică valoarea în scope-ul care câștigă. Explicația completă → Mediu Repară tu TypeError: Cannot read properties of undefined (reading 'split') Scriptul apelează .split() pe o valoare care e undefined, de obicei o variabilă citită cu pm.environment.get care nu există încă (tokenul nu a fost salvat, alt environment, alt nume). Asigură-te că variabila e setată înainte și verifică-o în script înainte să o folosești. Explicația completă → Mediu Repară tu {{email}} trimis literal: variabilă de date folosită la Send Variabilele dintr-un fișier CSV sau JSON există doar când rulezi colecția în Collection Runner (sau Newman cu -d). La Send manual, {{email}} nu are valoare și pleacă ca text. Rulează cererea în Runner cu fișierul de date sau dă-i o valoare implicită pentru testele manuale. Explicația completă → Ușor Repară tu 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). Explicația completă → Ușor Repară tu {{randomEmail}} trimis literal în loc de {{$randomEmail}} Variabilele dinamice ale Postman încep cu $: {{$randomEmail}}, {{$guid}}, {{$timestamp}}. Fără $, {{randomEmail}} e căutată ca variabilă obișnuită, nu se găsește și pleacă literal, iar serverul respinge emailul. Adaugă $ după acolade. Explicația completă → Coduri de status 4xx și 5xx: ce înseamnă și cum le repari
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. Explicația completă → Ușor Repară tu 401 Unauthorized Serverul nu știe cine ești: tokenul lipsește, e expirat sau invalid, sau cheia API nu e trimisă. Obține un token nou (login) și verifică în Console că antetul Authorization chiar pleacă cu cererea. Explicația completă → Ușor Repară tu 403 Forbidden Serverul știe cine ești, dar contul tău nu are dreptul la această operație sau resursă (de exemplu un client care cere lista de utilizatori, rezervată adminilor). Folosește un cont cu rolul potrivit; dacă ar trebui să ai acces, raportează problema de permisiuni. Explicația completă → Ușor Repară tu 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. Explicația completă → Ușor Repară tu 405 Method Not Allowed Ruta există, dar nu acceptă metoda HTTP trimisă (de exemplu DELETE pe lista de produse sau POST pe un endpoint doar de citire). Verifică metoda din dropdown-ul de lângă URL și antetul Allow din răspuns, care spune metodele permise. Explicația completă → Mediu Repară tu 409 Conflict Cererea intră în conflict cu starea curentă a resursei: emailul e deja folosit, stocul nu ajunge, comanda nu mai poate fi anulată sau o cheie de idempotență a fost refolosită. Citește codul din body și schimbă datele (de exemplu un email unic cu {{$randomEmail}}). Explicația completă → Ușor Repară tu 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. Explicația completă → Mediu Repară tu 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. Explicația completă → Mediu Repară tu 429 Too Many Requests Ai depășit limita de cereri a API-ului (rate limiting). Așteaptă numărul de secunde din antetul Retry-After, pune o pauză între cereri în Runner și Newman și scrie teste care tratează 429 separat de erorile reale. Explicația completă → Ușor Repară tu 301 Moved Permanently în loc de răspunsul așteptat Adresa cerută a fost mutată, iar serverul îți spune unde prin antetul Location. Dacă ai dezactivat „Automatically follow redirects”, vezi 301 în loc de pagina finală. Folosește direct adresa nouă din Location sau reactivează urmarea redirecționărilor. Explicația completă → Mediu Repară tu 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. Explicația completă → Ușor Repară tu 500 Internal Server Error Serverul a avut o eroare neprevăzută în timp ce procesa cererea: e o problemă în API, nu în Postman. Repetă o dată, apoi raportează bug-ul cu cererea exactă, ora și ID-ul de corelare (requestId) din răspuns, ca dezvoltatorii să găsească eroarea în loguri. Explicația completă → Mediu Repară tu 502 Bad Gateway Un proxy sau un gateway (nginx, load balancer, API gateway) a primit un răspuns invalid sau niciun răspuns de la serverul aplicației. De obicei aplicația din spate e oprită, repornește sau a căzut. Verifică /health și anunță echipa; nu e o problemă a cererii tale. Explicația completă → Mediu Repară tu 503 Service Unavailable Serviciul e temporar indisponibil: în mentenanță, supraîncărcat sau încă pornește după un deploy. Răspunsul poate avea antetul Retry-After. Reîncearcă mai târziu și verifică /health; dacă persistă, anunță echipa. Explicația completă → Mediu Repară tu 504 Gateway Timeout Gateway-ul (nginx, load balancer) a așteptat prea mult după serverul aplicației și a renunțat. Endpointul e prea lent pentru limita gateway-ului: raportează lentoarea, iar pentru operațiile lungi verifică dacă API-ul are o variantă asincronă (202 + job). Explicația completă → Greu Repară tu 500 Internal Server Error la un câmp prea lung (în loc de 422) Serverul cade când primește o valoare mai lungă decât acceptă baza de date, în loc să o valideze și să răspundă 422. E un bug de validare: raportează-l cu lungimea exactă care îl declanșează și cu răspunsul așteptat (422 cu detalii pe câmp). Explicația completă → Autentificare și tokenuri
401 Unauthorized: jwt expired Tokenul JWT a trecut de momentul de expirare (claim-ul exp), deci serverul nu-l mai acceptă. Fă din nou login (sau folosește refresh token-ul) și salvează tokenul nou; ca să nu se mai întâmple, reîmprospătează-l automat într-un pre-request al colecției. Explicația completă → Mediu Repară tu JsonWebTokenError: jwt malformed Ce ai trimis ca token nu are forma unui JWT (trei părți separate prin puncte): de obicei ai salvat tot răspunsul de la login în loc de câmpul token, ai copiat tokenul trunchiat sau variabila e goală. Salvează exact câmpul cu tokenul. Explicația completă → Mediu Repară tu JsonWebTokenError: invalid signature Tokenul are forma corectă, dar semnătura nu se potrivește cu cheia serverului: a fost emis de alt mediu (Staging în loc de Dev), cheia s-a schimbat sau cineva a modificat payload-ul. Obține un token nou chiar de la serverul pe care îl testezi. Explicația completă → Ușor Repară tu Missing Authorization Header Cererea nu trimite antetul Authorization, deși endpointul îl cere: de obicei cererea are No Auth în loc de Inherit auth from parent, sau tokenul colecției e gol. Setează autentificarea cererii pe Inherit (sau Bearer {{token}}) și verifică antetul în Console. Explicația completă → Ușor Repară tu 401 Unauthorized: Antetul Authorization trebuie să fie de forma Bearer <token> Ai pus tokenul direct în antetul Authorization, fără cuvântul Bearer în față, așa că serverul nu recunoaște schema. Folosește tabul Authorization cu tipul Bearer Token (care adaugă prefixul) sau scrie antetul complet: Authorization: Bearer {{token}}. Explicația completă → Ușor Repară tu No API key found in request Endpointul cere o cheie API, dar cererea nu o conține (în antetul sau parametrul așteptat). Adaugă cheia din tabul Authorization → API Key, cu numele exact din documentație (de exemplu x-api-key) și locul corect (antet sau query). Explicația completă → Mediu Repară tu Invalid authentication credentials Cheia API (sau credențialele) e prezentă, dar serverul nu o recunoaște: e greșită, expirată, revocată sau aparține altui mediu. Verifică valoarea exactă din environment (spații, caractere lipsă) și cere o cheie validă pentru mediul curent. Explicația completă → Ușor Repară tu 401 Unauthorized cu WWW-Authenticate: Basic Serverul cere autentificare Basic (utilizator și parolă), iar cererea nu o trimite sau credențialele sunt greșite. Antetul WWW-Authenticate: Basic realm=... îți spune schema. Alege Basic Auth în tabul Authorization și completează utilizatorul și parola. Explicația completă → Mediu Repară tu {"error": "invalid_grant"} Serverul OAuth a respins credențialele sau codul trimis la endpointul de token: utilizator ori parolă greșite (password grant), cod de autorizare expirat sau deja folosit, refresh token revocat. Verifică valorile trimise în body și obține un cod sau un token nou. Explicația completă → Mediu Repară tu {"error": "unsupported_grant_type"} Endpointul de token nu recunoaște valoarea grant_type trimisă: e scrisă greșit, lipsește sau body-ul nu e x-www-form-urlencoded (serverul nu poate citi câmpurile din JSON). Trimite grant_type exact (password, client_credentials, authorization_code, refresh_token) ca form-urlencoded. Explicația completă → Ușor Repară tu 401 după login: tokenul a fost salvat cu ghilimele Tokenul din variabilă are ghilimele în jur (de exemplu salvat cu JSON.stringify sau copiat din body), deci antetul pleacă Bearer "eyJ..." și serverul îl respinge. Salvează valoarea direct, fără JSON.stringify și fără ghilimele. Explicația completă → JSON și body: erori de parsare
JSONError: Unexpected token '<' at 1:1 pm.response.json() a încercat să parseze ca JSON un răspuns care începe cu „<”, adică o pagină HTML (o eroare 404/500 a serverului, o pagină de login, un proxy). Uită-te la body în Raw sau Preview și la Content-Type, apoi repară cererea sau verifică statusul înainte să parsezi. Explicația completă → Ușor Repară tu SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON JSON.parse a primit un text HTML (începe cu <!DOCTYPE), nu JSON. Serverul a răspuns cu o pagină, nu cu date. Verifică statusul, Content-Type și URL-ul; în scripturi folosește pm.response.json() doar după ce ai confirmat că răspunsul e JSON. Explicația completă → Mediu Repară tu JSONError: No data, empty input at 1:1 Scriptul apelează pm.response.json() pe un răspuns fără body, de obicei 204 No Content (după DELETE sau PUT) sau un răspuns de eroare gol. Verifică statusul și citește JSON-ul doar când există body; pentru 204, testează că body-ul e gol. Explicația completă → Mediu Repară tu SyntaxError: "undefined" is not valid JSON JSON.parse a primit undefined, de obicei pentru că variabila citită cu pm.environment.get sau pm.collectionVariables.get nu există (alt nume, alt scope, cererea care o setează nu a rulat). Verifică variabila înainte de parsare și asigură-te că a fost salvată cu JSON.stringify. Explicația completă → Mediu Repară tu SyntaxError: "[object Object]" is not valid JSON JSON.parse a primit un obiect, nu un text JSON: de obicei rezultatul lui pm.response.json(), care e deja parsat, sau o variabilă salvată fără JSON.stringify. Nu parsa de două ori; salvează obiectele în variabile cu JSON.stringify și citește-le cu JSON.parse. Explicația completă → Mediu Repară tu SyntaxError: Unexpected end of JSON input JSON.parse a primit un text gol sau tăiat (de exemplu o variabilă goală sau un body incomplet). Verifică ce text parsezi: o variabilă setată cu "" sau un răspuns fără conținut. Pune o valoare implicită sau verifică textul înainte de parsare. Explicația completă → Mediu Repară tu Răspunsul e HTML în loc de JSON (Content-Type: text/html) Endpointul unui API JSON a întors o pagină HTML (des la erori 404 sau 500), deci clienții nu pot citi eroarea. Dacă URL-ul e corect, e un bug de contract: scrie un test pe Content-Type și raportează-l cu cererea atașată. Explicația completă → Erori în scripturi (Pre-request și Post-response)
There was an error in evaluating the Pre-request Script: ReferenceError: token is not defined Scriptul Pre-request a aruncat o eroare (aici folosește variabila JavaScript token, care nu e declarată), iar Postman nu mai trimite cererea. Citește eroarea de după două puncte, repar-o (de obicei citești valoarea cu pm.environment.get) și trimite din nou. Explicația completă → Ușor Repară tu There was an error in evaluating the Test Script: TypeError: Cannot read properties of undefined (reading 'token') Scriptul de teste (Post-response) a aruncat o eroare, aici pentru că citește .token dintr-un câmp care nu există în răspuns (user în loc de rădăcină). Testele de după linia cu eroarea nu mai rulează. Verifică structura reală a body-ului și calea corectă spre câmp. Explicația completă → Ușor Repară tu ReferenceError: raspuns is not defined Scriptul folosește un nume care nu a fost declarat: o variabilă scrisă greșit, declarată în alt bloc sau în alt script (pre-request vs post-response), ori o funcție dintr-o librărie neîncărcată. Declară variabila înainte (const raspuns = pm.response.json()) sau corectează numele. Explicația completă → Ușor Repară tu TypeError: Cannot read properties of undefined (reading 'id') Scriptul citește .id dintr-o valoare undefined: calea spre câmp e greșită (items în loc de data), lista e goală sau răspunsul e o eroare cu altă structură. Verifică body-ul real și calea, iar pentru liste verifică întâi că au elemente. Explicația completă → Ușor Repară tu TypeError: Cannot read properties of undefined (reading 'get') Ai apelat .get() pe un obiect care nu există, aproape mereu din cauza unei greșeli de tipar în API-ul pm: pm.enviroment, pm.collectionVariable, pm.iterationdata. Corectează numele obiectului (pm.environment, pm.collectionVariables, pm.iterationData). Explicația completă → Mediu Repară tu TypeError: Cannot read properties of null (reading 'json') În callback-ul lui pm.sendRequest, răspunsul e null pentru că cererea a eșuat (URL greșit, variabilă nerezolvată, timeout), iar scriptul face res.json() fără să verifice err. Tratează întâi err și abia apoi citește răspunsul. Explicația completă → Mediu Repară tu TypeError: Cannot read properties of undefined (reading 'json') în Pre-request În scriptul Pre-request nu există încă un răspuns: cererea nu a plecat. pm.response e undefined, deci pm.response.json() aruncă eroarea, iar cererea nu se mai trimite. Mută codul care citește răspunsul în Post-response. Explicația completă → Mediu Repară tu TypeError: j.forEach is not a function Ai apelat forEach pe ceva care nu e listă: de obicei pe tot obiectul răspunsului ({data: [...]}) în loc de lista din el. Parcurge câmpul cu lista (j.data.forEach) sau, pentru obiecte, Object.keys(j).forEach. Explicația completă → Ușor Repară tu TypeError: pm.setEnvironmentVariable is not a function Ai amestecat sintaxa veche (postman.setEnvironmentVariable) cu cea nouă (pm.*): obiectul pm nu are metoda setEnvironmentVariable. Folosește pm.environment.set("nume", valoare). Explicația completă → Ușor Repară tu TypeError: Assignment to constant variable. Ai declarat o variabilă cu const și apoi i-ai dat altă valoare. Folosește let pentru valorile care se schimbă (contoare, totaluri, încercări) și păstrează const pentru cele fixe. Explicația completă → Mediu Repară tu TypeError: Cannot convert undefined or null to object Ai dat undefined sau null unei funcții care așteaptă un obiect, cel mai des Object.keys(), Object.entries() sau Object.assign(), pentru că un câmp din răspuns lipsește sau e null. Verifică ce câmp citești și dacă există. Explicația completă → Ușor Repară tu SyntaxError: Invalid or unexpected token Scriptul conține un caracter pe care JavaScript nu-l acceptă, de obicei ghilimele „curbe” (“ ” sau „ ”) copiate din Word, Slack sau dintr-un articol, ori un caracter invizibil. Rescrie ghilimelele ca " simple, drepte. Explicația completă → Ușor Repară tu SyntaxError: Unexpected end of input Scriptul se termină înainte să fie închise toate parantezele sau acoladele: de obicei lipsește }); de la finalul unui pm.test. Numără perechile de { } și ( ) sau folosește Beautify ca să vezi structura. Explicația completă → Ușor Repară tu SyntaxError: missing ) after argument list JavaScript aștepta o paranteză ) care să închidă argumentele unui apel și a găsit altceva: o virgulă lipsă între argumente, o acoladă închisă fără paranteza lui pm.test sau ghilimele neînchise. Verifică apelul de pe linia indicată. Explicația completă → Mediu Repară tu Error: Cannot find module 'axios' Sandbox-ul Postman nu are acces la npm, deci require poate încărca doar librăriile incluse (lodash, crypto-js, moment, ajv, cheerio, uuid etc.). Pentru cereri HTTP din script folosește pm.sendRequest în loc de axios sau fetch. Explicația completă → Ușor Repară tu postman.setEnvironmentVariable is deprecated Folosești API-ul vechi de scripting (postman.setEnvironmentVariable, tests[...], responseBody). Încă funcționează, dar e depreciat și editorul îl marchează. Rescrie cu API-ul pm: pm.environment.set, pm.test, pm.response.json(). Explicația completă → Mediu Repară tu ReferenceError: environment is not defined Scriptul folosește obiectul global environment (sau globals, data) din sintaxa veche, care nu mai e disponibil în sandbox-ul actual. Citește valorile cu pm.environment.get("nume"), pm.globals.get sau pm.iterationData.get. Explicația completă → Teste care pică: AssertionError
AssertionError: expected response to have status code 200 but got 201 Testul cere statusul 200, dar serverul a răspuns 201 Created. Pentru o creare reușită, 201 e răspunsul corect, deci testul greșește: verifică statusul pe care îl promite documentația endpoint-ului. Explicația completă → Ușor Repară tu AssertionError: expected 404 to equal 200 Testul compară pm.response.code cu 200, dar răspunsul a fost 404. Fie cererea cere o resursă care nu există (id, cale greșită), fie e un test negativ care trebuie să aștepte chiar 404. Explicația completă → Ușor Repară tu AssertionError: expected 7 to equal '7' Compari un număr din răspuns (7) cu un text ('7'). Variabilele Postman sunt stocate ca text, iar equal folosește comparație strictă (===). Transformă valoarea cu Number(...) sau compară texte. Explicația completă → Mediu Repară tu AssertionError: expected { id: 7, currency: 'RON' } to equal { id: 7, currency: 'RON' } Mesajul pare absurd: obiectele arată la fel. equal compară însă identitatea (===), adică dacă e același obiect în memorie, nu conținutul. Pentru obiecte și liste folosește eql (sau deep.equal), care compară conținutul. Explicația completă → Ușor Repară tu AssertionError: expected undefined to equal 'Mouse wireless' Câmpul pe care îl citești din răspuns nu există, deci valoarea e undefined. De obicei numele câmpului e scris greșit (nume în loc de name) sau e la alt nivel în JSON. Compară calea din test cu body-ul din Pretty. Explicația completă → Ușor Repară tu AssertionError: expected [ Array(5) ] to have a length of 10 but got 5 Lista din răspuns are alt număr de elemente decât așteaptă testul. Verifică parametrii cererii (limit, page, filtre) și dacă numărul fix din test mai e corect; de multe ori e mai robust să compari cu limit-ul trimis. Explicația completă → Mediu Repară tu AssertionError: expected { Object (id, name, ...) } to have property 'pret' Obiectul verificat nu are câmpul cerut de test. Fie testul folosește un nume greșit (pret în loc de price), fie verifici alt obiect decât crezi (lista în loc de primul element), fie API-ul a scos câmpul. Explicația completă → Ușor Repară tu AssertionError: expected 3499 to be below 1000 Testul verifică o limită (preț sub 1000), dar răspunsul conține valori peste ea. Înainte să raportezi un bug de filtrare, verifică dacă filtrul a fost trimis corect: un parametru scris greșit (max_price în loc de maxPrice) e ignorat de server. Explicația completă → Mediu Repară tu AssertionError: expected data to satisfy schema but found following errors: data.price should be string Răspunsul nu respectă schema JSON din test. Lista de după „found following errors” spune exact ce câmp și ce regulă a picat (aici: price nu e text). Corectează schema dacă ea greșește, sau raportează abaterea dacă API-ul încalcă contractul. Explicația completă → Ușor Repară tu AssertionError: expected 'application/json; charset=utf-8' to equal 'application/json' Antetul Content-Type conține și setul de caractere (; charset=utf-8), deci nu e egal cu „application/json”. Verifică doar că include application/json, nu egalitatea exactă. Explicația completă → Mediu Repară tu AssertionError: expected 201 to be one of [ 200, 204 ] Codul primit nu e în lista de valori acceptate de test. oneOf e util când contractul permite mai multe răspunsuri, dar lista trebuie să conțină exact valorile documentate; aici lipsește 201. Explicația completă → Mediu Repară tu There was an error in evaluating the Post-response Script: AssertionError: expected '13' to equal '30' Un pm.expect scris direct în script, nu în interiorul unui pm.test, nu devine test roșu: aruncă eroare și oprește tot scriptul, deci testele de după nu mai rulează. Pune fiecare aserțiune într-un pm.test. Explicația completă → Mediu Repară tu Testul trece mereu: pm.expect fără aserțiune pm.expect(conditie) fără .to.be.true, .to.equal sau altă aserțiune nu verifică nimic, deci testul e verde orice ar răspunde API-ul. Completează aserțiunea și verifică-l o dată pe un caz care trebuie să pice. Explicația completă → Ușor Repară tu Error: Invalid Chai property: equalTo Ai folosit în lanțul de aserțiune un cuvânt pe care Chai nu-l are (equalTo, equals ca proprietate, contains, greaterThanOrEqual...). Folosește numele reale: equal, eql, include, above, at.least, below, at.most. Explicația completă → Ușor Repară tu AssertionError: expected [] not to be empty Lista din răspuns e goală, iar testul cere cel puțin un element. Verifică filtrele trimise (valori inversate, categorie greșită, pagină prea mare) și datele din mediu înainte să concluzionezi că API-ul nu găsește nimic. Explicația completă → Ușor Repară tu AssertionError: expected 'Mouse wireless' to include 'mouse' include pe texte ține cont de literele mari și mici: „Mouse” nu conține „mouse”. Pentru căutări care ignoră majusculele, compară textul convertit cu toLowerCase(). Explicația completă → Ușor Repară tu AssertionError: expected undefined to exist Valoarea verificată cu to.exist e undefined: câmpul nu există în răspuns sau variabila nu a fost salvată. Compară numele câmpului din test cu body-ul (de ex. token, nu accessToken) și verifică statusul cererii. Explicația completă → Ușor Repară tu AssertionError: expected 89 to be a string Testul de tip așteaptă text, dar câmpul e număr. Verifică tipul din documentație: dacă prețul e număr, corectează testul cu to.be.a("number"); dacă trebuia text, e o abatere de contract. Explicația completă → Ușor Repară tu AssertionError: expected 'Produsul 31 nu există.' to deeply equal 'Produsul nu există' Testul compară mesajul de eroare cu un text exact care diferă (id-ul inclus, punct la final). Mesajele pentru oameni se schimbă ușor; verifică mai degrabă codul de eroare (error: not_found) și, eventual, că mesajul include o parte stabilă. Explicația completă → Ușor Repară tu AssertionError: expected response to have header with key 'X-Total-Items' Răspunsul nu are antetul pe care îl cere testul. Verifică în tabul Headers numele exact (aici API-ul folosește X-Total-Count) și dacă endpoint-ul chiar trimite acel antet (listele da, un singur produs nu). Explicația completă → Mediu Repară tu AssertionError: expected 1223 to be below 1000 Răspunsul a durat mai mult decât limita din test. Pentru un endpoint lent prin natura lui (rapoarte, exporturi), pragul trebuie să fie realist și documentat; dacă endpoint-ul ar trebui să fie rapid, e o problemă de performanță de raportat. Explicația completă → Ușor Repară tu AssertionError: expected undefined to be an array Testul verifică o listă dintr-un câmp care nu există. Lista e în alt câmp (de ex. data, nu items sau products) sau răspunsul e o eroare. Citește structura body-ului și folosește numele corect. Explicația completă → Collection Runner și fișiere de date
401 Unauthorized în Collection Runner, deși cererea merge la Send În Runner, cererile rulează în ordinea din colecție. Dacă o cerere protejată vine înaintea Login-ului, pleacă fără token și primește 401; la Send manual mergea pentru că tokenul era deja salvat de o rulare anterioară. Pune Login primul sau obține tokenul într-un script de colecție. Explicația completă → Ușor Repară tu {{email}} nerezolvat în Runner: coloana din CSV are alt nume Valorile din fișierul de date devin variabile cu numele exact al coloanelor din prima linie. Dacă CSV-ul are coloana mail, dar body-ul folosește {{email}}, variabila nu se rezolvă și se trimite textul {{email}}. Potrivește numele coloanei cu variabila. Explicația completă → Mediu Repară tu Fișierul JSON de date nu e o listă de obiecte Runner-ul și Newman acceptă ca fișier de date JSON doar o listă de obiecte: [ {...}, {...} ]. Un obiect cu lista în interior ({"produse": [...]}) nu e acceptat. Scoate lista la rădăcina fișierului. Explicația completă → Ușor Repară tu pm.execution.setNextRequest nu are efect la Send setNextRequest schimbă doar ordinea dintr-o rulare de colecție (Collection Runner, Newman, monitor). La Send manual nu există o „cerere următoare”, deci instrucțiunea e ignorată, fără eroare. Ca să vezi efectul, rulează colecția. Explicația completă → Mediu Repară tu setNextRequest: rularea se oprește, cererea cu acel nume nu există Numele dat lui setNextRequest trebuie să fie exact numele cererii, cu diacritice, spații și majuscule. Dacă nu există nicio cerere cu acel nume, rularea se oprește după cererea curentă, fără eroare evidentă. Copiază numele din sidebar sau folosește id-ul cererii. Explicația completă → Greu Repară tu Runner-ul nu se mai oprește: setNextRequest în buclă Scriptul trimite mereu Runner-ul înapoi la aceeași cerere, fără o condiție de oprire. Adaugă condiția (de ex. page < totalPages), oprește explicit cu setNextRequest(null) și resetează variabilele folosite ca contor. Explicația completă → Mediu Repară tu 429 Too Many Requests în Collection Runner fără delay Runner-ul trimite cererile una după alta, fără pauză, și depășește limita de rate a API-ului (aici 10 căutări pe minut). Pune un delay între cereri (câmpul Delay din Runner, --delay-request în Newman) calculat după limită și antetul Retry-After. Explicația completă → Greu Repară tu Iterația 2 pică din cauza unei variabile rămase din iterația 1 Environment-ul nu se golește între iterații: o valoare salvată la iterația 1 (de ex. tokenul) rămâne și la iterația 2. Dacă iterația 2 trebuia să ruleze fără ea, rezultatul e greșit. Șterge (unset) variabilele la începutul fiecărei iterații sau salvează-le doar când e cazul. Explicația completă → Newman, CI și mock servers
zsh: command not found: newman Shell-ul nu găsește programul newman: nu e instalat global sau folderul global npm nu e în PATH (ori ai scris greșit comanda). Instalează-l cu npm install -g newman sau rulează-l cu npx newman. Explicația completă → Ușor Repară tu error: collection could not be loaded Newman nu găsește sau nu poate citi fișierul colecției: calea e greșită, numele diferă (spații, majuscule) sau colecția nu a fost exportată. Verifică cu ls ce fișiere ai și folosește exact numele lor. Explicația completă → Ușor Repară tu error: could not load environment Newman nu găsește fișierul de environment dat cu -e: nu a fost exportat, numele e greșit sau calea e relativă la alt folder. Exportă environment-ul și folosește exact numele fișierului. Explicația completă → Ușor Repară tu error: unknown option '--enviroment' Newman nu recunoaște o opțiune din comandă: de obicei e scrisă greșit (--enviroment în loc de --environment) sau vine din altă unealtă. Verifică lista cu newman run -h și folosește forma scurtă -e. Explicația completă → Mediu Repară tu Newman: getaddrinfo ENOTFOUND {{baseurl}} (lipsește -e) Newman a rulat colecția fără environment, deci {{baseUrl}} nu s-a rezolvat și a fost folosit ca nume de server. Adaugă -e cu environment-ul exportat (sau --env-var "baseUrl=..."). Explicația completă → Mediu Repară tu Newman se termină cu exit code 1 Exit code 1 înseamnă că rularea a avut cel puțin un test picat sau o eroare (cerere eșuată, script cu eroare). Citește tabelul de la final și lista „# failure”, repară cauza în colecție, reexportă și rulează din nou. Explicația completă → Mediu Repară tu Process completed with exit code 1. Mesajul vine de la GitHub Actions: o comandă din pas (aici newman run) a ieșit cu 1. Cauza e în log-ul pasului, mai sus. Frecvent, în CI lipsește o variabilă secretă care local exista în environment; dă-o cu --env-var din secretele pipeline-ului. Explicația completă → Mediu Repară tu newman: could not find "htmlextra" reporter Reporterii externi (htmlextra, allure) sunt pachete npm separate și trebuie instalați în același loc cu Newman. Instalează-i (npm install -g newman-reporter-htmlextra) sau folosește reporterii incluși: cli, json, junit. Explicația completă → Mediu Repară tu error: iteration data could not be loaded Newman nu poate citi fișierul dat cu -d: numele sau calea e greșită, ori conținutul nu e un CSV sau o listă JSON validă. Verifică numele cu ls și formatul fișierului. Explicația completă → Ușor Repară tu error: Unable to find a folder or request: produse Numele dat lui --folder nu corespunde niciunui folder din colecție. Potrivirea e exactă (majuscule, diacritice, spații). Copiază numele folderului din Postman. Explicația completă → Ușor Repară tu error: missing required argument 'collection' newman run are nevoie, imediat după run, de fișierul (sau URL-ul) colecției. Dacă începi direct cu opțiuni (-e, -d), Newman nu are ce rula. Pune colecția ca prim argument. Explicația completă → Mediu Repară tu mockRequestNotFoundError: Double check your method and the request path and try again. Mock server-ul nu are un exemplu salvat care să se potrivească cu metoda și calea cererii. Verifică metoda (GET vs POST) și calea exactă din exemplu, sau adaugă un exemplu pentru noua combinație. Explicația completă → Nicio eroare nu se potrivește căutării. Încearcă doar partea fixă a mesajului (fără numele variabilelor).
Erori explicate la alte tehnologii
Î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.
