Verbindungsprobleme

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.

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

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 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.