Problemas de conexión y red

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.

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

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 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.