...
Eroare n8n · HTTP Request și API-uri

getaddrinfo ENOTFOUND api.exmplu.ro

Pe scurt

n8n nu a găsit serverul: numele de domeniu din URL nu există sau nu poate fi rezolvat prin DNS (greșeală de scriere, subdomeniu greșit, adresă internă inaccesibilă din n8n). Verifică URL-ul literă cu literă; pentru adrese interne, asigură-te că n8n le poate accesa.

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

Ce înseamnă

getaddrinfo ENOTFOUND <domeniu> vine din Node.js, înainte ca cererea să plece: n8n a întrebat DNS-ul ce adresă IP are domeniul și nu a primit răspuns. Uneori n8n îl prezintă ca „The DNS server returned an error, perhaps the server is offline”.

Cauze frecvente: o literă greșită în domeniu (exmplu în loc de exemplu), lipsa unui subdomeniu (exemplu.ro în loc de api.exemplu.ro), spații sau caractere invizibile copiate în URL, un domeniu intern (erp.firma.local) pe care serverul n8n nu îl vede (de exemplu n8n Cloud nu ajunge în rețeaua firmei), sau o problemă de DNS în containerul Docker.

Cum verifici: copiază domeniul din detaliile erorii și deschide-l în browser sau rulează nslookup api.exemplu.ro de pe serverul n8n. Dacă domeniul e corect și merge de pe calculatorul tău, problema e accesul rețelei serverului n8n.

De ce apare: cauzele frecvente

1Literă greșită în domeniu

Greșit
JSON
https://api.exmplu.ro/clienti
Corect
JSON
https://api.exemplu.ro/clienti

Un domeniu scris greșit nu există în DNS.

2Lipsește subdomeniul

Greșit
JSON
https://exemplu.ro/clienti
Corect
JSON
https://api.exemplu.ro/clienti

API-ul e pe subdomeniul api; domeniul principal e alt server (sau nu are API).

3Server intern, n8n în cloud

Greșit
JSON
http://erp.firma.local/api/facturi   (din n8n Cloud)
Corect
JSON
Expune API-ul printr-o adresă publică securizată sau rulează n8n self-hosted în rețeaua firmei

Un server din cloud nu poate rezolva nume din rețeaua locală a firmei.

Repară tu

Repară eroarea, direct în pagină

Nodul Produse se oprește cu „getaddrinfo ENOTFOUND api.exmplu.ro” (în simulator: „Adresa nu poate fi accesată (ENOTFOUND api.exmplu.ro)”). Corectează domeniul din URL (API-ul demo este pe api.exemplu.ro) și rulează: nodul trebuie să dea cele 6 produse.

Indiciu

Compară literă cu literă domeniul din URL cu cel din tabul Aplicații → API-uri.

Alte forme ale mesajului

  • getaddrinfo ENOTFOUND
  • The DNS server returned an error, perhaps the server is offline
  • getaddrinfo EAI_AGAIN api.exemplu.ro

Cum o eviți pe viitor

  • Copiază URL-urile din documentație, nu le rescrie.
  • Ține adresa de bază a API-ului într-un singur loc (de exemplu un nod de setări) și construiește restul din ea.
  • Pentru servicii interne, verifică de la început unde rulează n8n și ce rețea vede.
  • EAI_AGAIN înseamnă o problemă temporară de DNS: Retry On Fail ajută.

Întrebări frecvente

Care e diferența dintre ENOTFOUND și ECONNREFUSED?

ENOTFOUND: domeniul nu a fost găsit (problemă de nume/DNS). ECONNREFUSED: adresa a fost găsită, dar nimic nu ascultă pe portul respectiv.

În Docker merge google.ro, dar nu serverul firmei. De ce?

Containerul folosește DNS-ul configurat pentru Docker, care poate să nu cunoască domeniile interne. Configurează DNS-ul containerului sau folosește adresa IP.

Erori înrudite

← Toate erorile n8n

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ță n8n de la zero, cu exerciții la fiecare lecție

Curs Automatizări AI cu n8n: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.