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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
getaddrinfo e funcția care transformă un nume (api.magazin.test) într-o adresă IP. ENOTFOUND înseamnă că DNS-ul a răspuns: „nu există un astfel de nume”. Cererea nu a plecat spre niciun server.
Ce urmează după ENOTFOUND e exact numele căutat, deci îl compari literă cu literă cu cel corect. Cauze frecvente:
- o greșeală de tipar în host (
magaznîn loc demagazin); - valoarea greșită în environment, folosită de toate cererile;
- un domeniu intern, care se rezolvă doar în rețeaua firmei sau prin VPN;
- o variabilă nerezolvată, caz în care vezi
ENOTFOUND {{baseurl}}(pagină separată).
Console îți arată URL-ul final, după înlocuirea variabilelor.
De ce apare: cauzele frecvente
1Greșeală de tipar în environment
baseUrl = https://api.magazn.testbaseUrl = https://api.magazin.testToate cererile cu {{baseUrl}} pleacă spre numele greșit; repari o singură dată, în environment.
2Domeniu intern fără VPN
GET https://api.intern.firma.local/products# conectează VPN-ul, apoi:
GET https://api.intern.firma.local/productsNumele interne există doar în DNS-ul rețelei firmei.
3Calea pusă în host
GET https://api.magazin.test.productsGET https://api.magazin.test/productsUn punct în loc de bară face din cale o parte a numelui de domeniu.
Repară eroarea, direct în pagină
Toate cererile dau Error: getaddrinfo ENOTFOUND api.magazn.test. Cauza e în environment-ul „Dev”: valoarea lui baseUrl are o literă lipsă. Corecteaz-o în https://api.magazin.test, apoi trimite din nou „Listă produse”: trebuie să primești 200.
Indiciu
Deschide environment-ul Dev din bara laterală și compară hostul literă cu literă.
Reparația
În environment-ul Dev, baseUrl devine:
https://api.magazin.testSalvează environment-ul și trimite din nou cererea.
De ce merge
DNS-ul nu cunoaște numele api.magazn.test, deci cererea nu are unde să plece. Valoarea corectă se rezolvă, iar pentru că toate cererile folosesc {{baseUrl}}, reparația dintr-un singur loc le repară pe toate. ENOTFOUND apare înainte de orice conexiune: numele serverului nu a putut fi transformat într-o adresă IP. După ce hostul e corect, DNS-ul găsește serverul, iar cererea ajunge la API și primește un status real.
Alte forme ale mesajului
Error: getaddrinfo ENOTFOUND localhostError: getaddrinfo ENOTFOUND api.example.com
Cum o eviți pe viitor
- Copiază adresa din documentație sau din environment, nu o rescrie.
- Ține hostul într-un singur loc (
baseUrl) ca să nu repari aceeași greșeală în 20 de cereri. - Pentru domenii interne, verifică VPN-ul înainte de a căuta alte cauze.
- Uită-te în Console la URL-ul care a plecat efectiv.
Întrebări frecvente
Cum verific dacă numele există?
Din terminal: nslookup api.magazin.test sau ping api.magazin.test. Dacă nici acolo nu se rezolvă, problema nu e în Postman.
De ce merge la colegul meu?
El poate avea VPN-ul conectat, alt DNS sau alt environment selectat, cu o valoare corectă.
Erori înrudite
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. 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. 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. Î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.
