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).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În Postman pentru web, cererile nu pleacă din browserul tău, ci printr-un agent:
- Cloud Agent: cererea pleacă de pe serverele Postman. Ajunge doar la adrese publice.
localhostpentru el înseamnă propriul server, deci Postman blochează explicit cererea; - Browser Agent: cererea pleacă din browser, cu limitările lui (CORS);
- Desktop Agent: o aplicație mică instalată pe calculator, care trimite cererea local. Ajunge la localhost și la rețeaua internă.
Agentul se alege din colțul din dreapta-jos al Postman web. Pentru API-uri locale sau din rețeaua firmei, ai nevoie de Desktop Agent sau de aplicația desktop.
Alternativa, când API-ul local nu e gata: un mock server Postman, care are adresă publică.
De ce apare: cauzele frecvente
1Cloud Agent cu localhost
Agent: Cloud
GET http://localhost:3000/productsAgent: Desktop (sau aplicația Postman Desktop)
GET http://localhost:3000/productsDesktop Agent rulează pe calculatorul tău, deci vede localhost.
2API-ul nu e încă disponibil
GET http://localhost:3000/awb/RO123Mock server din exemple
GET {{mockUrl}}/awb/RO123Mock-ul are o adresă publică, accesibilă de orice agent.
Repară eroarea, direct în pagină
Serviciul de curierat rulează doar pe localhost-ul unui coleg, inaccesibil de aici (în Postman web cu Cloud Agent ai primi „Can't send requests to localhost”). Colecția „Curier” are deja un exemplu de răspuns salvat. Creează un mock server din colecție, cu URL-ul în variabila mockUrl, și trimite GET {{mockUrl}}/awb/RO123: trebuie să primești 200.
Indiciu
Mock server-ul se creează din meniul colecției; alege variabila mockUrl pentru adresă.
Reparația
1. Meniul colecției Curier → Mock collection, cu URL-ul salvat în variabila mockUrl. 2. Cerere nouă, salvată în colecția Curier (variabila mockUrl e a colecției):
GET {{mockUrl}}/awb/RO123De ce merge
Mock server-ul are o adresă publică și răspunde cu exemplul salvat, deci poți lucra fără serverul de pe calculatorul colegului și fără Desktop Agent. Pentru API-uri locale reale, soluția rămâne Desktop Agent sau aplicația desktop. Agentul cloud trimite cererile de pe serverele Postman, care nu pot ajunge la calculatorul tău. Mock server-ul are o adresă publică, așa că orice agent îl poate apela și primește răspunsul din exemplu.
Alte forme ale mesajului
Cloud Agent Error: Can't send requests to private IP addresses
Cum o eviți pe viitor
- Pentru lucru local, folosește aplicația desktop sau Desktop Agent.
- Verifică agentul activ când cererile spre rețeaua internă eșuează doar în Postman web.
- Pentru demo-uri și colegi fără acces la serverul tău, folosește un mock server.
- Pentru localhost folosește aplicația desktop sau Desktop Agent; pentru colaborare, un mock server sau un mediu public de test.
Întrebări frecvente
De ce nu merge nici cu 127.0.0.1?
Pentru Cloud Agent, orice adresă locală sau privată e inaccesibilă, indiferent cum o scrii.
Desktop Agent e sigur?
E o aplicație oficială Postman care trimite cererile de pe calculatorul tău, exact ca aplicația desktop.
Erori înrudite
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ă. 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. 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. Î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.
