Problemas de conexão e rede

Erros de conexão ao chamar a API (como Failed to establish a new connection, getaddrinfo failed, timeouts ou erros de SSL) geralmente vêm da rede da sua máquina, do DNS ou de software de proxy. Siga os passos abaixo na ordem.

1. Teste o outro endpoint

O YesCaptcha tem dois endpoints: https://api.yescaptcha.com (global) e https://cn.yescaptcha.com (China). Use o endpoint China em servidores na China continental e o global nas demais regiões. Ao trocar de endpoint, consulte os resultados no mesmo 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"}'

Se um dos dois retornar JSON, a sua rede está funcionando e o problema está na rota até o outro endpoint.

2. Verifique o software de proxy

Não é necessário proxy para acessar o YesCaptcha. Se há um proxy ou VPN em execução:

• Desative-o e tente novamente;
• Se precisar mantê-lo ativo, use o modo por regras (PAC) em vez do modo global, ou adicione api.yescaptcha.com e cn.yescaptcha.com à lista de conexão direta;
• SSLEOFError(8, 'EOF occurred in violation of protocol') no Python com um proxy ativo também costuma ser causado pelo proxy; desative-o ou faça esses dois domínios conectarem diretamente.

3. Verifique a rede e o DNS

ping api.yescaptcha.com

• Mensagem de host não encontrado: falha na resolução de DNS. Limpe o cache de DNS (Windows: ipconfig /flushdns; macOS: sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder) ou troque o DNS do computador por um DNS público (por exemplo 223.5.5.5, 119.29.29.29, 8.8.8.8) e tente novamente.
• O ping falha, mas o endereço é resolvido: a rede pode estar bloqueando ICMP, o que não significa que a API esteja inacessível. Considere o resultado do curl do passo 1.

4. Erros de certificado SSL

• Certificate has expired ou certificate verify failed: primeiro verifique se o horário do sistema está correto; depois atualize o sistema operacional, o certifi do Python, o Postman e outras ferramentas para a versão mais recente, para que tenham os certificados raiz atualizados.
• Use sempre https://. Não troque para http:// nem desative a verificação de certificado para contornar o erro.

5. Ainda não resolveu?

Entre em contato com o suporte informando: a mensagem de erro completa, o endpoint que você usa, a região do seu servidor e a saída do curl do passo 1.