getToken

Crée une tâche et attend la réponse dans la même requête, jusqu'à 50 secondes. Si la tâche n'est pas terminée à ce moment, la réponse est status processing avec le taskId ; continuez à la vérifier avec getTaskResult. Les callbacks de résultat ne sont pas envoyés pour les tâches getToken.

POSThttps://unlock-api.com/getToken

Réglez le timeout de votre client HTTP au-delà de 60 secondes pour cette méthode.

Paramètres de la requête

clientKey

StringObligatoire

Votre clé API, 32 caractères, depuis la page de compte.

task

ObjectObligatoire

Objet tâche. Son champ type détermine les autres champs nécessaires. Types de tâches

softId

IntegerFacultatif

L'id de votre application, enregistré avec la tâche. appId est accepté comme le même champ.

Requête

POST /getToken

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

Réponse

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

Champs de la réponse

errorId

Integer

0 si la requête a réussi, 1 sinon.

taskId

Integer

Id de la tâche.

status

String

processing pendant la résolution de la tâche, ready quand elle est terminée.

solution

Object

La réponse. Ses champs dépendent du type de tâche.

cost

String

Prix de cette tâche en dollars américains.

Exemples de code

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

Erreurs que cette méthode peut renvoyer

ERROR_KEY_DOES_NOT_EXIST
La clé est incorrecte. Copiez-la de nouveau depuis la page de compte. (in.php et res.php : ERROR_WRONG_USER_KEY)
ERROR_IP_NOT_ALLOWED
La requête provient d'une IP absente de la liste autorisée du compte. Ajoutez l'IP sur la page de compte.
ERROR_IP_BANNED
Ce compte est bloqué. Contactez le support depuis la page de compte.
ERROR_TOO_MANY_REQUESTS
Trop de requêtes. Espacez les vérifications de résultat à une toutes les 5 secondes.
ERROR_ZERO_BALANCE
Le solde ne couvre pas la tâche. Ajoutez des fonds ; rien n'a été facturé.
ERROR_NO_SLOT_AVAILABLE
Trop de requêtes en ce moment, la tâche n'a pas pu être acceptée. Réessayez dans quelques secondes ; rien n'a été facturé.
ERROR_TASK_NOT_SUPPORTED
Le type de tâche est inconnu ou désactivé. Vérifiez le nom du type.
ERROR_BAD_PARAMETERS
Un champ obligatoire est manquant ou mal formaté.
ERROR_PAGEURL
websiteURL ou pageurl est manquant ou n'est pas une adresse http(s) complète.
ERROR_CAPTCHA_UNSOLVABLE
La tâche n'a pas pu être résolue à temps. Son montant est revenu sur votre solde.