getToken

Cria uma tarefa e espera a resposta na mesma requisição, por até 50 segundos. Se a tarefa não terminar nesse tempo, a resposta é status processing com o taskId; continue consultando com getTaskResult. Callbacks de resultado não são enviados para tarefas de getToken.

POSThttps://unlock-api.com/getToken

Configure o timeout do seu cliente HTTP acima de 60 segundos para este método.

Parâmetros da requisição

clientKey

StringObrigatório

Sua chave de API, com 32 caracteres, da página da conta.

task

ObjectObrigatório

Objeto da tarefa. O campo type define quais outros campos são necessários. Tipos de tarefa

softId

IntegerOpcional

O id da sua aplicação, salvo com a tarefa. appId é aceito como o mesmo campo.

Requisição

POST /getToken

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

Resposta

{
  "errorId": 0,
  "taskId": 1001,
  "status": "ready",
  "solution": {
    "token": "0.zrSnRHO7h0HwSjSCU8oyzbjEtD8p..."
  },
  "cost": "0.00055",
  "createTime": 1791640000,
  "endTime": 1791640011,
  "solveCount": 1
}

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

Campos da resposta

errorId

Integer

0 quando a requisição deu certo, 1 quando não deu.

taskId

Integer

Id da tarefa.

status

String

processing enquanto a tarefa está sendo resolvida, ready quando termina.

solution

Object

A resposta. Os campos dependem do tipo de tarefa.

cost

String

Preço desta tarefa em dólares americanos.

Exemplos de código

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

import requests

r = requests.post("https://unlock-api.com/getToken", json={
    "clientKey": "YOUR_API_KEY",
    "task": {
        "type": "TurnstileTaskProxyless",
        "websiteURL": "https://example.com/login",
        "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
}).json()
print(r)

const r = await fetch("https://unlock-api.com/getToken", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "TurnstileTaskProxyless",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAAC3DHQFLr1GavRN"
    }
  }),
}).then((res) => res.json());
console.log(r);

Erros que este método pode retornar

ERROR_KEY_DOES_NOT_EXIST
A chave está errada. Copie de novo na página da conta. (in.php e res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
A requisição veio de um IP que não está na lista de permitidos da conta. Adicione o IP na página da conta.
ERROR_IP_BANNED
Esta conta está bloqueada. Fale com o suporte pela página da conta.
ERROR_TOO_MANY_REQUESTS
Muitas requisições. Diminua as consultas de resultado para uma a cada 5 segundos.
ERROR_ZERO_BALANCE
O saldo não cobre a tarefa. Adicione saldo; nada foi cobrado.
ERROR_NO_SLOT_AVAILABLE
Muitas requisições agora, então a tarefa não pôde ser aceita. Tente de novo em alguns segundos; nada foi cobrado.
ERROR_TASK_NOT_SUPPORTED
O tipo de tarefa é desconhecido ou está desativado. Confira o nome do tipo.
ERROR_BAD_PARAMETERS
Falta um campo obrigatório ou ele está no formato errado.
ERROR_PAGEURL
websiteURL ou pageurl está faltando ou não é um endereço http(s) completo.
ERROR_CAPTCHA_UNSOLVABLE
A tarefa não pôde ser resolvida a tempo. O valor voltou para o seu saldo.