getToken

Crea una tarea y espera la respuesta en la misma solicitud, hasta 50 segundos. Si la tarea no termina en ese tiempo, la respuesta es status processing con el taskId; sigue consultándola con getTaskResult. Los callbacks de resultado no se envían para las tareas de getToken.

POSThttps://unlock-api.com/getToken

Configura el tiempo de espera de tu cliente HTTP en más de 60 segundos para este método.

Parámetros de la solicitud

clientKey

StringObligatorio

Tu clave API, de 32 caracteres, de la página de cuenta.

task

ObjectObligatorio

Objeto de tarea. Su campo type define qué otros campos se necesitan. Tipos de tarea

softId

IntegerOpcional

El id de tu aplicación, guardado con la tarea. appId se acepta como el mismo campo.

Solicitud

POST /getToken

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

Respuesta

{
  "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 de la respuesta

errorId

Integer

0 si la solicitud funcionó, 1 si no.

taskId

Integer

Id de la tarea.

status

String

processing mientras la tarea se resuelve, ready cuando termina.

solution

Object

La respuesta. Sus campos dependen del tipo de tarea.

cost

String

Precio de esta tarea en dólares estadounidenses.

Ejemplos 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);

Errores que puede devolver este método

ERROR_KEY_DOES_NOT_EXIST
La clave es incorrecta. Cópiala de nuevo desde la página de cuenta. (in.php y res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
La solicitud vino de una IP que no está en la lista de permitidas de la cuenta. Agrega la IP en la página de cuenta.
ERROR_IP_BANNED
Esta cuenta está bloqueada. Contacta con soporte desde la página de cuenta.
ERROR_TOO_MANY_REQUESTS
Demasiadas solicitudes. Espacia las consultas de resultado a una cada 5 segundos.
ERROR_ZERO_BALANCE
El saldo no alcanza para la tarea. Agrega fondos; no se cobró nada.
ERROR_NO_SLOT_AVAILABLE
Hay demasiadas solicitudes en este momento, por eso no se pudo aceptar la tarea. Inténtalo de nuevo en unos segundos; no se cobró nada.
ERROR_TASK_NOT_SUPPORTED
El tipo de tarea es desconocido o está desactivado. Revisa el nombre del tipo.
ERROR_BAD_PARAMETERS
Falta un campo obligatorio o tiene un formato incorrecto.
ERROR_PAGEURL
Falta websiteURL o pageurl, o no es una dirección http(s) completa.
ERROR_CAPTCHA_UNSOLVABLE
La tarea no se pudo resolver a tiempo. Su cobro ya volvió a tu saldo.