# Problemas de conexión y red

> Qué hacer si no puedes conectarte a la API de YesCaptcha: pasos para diagnosticar Failed to establish a new connection, fallos de DNS, interferencia de software de proxy y errores SSL (Certificate has expired, SSLEOFError).

Source: https://docs.yescaptcha.com/es/help/troubleshooting/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/help/troubleshooting/

Los errores de conexión al llamar a la API (por ejemplo `Failed to establish a new connection`, `getaddrinfo failed`, timeouts o errores SSL) suelen deberse a la red de tu equipo, al DNS o al software de proxy. Sigue estos pasos en orden.

## 1\. Prueba primero con el otro endpoint

YesCaptcha tiene dos endpoints: `https://api.yescaptcha.com` (global) y `https://cn.yescaptcha.com` (China). En servidores de China continental usa el endpoint China; en el resto del mundo, el global. Si cambias de endpoint, consulta también los resultados en el mismo endpoint.

```bash
curl -s https://api.yescaptcha.com/getBalance -H 'Content-Type: application/json' -d '{"clientKey": "YOUR_CLIENT_KEY"}'
curl -s https://cn.yescaptcha.com/getBalance -H 'Content-Type: application/json' -d '{"clientKey": "YOUR_CLIENT_KEY"}'
```

Si cualquiera de los dos devuelve JSON, tu red funciona y el problema está en la ruta hacia el otro endpoint.

## 2\. Revisa el software de proxy

Para acceder a YesCaptcha no necesitas proxy. Si tienes software de proxy o VPN activo:

-   Desactívalo y vuelve a probar;
-   Si debe permanecer activo, usa el modo por reglas (PAC) en lugar del modo global, o añade `api.yescaptcha.com` y `cn.yescaptcha.com` a la lista de conexión directa;
-   Si en Python, con un proxy activo, aparece `SSLEOFError(8, 'EOF occurred in violation of protocol')`, lo más probable es que también lo cause el proxy; desactívalo o haz que estos dos dominios se conecten directamente.

## 3\. Revisa la red y el DNS

```bash
ping api.yescaptcha.com
```

-   Si indica que no encuentra el host: falló la resolución de DNS. Vacía la caché de DNS (Windows: `ipconfig /flushdns`; macOS: `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`), o cambia el DNS de tu equipo a uno público (por ejemplo `223.5.5.5`, `119.29.29.29` o `8.8.8.8`) y vuelve a probar.
-   Si el ping falla pero la dirección se resuelve: puede que la red bloquee ICMP, lo que no significa que la API sea inaccesible. Guíate por el resultado del curl del paso 1.

## 4\. Errores de certificado SSL

-   Si aparece `Certificate has expired` o `certificate verify failed`: primero comprueba que la **hora del sistema** de tu equipo sea correcta; después actualiza el sistema operativo, el `certifi` de Python, Postman u otras herramientas a la última versión para que incluyan los certificados raíz más recientes.
-   Usa siempre `https://`. No cambies a `http://` ni desactives la verificación de certificados para evitar el error.

## 5\. Si sigue sin funcionar

[Contacta con soporte](https://docs.yescaptcha.com/es/help/contact.md) e incluye: el mensaje de error completo, el endpoint que usas, la región donde está tu servidor y la salida del curl del paso 1.