UNLOCK API
Kunci API
Callback keputusan
MarkdownOpenAPI

Callback keputusan

Terima keputusan yang dihantar ke pelayan anda tanpa perlu menyemaknya.

Kaedah JSON

Tambah callbackUrl pada createTask. Apabila tugas selesai, keputusan dihantar ke alamat itu melalui POST dengan body JSON yang berbentuk seperti getTaskResult, ditambah taskId. Tugas gagal menghantar errorId 1 dengan 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 borang

Tambah pingback pada in.php. Apabila tugas selesai, alamat itu menerima body borang POST dengan id (id tugas) dan code (jawapan, atau nama ralat).
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...

Peraturan

  • Alamat mesti http atau https awam. Alamat peribadi, lokal dan loopback tidak dipanggil.
  • Satu cubaan dengan timeout 5 saat. Keputusan juga kekal tersedia melalui getTaskResult dan res.php, jadi kekalkan semakan sandaran.
  • Balasan daripada pelayan anda tidak disemak, dan penghantaran yang gagal tidak dicuba semula.