Bắt đầu

Địa chỉ truy cập

Trang này được dịch máy từ bản tiếng Trung và có thể có sai sót. Nội dung theo bản tiếng Trung.

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ụ:

POSThttps://api.yescaptcha.com/createTaskEndpoint quốc tế

POSThttps://cn.yescaptcha.com/createTaskEndpoint Trung Quốc

Quy tắc

Chỉ dùng HTTPS.
Trừ /useragent, 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.

Phương thức	Chức năng	Ghi chú
createTask	Tạo tác vụ	Loại đồng bộ trả về kết quả ngay
getTaskResult	Truy vấn kết quả tác vụ	Loại bất đồng bộ: polling 5 giây một lần
getBalance	Truy vấn số dư	Không trừ điểm
getSoftID	Truy vấn ID nhà phát triển	Dùng cho chia sẻ doanh thu cho nhà phát triển
report	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	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.