Référence de l'API

getTaskResult

Interroger une tâche jusqu'à ce qu'elle soit prête, puis lire le token ou les cookies.

Renvoie l'état courant d'une tâche. Appelez-la de façon répétée jusqu'à ce que status vaille ready ou que la réponse porte une erreur. C'est gratuit à n'importe quelle fréquence dans la limite de débit, et le polling n'influence jamais la résolution.

POST https://api.captchapi.com/getTaskResult
content-type: application/json

Champs de la requête

Champ	Type	Obligatoire	Description
`clientKey`	string	oui	Votre clé API.
`taskId`	string	oui	L'identifiant renvoyé par createTask. Doit appartenir à la même clé.

Champs de la réponse

Champ	Type	Obligatoire	Description
`errorId`	number	toujours	0 si l'appel a réussi, 1 sinon. Testez cette valeur, pas le statut HTTP.
`errorCode`	string	si erreur	Code exploitable par machine, issu de la référence des erreurs.
`errorDescription`	string	si erreur	Explication lisible par un humain. Journalisez-la, ne l'analysez pas.
`status`	string	en général	processing, ready ou failed.
`solution.token`	string	si ready	Le token du CAPTCHA, pour toutes les familles sauf le challenge Cloudflare.
`solution.cookies`	object	si ready	Nom de cookie vers valeur, pour les tâches de challenge Cloudflare. Contient cf_clearance.
`solution.userAgent`	string	si ready	Le User-Agent exact qui a produit la solution. Rejouez avec celui-ci.
`cost`	string	si ready	Ce que cette résolution vous a coûté en dollars, après remise de volume.
`createTime`	number	si ready	Horodatage Unix, en secondes, de la création de la tâche.
`endTime`	number	si ready	Horodatage Unix, en secondes, de la résolution de la tâche.

Résolution en cours

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

Résolue — familles à token

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "0.f3KdXk9v…",
    "type": "turnstile",
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
  },
  "cost": "0.0006",
  "createTime": 1767225600,
  "endTime": 1767225604
}

Résolue — le challenge Cloudflare renvoie des cookies, pas un token

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "type": "cloudflare_challenge",
    "cookies": {
      "cf_clearance": "kL9x…-1767225604-1.2.1.1-Wm…"
    },
    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36"
  },
  "cost": "0.0012",
  "createTime": 1767225600,
  "endTime": 1767225605
}

En échec et remboursée

{
  "errorId": 1,
  "errorCode": "ERROR_TIMEOUT",
  "errorDescription": "The solver did not produce a token within 120s. You have been refunded.",
  "status": "failed"
}

Les résultats sont conservés 5 minutes après la résolution d'une tâche, puis supprimés. Lisez la solution et stockez-la vous-même si vous en avez besoin plus longtemps : nous ne conservons pas les tokens résolus.