createTask

Erste Schritte

JSON-Methoden

Anleitungen

Token-Aufgaben

Bild- und Audioaufgaben

createTask

Erstellt eine Aufgabe und gibt ihre ID zurück. Der Preis des Aufgabentyps wird beim Annehmen der Aufgabe vom Guthaben abgebucht und erstattet, wenn die Aufgabe fehlschlägt.

POSThttps://unlock-api.com/createTask

Senden Sie POST mit Content-Type: application/json. Die Felder der Aufgabe hängen vom Aufgabentyp ab; siehe Aufgabentypen.

Anfrageparameter

clientKey

StringPflicht

Ihr API-Schlüssel, 32 Zeichen, von der Kontoseite.

task

ObjectPflicht

Aufgabenobjekt. Sein Feld type legt fest, welche weiteren Felder nötig sind. Aufgabentypen

callbackUrl

StringOptional

Öffentliche http(s)-Adresse. Ist die Aufgabe fertig oder fehlgeschlagen, wird das Ergebnis per POST als JSON dorthin gesendet.

softId

IntegerOptional

ID Ihrer Anwendung, wird mit der Aufgabe gespeichert. appId wird als dasselbe Feld akzeptiert.

Anfrage

POST /createTask

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

Antwort

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

{
  "errorId": 1,
  "errorCode": "ERROR_ZERO_BALANCE",
  "errorDescription": "Your balance is too low for this task. Add funds and try again."
}

Antwortfelder

errorId

Integer

0, wenn die Anfrage erfolgreich war, 1, wenn nicht.

taskId

Integer

ID der Aufgabe.

errorCode

String

Fehlername, wenn errorId 1 ist.

errorDescription

String

Kurze Erklärung des Fehlers auf Englisch.

Codebeispiele

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

const API = "https://unlock-api.com";
const KEY = "YOUR_API_KEY";
const post = (path, body) => fetch(API + path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) }).then((r) => r.json());

const task = await post("/createTask", {
  clientKey: KEY,
  task: {
    "type": "TurnstileTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
  },
});
if (task.errorId) throw new Error(task.errorCode);

let solution = null;
for (let n = 0; n < 60 && !solution; n++) { // 60 x 5 s = the 5 minute task limit
  await new Promise((r) => setTimeout(r, 5000));
  const r = await post("/getTaskResult", { clientKey: KEY, taskId: task.taskId });
  if (r.errorId) throw new Error(r.errorCode + ": " + r.errorDescription); // failed tasks are refunded
  if (r.status === "ready") solution = r.solution;
}
if (!solution) throw new Error("timed out");
console.log(solution.token);

<?php
$api = "https://unlock-api.com";
$key = "YOUR_API_KEY";
function post($url, $body) {
  $c = curl_init($url);
  curl_setopt_array($c, [CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json"], CURLOPT_POSTFIELDS => json_encode($body)]);
  return json_decode(curl_exec($c), true);
}
$task = post("$api/createTask", ["clientKey" => $key, "task" => json_decode('{"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}', true)]);
if ($task["errorId"]) exit($task["errorCode"]);
for ($n = 0; $n < 60; $n++) { // 60 x 5 s = the 5 minute task limit
  sleep(5);
  $r = post("$api/getTaskResult", ["clientKey" => $key, "taskId" => $task["taskId"]]);
  if ($r["errorId"]) exit($r["errorCode"] . ": " . $r["errorDescription"]); // failed tasks are refunded
  if ($r["status"] === "ready") break;
}
if ($r["status"] !== "ready") exit("timed out");
print_r($r["solution"]["token"]);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"time"
)

const api = "https://unlock-api.com"
const key = "YOUR_API_KEY"

func post(method string, body map[string]any) map[string]any {
	b, _ := json.Marshal(body)
	res, err := http.Post(api+"/"+method, "application/json", bytes.NewReader(b))
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	var out map[string]any
	json.NewDecoder(res.Body).Decode(&out)
	return out
}

func main() {
	task := post("createTask", map[string]any{
		"clientKey": key,
		"task": map[string]any{
			"type": "TurnstileTaskProxyless",
			"websiteURL": "https://example.com/login",
			"websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN",
		},
	})
	if task["errorId"].(float64) != 0 {
		panic(task["errorCode"])
	}
	for n := 0; n < 60; n++ { // 60 x 5 s = the 5 minute task limit
		time.Sleep(5 * time.Second)
		r := post("getTaskResult", map[string]any{"clientKey": key, "taskId": task["taskId"]})
		if r["errorId"].(float64) != 0 {
			panic(r["errorCode"]) // failed tasks are refunded
		}
		if r["status"] == "ready" {
			fmt.Println(r["solution"])
			return
		}
	}
	panic("timed out")
}

import java.net.URI;
import java.net.http.*;
import java.util.regex.*;

public class Solve {
  static final String API = "https://unlock-api.com", KEY = "YOUR_API_KEY";
  static final HttpClient HTTP = HttpClient.newHttpClient();

  static String post(String method, String json) throws Exception {
    var req = HttpRequest.newBuilder(URI.create(API + "/" + method))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json)).build();
    return HTTP.send(req, HttpResponse.BodyHandlers.ofString()).body();
  }

  public static void main(String[] args) throws Exception {
    String task = "{\"type\":\"TurnstileTaskProxyless\",\"websiteURL\":\"https://example.com/login\",\"websiteKey\":\"0x4AAAAAAAC3DHQFLr1GavRN\"}";
    String created = post("createTask", "{\"clientKey\":\"" + KEY + "\",\"task\":" + task + "}");
    Matcher id = Pattern.compile("\"taskId\":(\\d+)").matcher(created);
    if (!id.find()) throw new RuntimeException(created);
    for (int n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
      Thread.sleep(5000);
      String r = post("getTaskResult", "{\"clientKey\":\"" + KEY + "\",\"taskId\":" + id.group(1) + "}");
      if (r.contains("\"errorId\":1")) throw new RuntimeException(r); // failed tasks are refunded
      if (r.contains("\"status\":\"ready\"")) { System.out.println(r); return; }
    }
    throw new RuntimeException("timed out");
  }
}

using System.Net.Http.Json;
using System.Text.Json;

const string Api = "https://unlock-api.com";
const string Key = "YOUR_API_KEY";
var http = new HttpClient();

async Task<JsonElement> Post(string method, object body) =>
    await (await http.PostAsJsonAsync($"{Api}/{method}", body)).Content.ReadFromJsonAsync<JsonElement>();

var task = await Post("createTask", new {
    clientKey = Key,
    task = JsonSerializer.Deserialize<JsonElement>("""
        {"type":"TurnstileTaskProxyless","websiteURL":"https://example.com/login","websiteKey":"0x4AAAAAAAC3DHQFLr1GavRN"}
        """)
});
if (task.GetProperty("errorId").GetInt32() != 0) throw new Exception(task.GetProperty("errorCode").GetString());

for (var n = 0; n < 60; n++) { // 60 x 5 s = the 5 minute task limit
    await Task.Delay(5000);
    var r = await Post("getTaskResult", new { clientKey = Key, taskId = task.GetProperty("taskId").GetInt64() });
    if (r.GetProperty("errorId").GetInt32() != 0) throw new Exception(r.GetProperty("errorCode").GetString()); // failed tasks are refunded
    if (r.GetProperty("status").GetString() == "ready") { Console.WriteLine(r.GetProperty("solution")); return; }
}
throw new Exception("timed out");

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

curl -s https://unlock-api.com/getTaskResult \
  -H "Content-Type: application/json" \
  -d '{"clientKey":"YOUR_API_KEY","taskId":1001}'
# {"errorId":0,"status":"processing"}  then  {"errorId":0,"status":"ready","solution":{...},"cost":"0.001"}

Mögliche Fehler dieser Methode

ERROR_KEY_DOES_NOT_EXIST
Der Schlüssel ist falsch. Kopieren Sie ihn erneut von der Kontoseite. (in.php und res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
Die Anfrage kam von einer IP, die nicht auf der Freigabeliste des Kontos steht. Fügen Sie die IP auf der Kontoseite hinzu.
ERROR_IP_BANNED
Dieses Konto ist gesperrt. Wenden Sie sich über die Kontoseite an den Support.
ERROR_TOO_MANY_REQUESTS
Zu viele Anfragen. Fragen Sie Ergebnisse nur alle 5 Sekunden ab.
ERROR_ZERO_BALANCE
Das Guthaben reicht für die Aufgabe nicht aus. Laden Sie Guthaben auf; es wurde nichts berechnet.
ERROR_NO_SLOT_AVAILABLE
Gerade zu viele Anfragen, die Aufgabe konnte nicht angenommen werden. Versuchen Sie es in einigen Sekunden erneut; es wurde nichts berechnet.
ERROR_TASK_NOT_SUPPORTED
Der Aufgabentyp ist unbekannt oder deaktiviert. Prüfen Sie den Typnamen.
ERROR_BAD_PARAMETERS
Ein Pflichtfeld fehlt oder hat das falsche Format.
ERROR_PAGEURL
websiteURL oder pageurl fehlt oder ist keine vollständige http(s)-Adresse.
ERROR_BAD_PROXY
Eine Proxy-Aufgabe benötigt proxyAddress und proxyPort.
ERROR_ZERO_CAPTCHA_FILESIZE
Das Bild fehlt oder ist zu klein.
ERROR_TOO_BIG_CAPTCHA_FILESIZE
Das Bild ist größer als 100 KB.
ERROR_IMAGE_TYPE_NOT_SUPPORTED
Das Bild ist kein gültiges base64.

createTask

Anfrageparameter

Anfrage

Antwort

Antwortfelder

Codebeispiele

Mögliche Fehler dieser Methode

Mit Konto-Token anmelden

Mit Konto-Token anmelden