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

> Cách xử lý khi không kết nối được API YesCaptcha. Các bước kiểm tra lỗi Failed to establish a new connection, lỗi phân giải DNS, phần mềm proxy gây nhiễu và lỗi chứng chỉ SSL (Certificate has expired, SSLEOFError).

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

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 đó.

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

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

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