Tài liệu tham khảo API giải CAPTCHA

POST /createTask Tạo tác vụ

Body: clientKey và một object task. Loại tác vụ quyết định các trường còn lại; xem Loại tác vụ. Phản hồi: errorId 0 và taskId, hoặc errorId 1 kèm errorCode.

POST https://unlock-api.com/createTask
{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}

{"errorId":0,"taskId":1001}
{"errorId":1,"errorCode":"ERROR_ZERO_BALANCE","errorDescription":"..."}

POST /getTaskResult Lấy kết quả

Body: clientKey và taskId. Khi tác vụ đang chạy: status processing. Khi xong: status ready kèm solution và cost. Tác vụ lỗi trả về errorId 1 kèm errorCode.

POST https://unlock-api.com/getTaskResult
{"clientKey":"YOUR_API_KEY","taskId":1001}

{"errorId":0,"status":"processing"}
{"errorId":0,"status":"ready","solution":{"token":"0.zrSnRHO7h0..."},"cost":"0.0012","createTime":1791640000,"endTime":1791640011,"solveCount":1}

POST /getBalance Xem số dư

Body: clientKey. Phản hồi: số dư bằng đô la Mỹ.

{"clientKey":"YOUR_API_KEY"}

{"errorId":0,"balance":42.5}

Báo kết quả sai

reportIncorrectRecaptcha và reportIncorrectImageCaptcha nhận clientKey và taskId và trả về success. Chúng được chấp nhận để tương thích với các thư viện hiện có; báo cáo không làm thay đổi số tiền đã trừ.

Gửi tác vụ: in.php

Trường: key, method và các trường của loại CAPTCHA. Phản hồi: OK|ID, hoặc với json=1 là {"status":1,"request":"ID"}. Lỗi được trả về bằng tên, ví dụ ERROR_ZERO_BALANCE.

POST https://unlock-api.com/in.php
key=YOUR_API_KEY&method=hcaptcha&sitekey=SITE_KEY&pageurl=https://example.com&json=1

OK|1001
{"status":1,"request":"1001"}

Lấy kết quả: res.php

action=get&id=ID trả về OK|ANSWER khi đã giải và CAPCHA_NOT_READY khi đang xử lý. action=get2 kèm thêm cost. ids=ID1,ID2 kiểm tra tối đa 100 tác vụ một lúc. action=getbalance trả về số dư. action=reportbad và reportgood được chấp nhận.

GET https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&id=1001
CAPCHA_NOT_READY
OK|P1_eyJ0eXAiOiJKV1Qi...

GET https://unlock-api.com/res.php?key=YOUR_API_KEY&action=getbalance
42.5

POST /getToken Tạo và chờ: getToken

Body giống createTask. Lệnh gọi chờ tối đa 50 giây và trả về phản hồi giống getTaskResult. Nếu tác vụ vẫn đang chạy, phản hồi là status processing kèm taskId; hãy tiếp tục kiểm tra bằng getTaskResult.

POST https://unlock-api.com/getToken
{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com","websiteKey":"0x4AAAA..."}}

{"errorId":0,"taskId":1001,"status":"ready","solution":{"token":"0.zrSnRHO7h0..."},"cost":"0.000725"}

Callback kết quả

Thêm callbackUrl vào createTask (hoặc pingback vào in.php) và kết quả sẽ được gửi tới đó khi tác vụ xong: body JSON giống getTaskResult kèm taskId, hoặc với in.php là body form id=…&code=…. Chỉ gọi tới địa chỉ công khai, một lần, thời gian chờ 5 giây; kết quả vẫn lấy được bằng cách kiểm tra như thường.

{"clientKey":"YOUR_API_KEY","callbackUrl":"https://your.server/captcha-result","task":{...}}

POST https://your.server/captcha-result
{"errorId":0,"taskId":1001,"status":"ready","solution":{...},"cost":"0.0005"}

Thống kê

getQueueStats trả về số tác vụ đang chờ và đang giải cùng thời gian giải trung bình trong giờ qua. getSpendingStats trả về số lượng và số tiền theo từng giờ trong một ngày UTC (date dạng unix time). test trả lại đúng body nó nhận được.

POST https://unlock-api.com/getQueueStats     {"clientKey":"..."}  ->  {"errorId":0,"waiting":3,"solving":12,"speed":6.4,"total":15}
POST https://unlock-api.com/getSpendingStats  {"clientKey":"...","date":1791590400}  ->  {"errorId":0,"data":[{"dateFrom":...,"volume":120,"money":0.06},...]}
POST https://unlock-api.com/test              {"anything":1}  ->  {"errorId":0,"received":{"anything":1}}

Danh sách IP được phép

Nếu bạn đặt danh sách IP được phép trên trang tài khoản, request từ IP khác sẽ nhận ERROR_IP_NOT_ALLOWED.