getToken

Tạo tác vụ và chờ kết quả ngay trong cùng request, tối đa 50 giây. Nếu khi đó tác vụ chưa xong, phản hồi là status processing kèm taskId; tiếp tục kiểm tra bằng getTaskResult. Tác vụ getToken không gửi callback kết quả.

POSThttps://unlock-api.com/getToken

Đặt timeout của HTTP client trên 60 giây cho phương thức này.

Tham số request

clientKey

StringBắt buộc

API key của bạn, 32 ký tự, có trên trang tài khoản.

task

ObjectBắt buộc

Object tác vụ. Trường type của nó quyết định cần những trường nào khác. Loại tác vụ

softId

IntegerTùy chọn

Id ứng dụng của bạn, được lưu cùng tác vụ. appId cũng được nhận như cùng một trường.

Request

POST /getToken

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

Phản hồi

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

{
  "errorId": 0,
  "status": "processing",
  "taskId": 1001
}

Trường phản hồi

errorId

Integer

0 khi request thành công, 1 khi không thành công.

taskId

Integer

Id tác vụ.

status

String

processing khi tác vụ đang được giải, ready khi đã xong.

solution

Object

Kết quả. Các trường phụ thuộc vào loại tác vụ.

cost

String

Giá của tác vụ này bằng đô la Mỹ.

Code mẫu

curl -s https://unlock-api.com/getToken \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}'

import requests

r = requests.post("https://unlock-api.com/getToken", json={
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "TurnstileTaskProxyless",
        "websiteURL": "https://example.com/login",
        "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
}).json()
print(r)

const r = await fetch("https://unlock-api.com/getToken", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "TurnstileTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
  }),
}).then((res) => res.json());
console.log(r);

Các lỗi phương thức này có thể trả về

ERROR_KEY_DOES_NOT_EXIST
Key sai. Hãy sao chép lại từ trang tài khoản. (in.php và res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
Request đến từ IP không có trong danh sách được phép của tài khoản. Hãy thêm IP trên trang tài khoản.
ERROR_IP_BANNED
Tài khoản này đã bị khóa. Liên hệ hỗ trợ từ trang tài khoản.
ERROR_TOO_MANY_REQUESTS
Quá nhiều request. Hãy giãn lượt kiểm tra kết quả ra mỗi 5 giây.
ERROR_ZERO_BALANCE
Số dư không đủ cho tác vụ. Hãy nạp thêm; chưa có khoản nào bị trừ.
ERROR_NO_SLOT_AVAILABLE
Hiện có quá nhiều request nên không nhận được tác vụ. Thử lại sau vài giây; chưa có khoản nào bị trừ.
ERROR_TASK_NOT_SUPPORTED
Loại tác vụ không xác định hoặc đang tắt. Kiểm tra lại tên loại.
ERROR_BAD_PARAMETERS
Thiếu một trường bắt buộc hoặc trường sai định dạng.
ERROR_PAGEURL
Thiếu websiteURL hoặc pageurl, hoặc không phải địa chỉ http(s) đầy đủ.
ERROR_CAPTCHA_UNSOLVABLE
Không giải được tác vụ kịp thời gian. Tiền đã được trả lại vào số dư.