# Problèmes de connexion et de réseau

> Que faire quand vous ne parvenez pas à joindre l'API YesCaptcha : Failed to establish a new connection, échec de résolution DNS, interférence d'un logiciel de proxy, erreurs SSL (Certificate has expired, SSLEOFError) et étapes de diagnostic.

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

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.

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

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

```bash
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](https://docs.yescaptcha.com/fr/help/contact.md) 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.