# Problemas de conexão e rede

> O que fazer quando não é possível acessar a API do YesCaptcha. Failed to establish a new connection, falha de DNS, interferência de software de proxy e erros de SSL (Certificate has expired, SSLEOFError).

Source: https://docs.yescaptcha.com/pt/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/

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.

```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"}'
```

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

```bash
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](https://docs.yescaptcha.com/pt/help/contact.md) 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.