UNLOCK API
createTask

createTask

Membuat tugas dan mengembalikan id-nya. Harga tipe tugas dipotong dari saldo saat tugas diterima, dan dikembalikan jika tugas gagal.
POSThttps://unlock-api.com/createTask
Kirim POST dengan Content-Type: application/json. Field task bergantung pada tipe tugas; lihat Tipe tugas.

Parameter request

clientKey
StringWajib
API key Anda, 32 karakter, dari halaman akun.
task
ObjectWajib
Objek task. Field type-nya menentukan field lain yang diperlukan. Tipe tugas
callbackUrl
StringOpsional
Alamat http(s) publik. Saat tugas selesai atau gagal, hasilnya dikirim ke sana lewat POST sebagai JSON.
softId
IntegerOpsional
Id aplikasi Anda, disimpan bersama tugas. appId diterima sebagai field yang sama.

Request

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

Respons

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

Field respons

errorId
Integer
0 jika request berhasil, 1 jika tidak.
taskId
Integer
Id tugas.
errorCode
String
Nama error jika errorId bernilai 1.
errorDescription
String
Penjelasan singkat error dalam bahasa Inggris.

Contoh kode

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

Error yang bisa dikembalikan metode ini