Masalah koneksi dan jaringan

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.

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

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 dengan menyertakan: pesan error lengkap, endpoint yang Anda gunakan, wilayah lokasi server Anda, dan output curl dari langkah 1.