Démarrage rapide

CaptchAPI n'a aucun SDK à installer. Toute intégration se résume à deux requêtes POST vers deux endpoints JSON : vous pouvez donc être opérationnel depuis curl avant même de décider d'écrire un client.

Obtenir une clé

Créez un compte, ouvrez le tableau de bord et générez une clé API. La clé complète n'est affichée qu'une fois — enregistrez-la immédiatement dans votre gestionnaire de secrets. Ensuite vous n'en verrez plus qu'un préfixe d'affichage, parce que nous n'en conservons qu'une empreinte SHA-256.

Créer une tâche

Envoyez le type de tâche, l'URL de la page et la sitekey. Vous recevez un taskId immédiatement ; la résolution se fait de manière asynchrone. Votre portefeuille est débité à cet instant et recrédité si la tâche échoue.

curl https://api.captchapi.com/createTask \
  -H 'content-type: application/json' \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "task": {
      "type": "TurnstileTokenProxyLess",
      "websiteURL": "https://example.com/login",
      "websiteKey": "0x4AAAAAAADnPIDROrmt1Wwj"
    }
  }'

{
  "errorId": 0,
  "taskId": "9f2c4b1e-6f0a-4d5e-b6c1-2f7a9d3e51c8"
}

Interroger le résultat

Demandez le résultat jusqu'à ce que le statut passe de processing à ready. Attendez environ 1,5 seconde avant la première interrogation, puis toutes les 0,5 seconde — le polling est gratuit, mais une boucle serrée atteindra la limite de débit.

curl https://api.captchapi.com/getTaskResult \
  -H 'content-type: application/json' \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "9f2c4b1e-6f0a-4d5e-b6c1-2f7a9d3e51c8"
  }'

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

Utiliser la solution

Soumettez solution.token dans le champ de formulaire que le widget aurait rempli — cf-turnstile-response pour Turnstile, g-recaptcha-response pour reCAPTCHA, h-captcha-response pour hCaptcha. Les tâches de challenge Cloudflare renvoient des cookies plutôt qu'un token : rejouez-les avec le userAgent exact fourni dans la même réponse.

Les tokens sont à usage unique et de courte durée. La plupart expirent moins de deux minutes après leur émission : résolvez au moment où vous en avez besoin plutôt que de préchauffer un stock.