# Địa chỉ truy cập

> Hai endpoint của YesCaptcha API: endpoint quốc tế api.yescaptcha.com và endpoint Trung Quốc cn.yescaptcha.com; chỉ nhận HTTPS POST với JSON, tạo và truy vấn tác vụ trên cùng một endpoint.

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

YesCaptcha API có hai endpoint, giao diện và tham số hoàn toàn giống nhau. Hãy chọn endpoint theo vị trí đặt máy chủ của bạn:

| Endpoint | Địa chỉ | Phù hợp với |
| --- | --- | --- |
| Endpoint quốc tế | `https://api.yescaptcha.com` | Máy chủ ngoài Trung Quốc đại lục |
| Endpoint Trung Quốc | `https://cn.yescaptcha.com` | Máy chủ ở Trung Quốc đại lục |

Địa chỉ của một phương thức = địa chỉ endpoint + tên phương thức, ví dụ tạo tác vụ:

- POST `https://api.yescaptcha.com/createTask` (Endpoint quốc tế)
- POST `https://cn.yescaptcha.com/createTask` (Endpoint Trung Quốc)

## Quy tắc

-   Chỉ dùng HTTPS.
-   Trừ [/useragent](https://docs.yescaptcha.com/vi/api/useragent.md), mọi phương thức đều dùng `POST`, nội dung yêu cầu là JSON, kèm header `Content-Type: application/json`. Nội dung yêu cầu không được vượt quá 6 MB.
-   Xác thực bằng `clientKey` trong nội dung yêu cầu, không cần header nào khác.

> **Ghi chú:** Tạo tác vụ ở endpoint nào thì truy vấn bằng `getTaskResult` ở đúng endpoint đó, không dùng lẫn hai endpoint.

## Tất cả phương thức

| Phương thức | Chức năng | Ghi chú |
| --- | --- | --- |
| [createTask](https://docs.yescaptcha.com/vi/api/create-task.md) | Tạo tác vụ | Loại đồng bộ trả về kết quả ngay |
| [getTaskResult](https://docs.yescaptcha.com/vi/api/get-task-result.md) | Truy vấn kết quả tác vụ | Loại bất đồng bộ: polling 5 giây một lần |
| [getBalance](https://docs.yescaptcha.com/vi/api/get-balance.md) | Truy vấn số dư | Không trừ điểm |
| [getSoftID](https://docs.yescaptcha.com/vi/api/get-soft-id.md) | Truy vấn ID nhà phát triển | Dùng cho chia sẻ doanh thu cho nhà phát triển |
| [report](https://docs.yescaptcha.com/vi/api/report.md) | Báo cáo kết quả nhận dạng | Loại nhận dạng hình ảnh có thể yêu cầu hoàn điểm |
| [useragent](https://docs.yescaptcha.com/vi/api/useragent.md) | Lấy User-Agent được đề xuất | `GET`, dùng cho hCaptcha |

Nếu không kết nối được tới giao diện, xem [Sự cố kết nối và mạng](https://docs.yescaptcha.com/vi/help/troubleshooting.md).