UNLOCK API
getToken

getToken

একটি টাস্ক তৈরি করে এবং একই রিকোয়েস্টে 50 সেকেন্ড পর্যন্ত উত্তরের জন্য অপেক্ষা করে। এর মধ্যে টাস্ক শেষ না হলে উত্তর হয় status processing সঙ্গে taskId; getTaskResult দিয়ে চেক করতে থাকুন। getToken টাস্কের জন্য ফলাফলের callback পাঠানো হয় না।
POSThttps://unlock-api.com/getToken
এই মেথডের জন্য আপনার HTTP ক্লায়েন্টের timeout 60 সেকেন্ডের বেশি রাখুন।

রিকোয়েস্ট প্যারামিটার

clientKey
Stringআবশ্যিক
আপনার API key, 32 অক্ষর, অ্যাকাউন্ট পেজ থেকে।
task
Objectআবশ্যিক
টাস্ক অবজেক্ট। এর type ফিল্ড ঠিক করে আর কোন ফিল্ড লাগবে। টাস্ক টাইপ
softId
Integerঐচ্ছিক
আপনার অ্যাপ্লিকেশনের id, টাস্কের সঙ্গে সংরক্ষিত হয়। appId-ও একই ফিল্ড হিসেবে গ্রহণ করা হয়।

রিকোয়েস্ট

POST /getToken
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  }
}

রেসপন্স

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

রেসপন্স ফিল্ড

errorId
Integer
রিকোয়েস্ট সফল হলে 0, না হলে 1।
taskId
Integer
টাস্ক id।
status
String
টাস্ক সমাধান চলাকালীন processing, শেষ হলে ready।
solution
Object
উত্তর। এর ফিল্ড টাস্ক টাইপের ওপর নির্ভর করে।
cost
String
এই টাস্কের মূল্য US ডলারে।

কোড উদাহরণ

curl -s https://unlock-api.com/getToken \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","task":{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}}'

এই মেথড যেসব এরর দিতে পারে

  • key ভুল। অ্যাকাউন্ট পেজ থেকে আবার কপি করুন। (in.php ও res.php: ERROR_WRONG_USER_KEY)

  • রিকোয়েস্টটি এমন IP থেকে এসেছে যা অ্যাকাউন্টের অনুমতি তালিকায় নেই। অ্যাকাউন্ট পেজে IP যোগ করুন।

  • এই অ্যাকাউন্ট ব্লক করা হয়েছে। অ্যাকাউন্ট পেজ থেকে সাপোর্টে যোগাযোগ করুন।

  • অনেক বেশি রিকোয়েস্ট। ফলাফল চেক প্রতি 5 সেকেন্ডে একবার করুন।

  • ব্যালেন্সে টাস্কের খরচ মেটানোর মতো টাকা নেই। টাকা যোগ করুন; কোনো চার্জ নেওয়া হয়নি।

  • এই মুহূর্তে অনেক রিকোয়েস্ট, তাই টাস্ক গ্রহণ করা যায়নি। কয়েক সেকেন্ড পরে আবার চেষ্টা করুন; কোনো চার্জ নেওয়া হয়নি।

  • টাস্কের ধরন অজানা বা বন্ধ। ধরনের নাম যাচাই করুন।

  • একটি আবশ্যক ফিল্ড নেই বা তার ফরম্যাট ভুল।

  • websiteURL বা pageurl নেই, অথবা পুরো http(s) ঠিকানা নয়।

  • নির্ধারিত সময়ে টাস্কটি সমাধান করা যায়নি। এর চার্জ আপনার ব্যালেন্সে ফেরত এসেছে।