Sự cố kết nối và mạng

Khi gọi API mà gặp lỗi kết nối (ví dụ Failed to establish a new connection, getaddrinfo failed, hết thời gian chờ, lỗi SSL), nguyên nhân thường nằm ở mạng, DNS hoặc phần mềm proxy trên máy của bạn. Hãy kiểm tra theo thứ tự dưới đây.

1. Thử đổi endpoint

YesCaptcha có hai endpoint: https://api.yescaptcha.com (quốc tế) và https://cn.yescaptcha.com (Trung Quốc). Máy chủ ở Trung Quốc đại lục dùng endpoint Trung Quốc, các khu vực khác dùng endpoint quốc tế. Sau khi đổi endpoint, hãy truy vấn kết quả bằng cùng 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"}'

Nếu một trong hai lệnh trả về JSON, mạng của bạn vẫn hoạt động và sự cố nằm ở đường truyền tới endpoint còn lại.

2. Kiểm tra phần mềm proxy

Truy cập YesCaptcha không cần proxy. Nếu máy đang bật proxy hoặc VPN:

• Hãy tắt đi rồi thử lại;
• Nếu bắt buộc phải bật, hãy chuyển sang chế độ chia luồng theo quy tắc (chế độ PAC) thay vì chế độ toàn cục, hoặc thêm api.yescaptcha.com và cn.yescaptcha.com vào danh sách kết nối trực tiếp;
• Nếu Python báo SSLEOFError(8, 'EOF occurred in violation of protocol') khi đang bật proxy, nguyên nhân thường cũng là proxy. Hãy tắt proxy hoặc cho hai tên miền này kết nối trực tiếp.

3. Kiểm tra mạng và DNS

ping api.yescaptcha.com

• Báo không tìm thấy máy chủ: phân giải DNS thất bại. Hãy xóa bộ nhớ đệm DNS (Windows: ipconfig /flushdns; macOS: sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder), hoặc đổi DNS của máy sang DNS công cộng (ví dụ 223.5.5.5, 119.29.29.29, 8.8.8.8) rồi thử lại.
• Ping không thông nhưng vẫn phân giải được địa chỉ: có thể mạng chặn ICMP, điều này không có nghĩa là API không truy cập được. Hãy lấy kết quả curl ở bước 1 làm chuẩn.

4. Lỗi chứng chỉ SSL

• Báo Certificate has expired hoặc certificate verify failed: trước hết kiểm tra giờ hệ thống của máy đã đúng chưa; sau đó cập nhật hệ điều hành, certifi của Python, Postman hoặc các công cụ khác lên phiên bản mới nhất để chúng có chứng chỉ gốc mới nhất.
• Luôn dùng https://. Đừng chuyển sang http:// hoặc tắt kiểm tra chứng chỉ để bỏ qua lỗi.

5. Vẫn không được?

Liên hệ bộ phận hỗ trợ và gửi kèm: thông báo lỗi đầy đủ, endpoint bạn đang dùng, khu vực đặt máy chủ, và kết quả lệnh curl ở bước 1.