getToken

Crea un task e attende la risposta nella stessa richiesta, fino a 50 secondi. Se il task non è completato entro quel tempo, la risposta è status processing con il taskId; continua a controllarlo con getTaskResult. Per i task getToken non vengono inviati callback del risultato.

POSThttps://unlock-api.com/getToken

Imposta il timeout del tuo client HTTP oltre 60 secondi per questo metodo.

Parametri della richiesta

clientKey

StringObbligatorio

La tua chiave API, 32 caratteri, dalla pagina account.

task

ObjectObbligatorio

Oggetto task. Il suo campo type determina quali altri campi servono. Tipi di task

softId

IntegerFacoltativo

L'id della tua applicazione, salvato con il task. appId è accettato come lo stesso campo.

Richiesta

POST /getToken

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

Risposta

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

Campi della risposta

errorId

Integer

0 se la richiesta è andata a buon fine, 1 in caso contrario.

taskId

Integer

Id del task.

status

String

processing mentre il task è in risoluzione, ready quando è completato.

solution

Object

La risposta. I suoi campi dipendono dal tipo di task.

cost

String

Prezzo di questo task in dollari USA.

Esempi di codice

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

Errori che questo metodo può restituire

ERROR_KEY_DOES_NOT_EXIST
La chiave è errata. Copiala di nuovo dalla pagina account. (in.php e res.php: ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
La richiesta arriva da un IP che non è nella lista consentiti dell'account. Aggiungi l'IP nella pagina account.
ERROR_IP_BANNED
Questo account è bloccato. Contatta il supporto dalla pagina account.
ERROR_TOO_MANY_REQUESTS
Troppe richieste. Rallenta i controlli dei risultati a uno ogni 5 secondi.
ERROR_ZERO_BALANCE
Il saldo non copre il task. Aggiungi fondi; non è stato addebitato nulla.
ERROR_NO_SLOT_AVAILABLE
Troppe richieste in questo momento, il task non è stato accettato. Riprova tra qualche secondo; non è stato addebitato nulla.
ERROR_TASK_NOT_SUPPORTED
Il tipo di task è sconosciuto o disattivato. Controlla il nome del tipo.
ERROR_BAD_PARAMETERS
Un campo obbligatorio manca o ha un formato errato.
ERROR_PAGEURL
websiteURL o pageurl manca o non è un indirizzo http(s) completo.
ERROR_CAPTCHA_UNSOLVABLE
Il task non è stato risolto in tempo. L'importo è tornato sul saldo.