JSON 方法

在 createTask 中加上 callbackUrl。任務完成時，結果會以 POST 傳送到該網址，JSON 主體格式與 getTaskResult 相同，並加上 taskId。失敗的任務會傳送 errorId 1 和 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
}

{
  "errorId": 1,
  "taskId": 1001,
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE"
}

表單 API

在 in.php 中加上 pingback。任務完成時，該網址會收到 POST 表單主體，包含 id（任務 ID）和 code（答案或錯誤名稱）。

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...

規則

網址必須是公開的 http 或 https。私有、本機和回送位址不會被呼叫。
只嘗試一次，逾時 5 秒。結果仍可透過 getTaskResult 和 res.php 取得，請保留備用查詢。
不檢查你伺服器的回覆，傳送失敗也不會重試。