UNLOCK API
createTask

createTask

Gumagawa ng task at ibinabalik ang id nito. Kinukuha sa balance ang presyo ng task type kapag tinanggap ang task, at ibinabalik kung mag-fail ang task.
POSThttps://unlock-api.com/createTask
Magpadala ng POST na may Content-Type: application/json. Nakadepende sa task type ang mga task field; tingnan ang Mga task type.

Mga request parameter

clientKey
StringRequired
Ang API key mo, 32 character, mula sa account page.
task
ObjectRequired
Task object. Ang type field nito ang nagtatakda kung aling ibang field ang kailangan. Mga task type
callbackUrl
StringOptional
Pampublikong http(s) address. Kapag tapos o nag-fail ang task, ipapadala doon ang resulta sa POST bilang JSON.
softId
IntegerOptional
Ang id ng application mo, naka-save kasama ng task. Tinatanggap din ang appId bilang parehong field.

Request

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

Response

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

Mga response field

errorId
Integer
0 kapag gumana ang request, 1 kapag hindi.
taskId
Integer
Task id.
errorCode
String
Pangalan ng error kapag 1 ang errorId.
errorDescription
String
Maikling paliwanag ng error sa English.

Mga code sample

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")

Mga error na puwedeng ibalik ng method na ito