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

Если при вызове 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.

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

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. Не помогло

Обратитесь в поддержку и приложите: полный текст ошибки, используемый endpoint, регион сервера и вывод curl из шага 1.