createTask

Bắt đầu

Phương thức JSON

Hướng dẫn

Tác vụ token

Tác vụ ảnh và âm thanh

createTask

Tạo tác vụ và trả về id của nó. Giá của loại tác vụ bị trừ khỏi số dư khi tác vụ được nhận, và được hoàn lại nếu tác vụ lỗi.

POSThttps://unlock-api.com/createTask

Gửi POST với Content-Type: application/json. Các trường của task phụ thuộc vào loại tác vụ; xem Loại tác vụ.

Tham số request

clientKey

StringBắt buộc

API key của bạn, 32 ký tự, có trên trang tài khoản.

task

ObjectBắt buộc

Object tác vụ. Trường type của nó quyết định cần những trường nào khác. Loại tác vụ

callbackUrl

StringTùy chọn

Địa chỉ http(s) công khai. Khi tác vụ xong hoặc lỗi, kết quả được gửi tới đó bằng POST dưới dạng JSON.

softId

IntegerTùy chọn

Id ứng dụng của bạn, được lưu cùng tác vụ. appId cũng được nhận như cùng một trường.

Request

POST /createTask

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

Phản hồi

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

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

Trường phản hồi

errorId

Integer

0 khi request thành công, 1 khi không thành công.

taskId

Integer

Id tác vụ.

errorCode

String

Tên lỗi khi errorId là 1.

errorDescription

String

Giải thích ngắn về lỗi bằng tiếng Anh.

Code mẫu

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

Các lỗi phương thức này có thể trả về

ERROR_KEY_DOES_NOT_EXIST
Key sai. Hãy sao chép lại từ trang tài khoản. (in.php và res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
Request đến từ IP không có trong danh sách được phép của tài khoản. Hãy thêm IP trên trang tài khoản.
ERROR_IP_BANNED
Tài khoản này đã bị khóa. Liên hệ hỗ trợ từ trang tài khoản.
ERROR_TOO_MANY_REQUESTS
Quá nhiều request. Hãy giãn lượt kiểm tra kết quả ra mỗi 5 giây.
ERROR_ZERO_BALANCE
Số dư không đủ cho tác vụ. Hãy nạp thêm; chưa có khoản nào bị trừ.
ERROR_NO_SLOT_AVAILABLE
Hiện có quá nhiều request nên không nhận được tác vụ. Thử lại sau vài giây; chưa có khoản nào bị trừ.
ERROR_TASK_NOT_SUPPORTED
Loại tác vụ không xác định hoặc đang tắt. Kiểm tra lại tên loại.
ERROR_BAD_PARAMETERS
Thiếu một trường bắt buộc hoặc trường sai định dạng.
ERROR_PAGEURL
Thiếu websiteURL hoặc pageurl, hoặc không phải địa chỉ http(s) đầy đủ.
ERROR_BAD_PROXY
Tác vụ có proxy cần proxyAddress và proxyPort.
ERROR_ZERO_CAPTCHA_FILESIZE
Thiếu ảnh hoặc ảnh quá nhỏ.
ERROR_TOO_BIG_CAPTCHA_FILESIZE
Ảnh lớn hơn 100 KB.
ERROR_IMAGE_TYPE_NOT_SUPPORTED
Ảnh không phải base64 hợp lệ.

createTask

Tham số request

Request

Phản hồi

Trường phản hồi

Code mẫu

Các lỗi phương thức này có thể trả về

Đăng nhập bằng token tài khoản

Đăng nhập bằng token tài khoản