UNLOCK API
Lấy API key
Callback kết quả
MarkdownOpenAPI

Callback kết quả

Nhận kết quả gửi về máy chủ của bạn thay vì tự kiểm tra.

Phương thức JSON

Thêm callbackUrl vào createTask. Khi tác vụ xong, kết quả được gửi tới địa chỉ đó bằng POST với body JSON giống getTaskResult, kèm taskId. Tác vụ lỗi gửi errorId 1 kèm errorCode.
POST /createTask
{
  "clientKey": "YOUR_API_KEY",
  "callbackUrl": "https://your-server.com/captcha-result",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}
POST https://your-server.com/captcha-result
{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

API form

Thêm pingback vào in.php. Khi tác vụ xong, địa chỉ đó nhận một body form POST gồm id (id tác vụ) và code (kết quả, hoặc tên lỗi).
in.php
curl -s "https://unlock-api.com/in.php" -d "key=YOUR_API_KEY&method=turnstile&sitekey=SITE_KEY&pageurl=https://example.com/login&pingback=https://your-server.com/captcha-result"

# POST https://your-server.com/captcha-result
# Content-Type: application/x-www-form-urlencoded
# id=1001&code=0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p...

Quy tắc

  • Địa chỉ phải là http hoặc https công khai. Địa chỉ nội bộ, local và loopback sẽ không được gọi.
  • Chỉ gửi một lần với timeout 5 giây. Kết quả vẫn lấy được bằng getTaskResult và res.php, nên hãy giữ bước kiểm tra dự phòng.
  • Phản hồi từ máy chủ của bạn không được kiểm tra, và lần gửi thất bại không được gửi lại.