接続とネットワークの問題

API 呼び出しで接続エラー（例: Failed to establish a new connection、getaddrinfo failed、タイムアウト、SSL エラー）が出る場合、多くは手元のネットワーク、DNS、プロキシソフトが原因です。以下の順に確認してください。

1. 別のエンドポイントを試す

YesCaptcha にはエンドポイントが 2 つあります。https://api.yescaptcha.com（グローバル）と https://cn.yescaptcha.com（中国）です。中国本土のサーバーでは中国エンドポイントを、それ以外の地域ではグローバルエンドポイントを使います。エンドポイントを切り替えたら、結果の取得にも同じエンドポイントを使ってください。

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 が返れば、ネットワーク自体は正常です。もう一方のエンドポイントへの経路に問題があります。

2. プロキシソフトを確認する

YesCaptcha への接続にプロキシは不要です。プロキシや VPN ソフトを起動している場合は次のようにします。

• いったんオフにして再試行する。
• オフにできない場合は、グローバルモードではなくルールベース（PAC モード）の振り分けにするか、api.yescaptcha.com と cn.yescaptcha.com を直接接続のリストに追加する。
• プロキシ使用中の Python で SSLEOFError(8, 'EOF occurred in violation of protocol') が出る場合も、たいていはプロキシが原因です。プロキシをオフにするか、この 2 つのドメインを直接接続にしてください。

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 に接続できないという意味ではないので、手順 1 の curl の結果で判断してください。

4. SSL 証明書エラー

• Certificate has expired や certificate verify failed が出る場合: まずシステム時刻が正しいか確認します。次に、OS、Python の certifi、Postman などのツールを最新版に更新し、最新のルート証明書を使えるようにしてください。
• 常に https:// を使ってください。証明書エラーを回避するために http:// に切り替えたり、証明書の検証を無効にしたりしないでください。

5. それでも解決しない場合

サポートに問い合わせてください。次の情報を添えてください: エラーメッセージの全文、使用しているエンドポイント、サーバーの所在地域、手順 1 の curl の出力。