Apidog Docs
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇪🇸 Español
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. Corrección de errores de petición
  • Back to home
  • Centro de soporte
  • Centro de soporte de Apidog
  • Importar/exportar
    • ¿Cómo importar datos de API en Apidog?
    • ¿Cómo importar cURL en Apidog?
    • ¿Cómo migrar entornos de Postman a Apidog?
    • ¿Cómo agrupar endpoints automáticamente al importar Swagger/OpenAPI?
  • Envío de peticiones
    • ¿Admite Apidog Socket.IO?
    • ¿Por qué el signo "+" en el valor del parámetro se decodifica como un espacio?
    • ¿Cómo enviar una petición en Apidog?
    • ¿Cómo enviar una petición GraphQL en Apidog?
    • ¿Cómo enviar una petición gRPC en Apidog?
    • ¿Cómo enviar una petición SOAP/WebService en Apidog?
    • ¿Cómo enviar una petición WebSocket en Apidog?
    • ¿Admite Apidog scripts previos a la petición/scripts de prueba y aserciones en las API WebSocket?
    • ¿Cómo enviar una petición SSE en Apidog?
    • ¿Cómo añadir encabezados predeterminados a nivel de carpeta?
    • ¿Admite Apidog scripts de pre-petición/prueba y aserciones en las API gRPC?
    • Error del resolvedor DNS ELANREFUSED.DNS
    • ¿Por qué recibo un error "socket hang up" al enviar una petición?
    • Corrección de errores de petición
      • Corrección del error read ECONNRESET
      • Corrección del error ECONNREFUSED
      • Corrección del error ETIMEDOUT
      • Solución del error ENOTFOUND: Couldn't resolve host
      • Corrección de ENOTFOUND: error getaddrinfo ENOTFOUND www
      • Solución del error connect EHOSTUNREACH
  • Diseño de APIs
    • ¿Cómo uso variables en la ruta?
    • ¿Puedo usar un componente de respuesta como respuesta predeterminada?
    • ¿Cómo comprobar quién ha modificado un endpoint?
    • ¿Cómo puedo eliminar carpetas de endpoints de forma masiva en Apidog?
    • ¿Cómo puedo agregar o eliminar prefijos de forma masiva en la ruta de los endpoints?
    • ¿Cómo mover el nivel de una propiedad en el Editor de esquemas?
    • Si una propiedad de cadena tiene varios valores enumerados y se utiliza en varias ubicaciones, ¿cómo se puede referenciar este enum de forma coherente en todas ellas?
    • ¿Cómo obtener el ID de la carpeta de recursos de Apidog?
    • ¿Cómo obtengo el ID de la carpeta de recursos de Apidog?
    • ¿Cómo uso variables en una ruta de URL?
    • ¿Qué debo hacer si un endpoint, documento o escenario de prueba se elimina accidentalmente?
    • ¿Apidog admite código de petición para endpoints personalizados?
    • ¿Cómo agrupar automáticamente endpoints al importar Swagger/OpenAPI en Apidog?
    • ¿Cómo genero datos de matriz no duplicados en respuestas mock?
    • ¿Por qué no se admite la entrada "#" en la ruta?
  • Depuración de APIs
    • ¿Cómo se integra Apidog con sistemas de gestión de claves de terceros?
    • ¿Por qué la misma petición funciona correctamente en otras herramientas (como Postman) pero no en Apidog?
    • ¿Cómo obtener valores de variables desde una base de datos en Apidog?
    • ¿Cómo migrar entornos desde otras herramientas a Apidog?
    • ¿Cómo realizar aserciones usando scripts en Apidog?
    • JSONPath solo puede extraer arrays. ¿Cómo puede extraer un solo elemento de ellos en Apidog?
    • ¿Cómo configurar operaciones de base de datos en Apidog cuando diferentes entornos tienen distintas credenciales de cuenta de base de datos?
    • ¿Cómo obtener la URL base del servicio en un script personalizado?
    • ¿Por qué Apidog informa un error que supera la longitud máxima de cadena de Node.js cuando la respuesta de la API es demasiado grande?
    • ¿Cuál es el límite de tamaño para la impresión en consola? ¿Por qué aparece un error al imprimir archivos grandes?
    • ¿Cómo resolver errores de conexión a la base de datos DB2 en Windows?
    • ¿Por qué aparece el error NJS-045 al conectarme a una base de datos Oracle en Apidog?
    • ¿Cómo generar valores dinámicos en scripts personalizados de Apidog?
    • ¿Por qué la petición del cliente al mismo endpoint se realiza correctamente, pero se produce un error al depurar en el lado web: "No se puede solicitar la dirección"?
    • ¿Por qué Apidog informa un error cuando la respuesta es demasiado grande?
    • ¿Cómo utilizo el endpoint de registro de Apidog?
    • Al definir la respuesta de un endpoint, ¿se permite que el endpoint no tenga contenido de respuesta?
    • ¿Cómo obtengo la baseURL del servicio en un script personalizado?
    • ¿Cómo puedo ver el paquete original en Apidog?
    • ¿Por qué veo el error "Invalid URI xxx" al realizar una petición?
    • ¿Cómo realizo una petición asíncrona en un script de Apidog?
    • ¿Por qué veo el mensaje "Couldn't resolve host" al enviar una petición?
    • ¿Cuál es el límite de tamaño de impresión de la consola? ¿Por qué aparece un error cuando imprimo un archivo grande?
    • ¿Cómo puedo cargar un archivo en una petición de endpoint?
    • ¿Qué hacer si Apidog se bloquea o los datos de respuesta no se muestran?
    • URI de redirección oficial utilizada por Apidog para OAuth2.0
  • Datos de API mock
    • ¿Cómo hacer mock de APIs automáticamente?
    • ¿Qué puede hacer el mock de Apidog?
    • ¿Cómo simular datos fijos de API en Apidog?
    • ¿Cómo simular datos condicionales en Apidog?
    • ¿Cómo habilitar el mock en la nube en Apidog?
    • ¿Cómo habilitar un mock autoalojado en Apidog?
    • ¿Apidog admite mocks de API WebSocket?
    • ¿Por qué el navegador no devuelve contenido al solicitar el endpoint mock?
  • Pruebas automatizadas
    • ¿Por qué los escenarios de prueba se ejecutan sin problemas en mi cliente local, pero se producen errores al ejecutarlos en Apidog CLI o runner?
    • ¿Cómo crear un escenario de prueba en Apidog?
    • ¿Cómo pasar datos entre pasos de prueba?
    • ¿Por qué no puedo referenciar correctamente los datos del paso previo?
    • ¿Cómo usar el bucle foreach en Apidog?
    • ¿Cuáles son las diferencias entre sincronizar datos desde endpoints/casos de endpoint?
    • ¿Cómo utilizar datos de prueba en Apidog?
    • ¿Cómo recuperar datos de prueba en scripts en Apidog?
    • ¿Cómo ejecutar escenarios de prueba por lotes en Apidog?
    • ¿Cómo programar tareas de prueba en Apidog?
    • ¿Cómo ejecutar una prueba de rendimiento en Apidog?
    • ¿Cómo puedo ver las peticiones y respuestas reales en las pruebas de rendimiento?
    • ¿Cómo puedo exportar informes de pruebas de rendimiento en Apidog?
    • ¿Cómo utilizar los resultados de consultas de base de datos como parámetros para realizar peticiones de API en bucle?
    • Capturar y validar webhooks de Stripe en ApiDog durante CI/CD
    • ¿Cómo resolver el error "Error: unable to verify the first certificate on runner"?
    • Error «Not Found» en el contenedor Docker de General Runner.
    • ¿Cómo configurar el host del servidor para el General Runner en la versión web de Apidog?
    • ¿Por qué el escenario de prueba programado terminó con 0 peticiones?
    • ¿Qué debo hacer si no se puede encontrar el parámetro de carga de archivo en Runner o CLI?
    • ¿Cómo usar Runner para ejecutar un escenario de prueba con un paso de carga de archivo?
    • ¿Cómo resuelvo el error "Error: unable to verify the first certificate on runner"?
    • ¿Cómo accedo y busco en los registros del runner para identificar el problema cuando surge un problema con un runner?
    • ¿Qué debo hacer si el parámetro del endpoint es un archivo de carga y no se puede encontrar en Runner o CLI?
    • ¿Por qué los pasos de prueba no se sincronizan automáticamente cuando cambia el caso de uso de la API?
    • ¿Por qué el uso de varios signos de dólar en un documento Markdown provoca que parte del contenido no se muestre correctamente?
    • ¿El Runner autoalojado genera un informe de prueba en el servidor después de ejecutar una tarea?
    • ¿Puedo añadir pre/postprocesadores unificados a las peticiones en un escenario de prueba?
    • ¿Cómo puedo mantener valores dinámicos coherentes durante una única ejecución de prueba automatizada?
  • Publicar documentación de API
    • ¿Cómo ocultar todos los logotipos de Apidog en los documentos publicados?
    • Cuando se actualiza la especificación de la API, ¿cambiará la documentación de la API?
    • ¿Cómo compartir APIs con colaboradores en Apidog?
    • ¿Cómo personalizar el dominio de la documentación de Apidog?
    • ¿Cómo crear documentación multiversión en Apidog?
    • Alcance de uso compartido para sitios de documentación publicados en Apidog
    • Alcance de uso compartido para la lista Share Doc en Apidog
    • ¿Por qué los Share Docs publicados no muestran el hostname?
    • ¿Cómo pueden los usuarios de la documentación modificar la URL base en documentos compartidos?
    • ¿Puedo duplicar un documento de Apidog publicado para usarlo en mi propio proyecto?
    • ¿Cómo compartir encabezados (por ejemplo, token) en la documentación en línea de Apidog?
    • ¿Por qué mi miembro del equipo no puede encontrar la documentación publicada?
    • ¿Cómo soluciono la expiración de un certificado SSL o un error 526 de Cloudflare en mi dominio personalizado?
    • SMTP personalizado configurado correctamente, pero los usuarios en la lista de permitidos no reciben correos electrónicos con OTP
  • Markdown
    • ¿Cómo usar tarjetas para enlazar a varias páginas o endpoints dentro de Apidog?
    • ¿Por qué algunos contenidos no se muestran correctamente al usar varios símbolos $ en documentos Markdown?
    • ¿Cómo usar imágenes con fondo transparente en Apidog Markdown?
    • ¿Cómo establecer el ancho de columna de una tabla Markdown?
    • ¿Cómo puede insertar APIs internas, documentos, esquemas de datos o carpetas en un documento Markdown?
    • ¿Cómo agrego un enlace a un documento o endpoint dentro de un proyecto en un componente de tarjeta de Apidog?
  • Ramas
    • ¿Cómo acceder a la rama de sprint?
  • Administración
    • ¿Cómo instalar el cliente de Apidog de forma silenciosa?
    • ¿Por qué veo un error de «Sin permiso» a pesar de tener acceso de administrador?
    • ¿Cómo puedo comprobar el número de versión del runner?
    • ¿Apidog es compatible con Windows 7?
    • ¿Por qué Apidog muestra el error "Cannot locate program entry point DiscardVirtualMemory in dynamic link library KERNEL32.dll" después de la instalación?
    • Cambios de suscripción y reembolsos
    • Las peticiones web funcionan, pero la aplicación muestra "read ECONNRESET": ¿por qué?
    • ¿Por qué no puedo abrir Apidog después de una actualización del sistema Windows?
    • Por qué Apidog no se abre después de una actualización del sistema Windows
  • Facturación
    • ¿Puedo configurar una cuenta de facturación separada para mi equipo en Apidog?
    • Problemas de acceso del equipo y facturación en Apidog
    • Los miembros invitados del equipo no pueden acceder a Apidog.
    • Transferir un equipo personal de pago a una organización
  • On-premises
    • Gestión de usuarios y acceso en la versión autohospedada (Enterprise) de Apidog
  • Web y cliente
    • Descarga e instalación de la versión de escritorio para Linux
  1. Corrección de errores de petición

Solución del error ENOTFOUND: Couldn't resolve host

El error ENOTFOUND: Couldn't resolve host indica que el sistema no pudo resolver el nombre de dominio o el nombre de host de su petición a su dirección IP correspondiente. En otras palabras, la búsqueda DNS falló — el primer paso de una petición de red.

Posibles causas#

Este error está relacionado principalmente con el DNS (Sistema de Nombres de Dominio), no con si el servidor de destino está en ejecución.

1. Error tipográfico o dominio mal formado#

Dominio mal escrito: El dominio en la URL de su petición es incorrecto, falta un / o contiene un / adicional, lo que provoca que falle la búsqueda DNS.
Formato de URL no válido: Es posible que a la URL le falte el prefijo de protocolo, como http:// o https://.

2. Problemas con el DNS local o el archivo hosts#

Caché DNS dañada: Su computadora o router puede haber almacenado en caché registros DNS incorrectos.
Entrada incorrecta en el archivo hosts: Su archivo local hosts (utilizado para sobrescribir la resolución DNS) podría contener entradas obsoletas o no válidas para el dominio solicitado.

3. Restricciones de red o firewall#

Red desconectada o inestable: Su dispositivo está sin conexión o tiene una conexión a Internet inestable.
Servidor DNS defectuoso: El servidor DNS configurado en su red (por ejemplo, el DNS del router o del ISP) no funciona correctamente o no es accesible.
Interferencia de VPN/proxy: Una VPN o un proxy mal configurado está bloqueando o alterando las búsquedas DNS normales.
Restricciones de firewall: Su firewall local o software de seguridad puede estar bloqueando las peticiones DNS (normalmente el puerto UDP 53).

Cómo solucionarlo#

Siga estos pasos para diagnosticar y corregir el error ENOTFOUND: Couldn't resolve host.

1. Instale la extensión o use la aplicación de escritorio#

Si utiliza la versión web, instale la extensión del navegador antes de enviar peticiones, o use la aplicación de escritorio en su lugar (recomendado).

2. Verifique y corrija el dominio/URL#

Compruebe el dominio cuidadosamente: Revise con atención la URL completa o la URL base que está usando en Apidog. Asegúrese de que el nombre de dominio esté escrito correctamente y tenga el formato adecuado (sin / faltantes ni adicionales).
Ejemplo: asegúrese de que sea api.example.com en lugar de api.exampel.com.
Compruebe el formato de la URL: Asegúrese de que la URL comience con http:// o https://.
Si su URL base utiliza variables de entorno, confirme que los valores de las variables sean correctos.

3. Actualice la resolución DNS local#

Pruebe en el navegador: Intente abrir la misma URL directamente en su navegador.
Si el navegador tampoco puede acceder a ella, es probable que el problema sea local (su computadora o red).
Vacíe la caché DNS:
Windows: Ejecute ipconfig /flushdns en el Símbolo del sistema (CMD).
macOS: Ejecute sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder en Terminal.
Compruebe su archivo hosts:
Windows: C:\Windows\System32\drivers\etc\hosts
macOS/Linux: /etc/hosts
Elimine o comente (añada # al comienzo de la línea) cualquier entrada relacionada con el dominio que está probando.

4. Compruebe la configuración de red y proxy#

Cambie los servidores DNS: Cambie temporalmente a servidores DNS públicos, como Google DNS (8.8.8.8), y vuelva a intentarlo.
Inspeccione la configuración de VPN/proxy:
Intente deshabilitar su VPN o proxy y envíe la petición de nuevo.
Si se requiere un proxy, vaya a Settings → Network Proxy en Apidog y verifique que la configuración del proxy sea correcta.
imagen.png
Reinicie los dispositivos de red: Reinicie su router o módem para eliminar posibles problemas de red o DNS.
Al seguir estos pasos, debería poder identificar y resolver la causa raíz del error ENOTFOUND: Couldn't resolve host en Apidog.
Modified at 2026-06-09 08:52:14
Previous
Corrección del error ETIMEDOUT
Next
Corrección de ENOTFOUND: error getaddrinfo ENOTFOUND www
Built with