UNLOCK API
createTask

createTask

Membuat tugas dan memulangkan id tugas. Harga jenis tugas diambil daripada baki apabila tugas diterima, dan dikembalikan jika tugas gagal.
POSThttps://unlock-api.com/createTask
Hantar POST dengan Content-Type: application/json. Medan task bergantung pada jenis tugas; lihat Jenis tugas.

Parameter permintaan

clientKey
StringWajib
API key anda, 32 aksara, daripada halaman akaun.
task
ObjectWajib
Objek task. Medan type menentukan medan lain yang diperlukan. Jenis tugas
callbackUrl
StringPilihan
Alamat http(s) awam. Apabila tugas selesai atau gagal, keputusan dihantar ke situ melalui POST sebagai JSON.
softId
IntegerPilihan
Id aplikasi anda, disimpan bersama tugas. appId diterima sebagai medan yang sama.

Permintaan

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

Respons

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

Medan respons

errorId
Integer
0 jika permintaan berjaya, 1 jika tidak.
taskId
Integer
Id tugas.
errorCode
String
Nama ralat apabila errorId ialah 1.
errorDescription
String
Penjelasan ringkas ralat dalam bahasa Inggeris.

Contoh kod

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

Ralat yang boleh dipulangkan oleh kaedah ini