UNLOCK API
รับ API key
callback ผลลัพธ์
MarkdownOpenAPI

callback ผลลัพธ์

ให้ระบบส่งผลลัพธ์ไปที่เซิร์ฟเวอร์ของคุณแทนการตรวจเอง

method แบบ JSON

เพิ่ม callbackUrl ใน createTask เมื่องานเสร็จ ผลลัพธ์จะถูกส่งไปที่อยู่นั้นด้วย POST พร้อม body 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
}

Form API

เพิ่ม pingback ใน in.php เมื่องานเสร็จ ที่อยู่นั้นจะได้รับ POST แบบ form body ที่มี 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 สาธารณะ ระบบจะไม่เรียกที่อยู่ส่วนตัว local หรือ loopback
  • ส่ง 1 ครั้ง timeout 5 วินาที ผลลัพธ์ยังเรียกดูได้ด้วย getTaskResult และ res.php จึงควรมีการตรวจผลสำรองไว้
  • ระบบไม่ตรวจคำตอบจากเซิร์ฟเวอร์ของคุณ และไม่ส่งซ้ำถ้าส่งไม่สำเร็จ