# Проблемы с подключением и сетью

> Что делать, если не удаётся подключиться к API YesCaptcha: Failed to establish a new connection, сбой DNS, влияние прокси-программ, ошибки SSL-сертификата (Certificate has expired, SSLEOFError).

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

Если при вызове API возникает ошибка подключения (например, `Failed to establish a new connection`, `getaddrinfo failed`, тайм-аут или ошибка SSL), обычно причина в сети компьютера, DNS или прокси-программе. Проверьте по шагам ниже.

## 1\. Сначала попробуйте другой endpoint

У YesCaptcha два endpoint: `https://api.yescaptcha.com` (глобальный) и `https://cn.yescaptcha.com` (для Китая). На серверах в материковом Китае используйте endpoint для Китая, в остальных регионах — глобальный. После смены endpoint результат задачи нужно запрашивать на том же 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"}'
```

Если хотя бы один из них вернул JSON, сеть работает, а проблема в маршруте до другого endpoint.

## 2\. Проверьте прокси-программы

Для доступа к YesCaptcha прокси не нужен. Если на компьютере запущена прокси-программа или VPN:

-   отключите её и повторите попытку;
-   если она должна оставаться включённой, переключите её с глобального режима на режим по правилам (PAC) или добавьте `api.yescaptcha.com` и `cn.yescaptcha.com` в список прямого подключения;
-   ошибка `SSLEOFError(8, 'EOF occurred in violation of protocol')` в Python при включённом прокси, скорее всего, тоже вызвана прокси: отключите его или подключайте эти два домена напрямую.

## 3\. Проверьте сеть и DNS

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

-   Сообщение, что хост не найден, означает сбой разрешения DNS. Очистите кэш DNS (Windows: `ipconfig /flushdns`; macOS: `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`) или переключите DNS на компьютере на публичный (например, `223.5.5.5`, `119.29.29.29`, `8.8.8.8`) и повторите попытку.
-   Ping не проходит, но адрес разрешается: возможно, сеть блокирует ICMP. Это не значит, что API недоступен; ориентируйтесь на результат curl из шага 1.

## 4\. Ошибки SSL-сертификата

-   Ошибки `Certificate has expired` и `certificate verify failed`: сначала проверьте, что **системное время** на компьютере указано верно, затем обновите операционную систему, `certifi` для Python, Postman и другие инструменты до последней версии, чтобы в них были актуальные корневые сертификаты.
-   Всегда используйте `https://`. Не переходите на `http://` и не отключайте проверку сертификата, чтобы обойти ошибку.

## 5\. Не помогло

[Обратитесь в поддержку](https://docs.yescaptcha.com/ru/help/contact.md) и приложите: полный текст ошибки, используемый endpoint, регион сервера и вывод curl из шага 1.