Aide

Problèmes de connexion et de réseau

Cette page a été traduite automatiquement à partir de la version chinoise et peut contenir des erreurs. La version chinoise fait foi.

Les erreurs de connexion lors d’un appel à l’API (par exemple Failed to establish a new connection, getaddrinfo failed, timeouts ou erreurs SSL) proviennent généralement du réseau de votre machine, du DNS ou d’un logiciel de proxy. Suivez les étapes ci-dessous dans l’ordre.

1. Essayer l’autre endpoint

YesCaptcha propose deux endpoints : https://api.yescaptcha.com (mondial) et https://cn.yescaptcha.com (Chine). Utilisez l’endpoint Chine sur les serveurs situés en Chine continentale, et l’endpoint mondial partout ailleurs. Si vous changez d’endpoint, interrogez aussi les résultats sur le même 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"}'

Si l’un des deux renvoie du JSON, votre réseau fonctionne et le problème vient de la route vers l’autre endpoint.

2. Vérifier les logiciels de proxy

L’accès à YesCaptcha ne nécessite pas de proxy. Si un logiciel de proxy ou de VPN est actif sur votre machine :

Désactivez-le et réessayez ;
Si vous devez le garder actif, passez en mode basé sur des règles (mode PAC) plutôt qu’en mode global, ou ajoutez api.yescaptcha.com et cn.yescaptcha.com à la liste de connexion directe ;
Si Python signale SSLEOFError(8, 'EOF occurred in violation of protocol') alors qu’un proxy est actif, le proxy en est le plus souvent la cause : désactivez-le ou faites en sorte que ces deux domaines se connectent directement.

3. Vérifier le réseau et le DNS

ping api.yescaptcha.com

Si l’hôte est introuvable : la résolution DNS a échoué. Videz le cache DNS (Windows : ipconfig /flushdns ; macOS : sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder), ou remplacez le DNS de votre machine par un DNS public (par exemple 223.5.5.5, 119.29.29.29, 8.8.8.8) et réessayez.
Si le ping échoue mais que l’adresse est résolue : le réseau bloque peut-être ICMP, ce qui ne signifie pas que l’API est inaccessible. Fiez-vous au résultat du curl de l’étape 1.

4. Erreurs de certificat SSL

En cas de Certificate has expired ou certificate verify failed : vérifiez d’abord que l’heure système de votre machine est correcte, puis mettez à jour le système d’exploitation, le paquet certifi de Python, Postman et les autres outils pour qu’ils disposent des certificats racine les plus récents.
Utilisez toujours https://. Ne passez pas à http:// et ne désactivez pas la vérification des certificats pour contourner l’erreur.

5. Toujours bloqué ?

Contactez le support en joignant : le message d’erreur complet, l’endpoint que vous utilisez, la région de votre serveur et la sortie du curl de l’étape 1.