# Verbindungsprobleme

> Was tun, wenn die YesCaptcha API nicht erreichbar ist: Schritte zur Fehlersuche bei Failed to establish a new connection, DNS-Fehlern, Störungen durch Proxy-Software und SSL-Zertifikatsfehlern (Certificate has expired, SSLEOFError).

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

Verbindungsfehler beim Aufruf der API (zum Beispiel `Failed to establish a new connection`, `getaddrinfo failed`, Timeouts oder SSL-Fehler) liegen meist am lokalen Netzwerk, am DNS oder an Proxy-Software. Gehen Sie die folgenden Schritte der Reihe nach durch.

## 1\. Zuerst den anderen Endpoint testen

YesCaptcha hat zwei Endpoints: `https://api.yescaptcha.com` (global) und `https://cn.yescaptcha.com` (China). Verwenden Sie auf Servern in Festlandchina den China-Endpoint, überall sonst den globalen Endpoint. Wenn Sie den Endpoint wechseln, fragen Sie auch die Ergebnisse über denselben Endpoint ab.

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

Liefert einer der beiden Aufrufe JSON zurück, funktioniert Ihr Netzwerk, und das Problem liegt in der Route zum anderen Endpoint.

## 2\. Proxy-Software prüfen

Für den Zugriff auf YesCaptcha ist kein Proxy nötig. Wenn auf dem Rechner Proxy- oder VPN-Software läuft:

-   Schalten Sie sie aus und versuchen Sie es erneut.
-   Wenn sie eingeschaltet bleiben muss, wechseln Sie vom globalen Modus in einen regelbasierten Modus (PAC) oder tragen Sie `api.yescaptcha.com` und `cn.yescaptcha.com` in die Liste der direkten Verbindungen ein.
-   Tritt in Python bei laufendem Proxy `SSLEOFError(8, 'EOF occurred in violation of protocol')` auf, liegt es meist ebenfalls am Proxy. Schalten Sie den Proxy aus oder lassen Sie diese beiden Domains direkt verbinden.

## 3\. Netzwerk und DNS prüfen

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

-   Meldung, dass der Host nicht gefunden wird: Die DNS-Auflösung ist fehlgeschlagen. Leeren Sie den DNS-Cache (Windows: `ipconfig /flushdns`; macOS: `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`) oder stellen Sie den DNS des Rechners auf einen öffentlichen DNS um (zum Beispiel `223.5.5.5`, `119.29.29.29`, `8.8.8.8`) und versuchen Sie es erneut.
-   Ping schlägt fehl, die Adresse wird aber aufgelöst: Möglicherweise blockiert das Netzwerk ICMP. Das bedeutet nicht, dass die API nicht erreichbar ist. Maßgeblich ist das Ergebnis des curl-Aufrufs aus Schritt 1.

## 4\. SSL-Zertifikatsfehler

-   Bei `Certificate has expired` oder `certificate verify failed`: Prüfen Sie zuerst, ob die **Systemzeit** des Rechners korrekt ist. Aktualisieren Sie dann das Betriebssystem, das Python-Paket `certifi`, Postman und andere Tools auf die neueste Version, damit sie die aktuellen Root-Zertifikate enthalten.
-   Verwenden Sie immer `https://`. Wechseln Sie nicht zu `http://` und schalten Sie die Zertifikatsprüfung nicht aus, um den Fehler zu umgehen.

## 5\. Es funktioniert immer noch nicht

[Kontaktieren Sie den Support](https://docs.yescaptcha.com/de/help/contact.md) und senden Sie dabei Folgendes mit: die vollständige Fehlermeldung, den verwendeten Endpoint, den Standort Ihres Servers und die Ausgabe des curl-Aufrufs aus Schritt 1.