UNLOCK API
API key নিন
ফলাফলের callback
MarkdownOpenAPI

ফলাফলের callback

চেক করার বদলে ফলাফল আপনার সার্ভারে পাঠিয়ে নিন।

JSON মেথড

createTask-এ callbackUrl যোগ করুন। টাস্ক শেষ হলে ফলাফল সেই ঠিকানায় POST দিয়ে পাঠানো হয়, JSON body-র গঠন getTaskResult-এর মতো, সঙ্গে taskId। ব্যর্থ টাস্ক errorCode সহ errorId 1 পাঠায়।
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

in.php-তে pingback যোগ করুন। টাস্ক শেষ হলে ঠিকানাটি একটি POST ফর্ম 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 হতে হবে। প্রাইভেট, লোকাল ও loopback ঠিকানায় কল করা হয় না।
  • 5 সেকেন্ড timeout সহ একবার চেষ্টা। ফলাফল getTaskResult ও res.php দিয়েও পাওয়া যায়, তাই বিকল্প চেক রাখুন।
  • আপনার সার্ভারের উত্তর যাচাই করা হয় না, এবং ডেলিভারি ব্যর্থ হলে আবার পাঠানো হয় না।