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

> YesCaptcha API に接続できないときの対処法。Failed to establish a new connection、DNS 解決の失敗、プロキシソフトの干渉、SSL 証明書エラー（Certificate has expired、SSLEOFError）の切り分け手順。

Source: https://docs.yescaptcha.com/ja/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\. 別のエンドポイントを試す

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

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

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

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

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

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

## 4\. SSL 証明書エラー

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

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

[サポートに問い合わせ](https://docs.yescaptcha.com/ja/help/contact.md)てください。次の情報を添えてください: エラーメッセージの全文、使用しているエンドポイント、サーバーの所在地域、手順 1 の curl の出力。