# Masalah koneksi dan jaringan

> Apa yang harus dilakukan jika tidak bisa terhubung ke API YesCaptcha. Langkah pemeriksaan untuk Failed to establish a new connection, kegagalan resolusi DNS, gangguan software proxy, dan error SSL (Certificate has expired, SSLEOFError).

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

Error koneksi saat memanggil API (misalnya `Failed to establish a new connection`, `getaddrinfo failed`, timeout, atau error SSL) biasanya disebabkan oleh jaringan lokal, DNS, atau software proxy di perangkat Anda. Periksa sesuai urutan berikut.

## 1\. Coba ganti endpoint

YesCaptcha memiliki dua endpoint: `https://api.yescaptcha.com` (global) dan `https://cn.yescaptcha.com` (Tiongkok). Gunakan endpoint Tiongkok di server di daratan Tiongkok, dan endpoint global di wilayah lain. Setelah berganti endpoint, kueri hasil juga harus memakai endpoint yang sama.

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

Jika salah satunya mengembalikan JSON, berarti jaringan Anda berfungsi dan masalahnya ada pada jalur ke endpoint yang lain.

## 2\. Periksa software proxy

Untuk mengakses YesCaptcha tidak diperlukan proxy. Jika software proxy atau VPN sedang aktif:

-   Matikan lalu coba lagi;
-   Jika harus tetap aktif, gunakan mode berbasis aturan (mode PAC) alih-alih mode global, atau tambahkan `api.yescaptcha.com` dan `cn.yescaptcha.com` ke daftar koneksi langsung;
-   `SSLEOFError(8, 'EOF occurred in violation of protocol')` di Python saat proxy aktif umumnya juga disebabkan oleh proxy; matikan proxy atau biarkan kedua domain ini terhubung langsung.

## 3\. Periksa jaringan dan DNS

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

-   Muncul pesan host tidak ditemukan: resolusi DNS gagal. Bersihkan cache DNS (Windows: `ipconfig /flushdns`; macOS: `sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder`), atau ganti DNS perangkat ke DNS publik (misalnya `223.5.5.5`, `119.29.29.29`, `8.8.8.8`) lalu coba lagi.
-   Ping gagal tetapi alamat berhasil di-resolve: jaringan mungkin memblokir ICMP, ini tidak berarti API tidak bisa dijangkau. Gunakan hasil curl dari langkah 1 sebagai acuan.

## 4\. Error sertifikat SSL

-   Muncul `Certificate has expired` atau `certificate verify failed`: periksa dahulu apakah **waktu sistem** perangkat Anda sudah benar, lalu perbarui sistem operasi, `certifi` milik Python, Postman, dan tool lainnya ke versi terbaru agar memiliki sertifikat root terbaru.
-   Selalu gunakan `https://`. Jangan beralih ke `http://` atau menonaktifkan verifikasi sertifikat untuk menghindari error.

## 5\. Masih belum berhasil?

[Hubungi dukungan](https://docs.yescaptcha.com/id/help/contact.md) dengan menyertakan: pesan error lengkap, endpoint yang Anda gunakan, wilayah lokasi server Anda, dan output curl dari langkah 1.