UNLOCK API
createTask

createTask

टास्क बनाता है और उसकी id लौटाता है। टास्क स्वीकार होने पर उस टास्क टाइप की कीमत बैलेंस से कटती है, और टास्क फेल होने पर वापस आती है।
POSThttps://unlock-api.com/createTask
Content-Type: application/json के साथ POST भेजें। टास्क फील्ड टास्क टाइप पर निर्भर करते हैं; टास्क टाइप देखें।

रिक्वेस्ट पैरामीटर

clientKey
Stringज़रूरी
आपकी API key, 32 कैरेक्टर, अकाउंट पेज से।
task
Objectज़रूरी
टास्क ऑब्जेक्ट। इसका type फील्ड तय करता है कि और कौन से फील्ड चाहिए। टास्क टाइप
callbackUrl
Stringवैकल्पिक
पब्लिक http(s) एड्रेस। टास्क पूरा या फेल होने पर नतीजा वहां POST से JSON में भेजा जाता है।
softId
Integerवैकल्पिक
आपके ऐप्लिकेशन की id, टास्क के साथ सेव होती है। appId को भी इसी फील्ड के रूप में स्वीकार किया जाता है।

रिक्वेस्ट

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

रिस्पॉन्स

{
  "errorId": 0,
  "taskId": 1001
}

रिस्पॉन्स फील्ड

errorId
Integer
रिक्वेस्ट सफल होने पर 0, नहीं तो 1।
taskId
Integer
टास्क id।
errorCode
String
errorId 1 होने पर एरर का नाम।
errorDescription
String
अंग्रेज़ी में एरर की छोटी व्याख्या।

कोड उदाहरण

import time, requests

API = "https://unlock-api.com"
KEY = "YOUR_API_KEY"

task = requests.post(f"{API}/createTask", json={
    "clientKey": KEY,
    "task": {
      "type": "TurnstileTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
}).json()
if task["errorId"]:
    raise SystemExit(task["errorCode"])

for _ in range(60):   # 60 x 5 s = the 5 minute task limit
    time.sleep(5)
    r = requests.post(f"{API}/getTaskResult", json={"clientKey": KEY, "taskId": task["taskId"]}).json()
    if r["errorId"]:
        raise SystemExit(f"{r['errorCode']}: {r.get('errorDescription', '')}")   # failed tasks are refunded
    if r["status"] == "ready":
        print(r["solution"]["token"])
        break
else:
    raise SystemExit("timed out")

यह मेथड कौन से एरर लौटा सकता है

  • key गलत है। इसे अकाउंट पेज से फिर से कॉपी करें। (in.php और res.php: ERROR_WRONG_USER_KEY)

  • रिक्वेस्ट ऐसे IP से आई जो अकाउंट की allow list में नहीं है। अकाउंट पेज पर IP जोड़ें।

  • यह अकाउंट ब्लॉक है। अकाउंट पेज से सपोर्ट से संपर्क करें।

  • बहुत ज़्यादा रिक्वेस्ट। नतीजा चेक करने की रफ्तार घटाकर हर 5 सेकंड में एक बार करें।

  • बैलेंस टास्क के लिए काफी नहीं है। पैसे जोड़ें; कोई चार्ज नहीं लगा।

  • अभी बहुत ज़्यादा रिक्वेस्ट हैं, इसलिए टास्क स्वीकार नहीं हो सका। कुछ सेकंड में फिर से कोशिश करें; कोई चार्ज नहीं लगा।

  • टास्क type अनजान है या बंद है। type का नाम जांचें।

  • कोई ज़रूरी फील्ड नहीं है या उसका फॉर्मेट गलत है।

  • websiteURL या pageurl नहीं है, या पूरा http(s) एड्रेस नहीं है।

  • Proxy टास्क के लिए proxyAddress और proxyPort ज़रूरी हैं।

  • इमेज नहीं है या बहुत छोटी है।

  • इमेज 100 KB से बड़ी है।

  • इमेज सही base64 नहीं है।