L'écran des options de compte de l'extension CaptchaAI

Périmètre sûr : ce guide s'applique uniquement à vos propres applications et à vos environnements de QA, de préproduction ou de production, ou à des systèmes pour lesquels vous disposez d'une autorisation écrite. Il ne décrit pas l'automatisation de sites tiers que vous ne contrôlez pas.

L'écran des options de compte est le poste de pilotage de l'extension CaptchaAI : c'est là que vous renseignez votre clé API, choisissez le handler qui traite chaque défi CAPTCHA, rattachez un profil de navigateur et fixez le comportement une fois le token obtenu. Bien réglé, il fiabilise vos workflows ; mal réglé, il devient votre première source de tickets de support.

Ce que contrôle l'écran des options de compte

Quatre réglages déterminent le comportement quotidien de l'extension :

• La clé API authentifie vos requêtes et rattache la consommation à votre compte.
• Le handler CAPTCHA indique quel type de défi l'extension prend en charge : reCAPTCHA v2, reCAPTCHA v3, Cloudflare Turnstile, image/OCR, entre autres.
• Le profil de navigateur isole cookies et session, pour appliquer le token dans le contexte qui a déclenché le défi.
• Le comportement après résolution définit la suite : soumission du formulaire, étape suivante ou restitution du token à votre script.

Renseigner la clé API sans la coder en dur

Ne collez jamais votre clé API en clair dans un dépôt. Stockez-la dans un coffre (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) ou dans un secret CI, puis montez-la en variable d'environnement à l'exécution.

Vérifier le solde depuis votre suite de tests

Avant une campagne de tests, vérifiez que le compte dispose d'un solde suffisant. L'appel ci-dessous, lancé depuis votre suite de tests, renvoie le solde courant :

import os
import requests

API_KEY = os.environ['CAPTCHAAI_KEY']

def get_balance() -> float:
    resp = requests.post(
        'https://api.captchaai.com/getBalance',
        json={'clientKey': API_KEY},
        timeout=15,
    )
    resp.raise_for_status()
    return float(resp.json().get('balance', 0))

Branchez ce contrôle en début de pipeline : un solde à zéro renvoie des ERROR_ZERO_BALANCE, faciles à confondre avec un problème de configuration.

Tracer chaque appel pour un diagnostic rapide

Quel que soit le handler, instrumentez les appels CAPTCHA pour obtenir des métriques : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de la file d'attente. Ces signaux nourrissent vos tableaux de bord de QA et déclenchent vos alertes avant toute dérive. Héberger le worker près de vos cibles (OVHcloud ou Scaleway) réduit la latence.

Séparer les journaux par environnement

Cloisonnez les journaux entre développement, préproduction et production et corrélez chaque identifiant à votre traçage distribué (OpenTelemetry). Côté conformité, journalisez le strict nécessaire pour respecter vos obligations RGPD.

Liste de contrôle avant la mise en production

• Le périmètre reste limité à vos applications ou à des sources autorisées.
• La clé API est stockée dans un coffre ou un secret CI, jamais dans le code source.
• Le handler CAPTCHA correspond bien au type de défi présent sur la page cible.
• Les durées d'appel et codes retour sont tracés pour chaque exécution.
• Un retry idempotent avec backoff exponentiel borné couvre les erreurs transitoires.

Dépannage

FAQ

Où trouver ma clé API pour l'écran des options de compte ?

Dans votre tableau de bord CaptchaAI, à la section clé API. Copiez-la sans espace superflu et stockez-la dans un secret CI. Une clé collée avec un espace parasite déclenche des erreurs ERROR_WRONG_USER_KEY.

Le token est refusé après résolution : que vérifier en premier ?

Vérifiez qu'il est appliqué dans la même session que celle qui a déclenché le défi : même profil de navigateur, même client HTTP, même jar de cookies. Un changement de contexte reste la cause la plus fréquente de rejet.

Puis-je réutiliser cette configuration sur une autre pile technique ?

Oui. La logique reste identique quel que soit le langage : isolez l'environnement, tracez les appels, mesurez les délais et le taux de réussite. Les exemples sont en Python et Node.js, mais se transposent vers Go ou Java.

CaptchaAI prend-il en charge tous les types de CAPTCHA depuis l'extension ?

Elle couvre les familles principales : reCAPTCHA v2 et v3, Cloudflare Turnstile et Cloudflare Challenge, GeeTest v3, image/OCR et grilles, plus CaptchaFox (bêta), Friendly Captcha (bêta) et Lemin (bêta). hCaptcha et FunCaptcha ne sont pas pris en charge ; GeeTest v4 est annoncé comme à venir.

Guides connexes

• le démarrage rapide CaptchaAI
• la QA CAPTCHA en environnement autorisé
• tester l'endpoint API sur vos formulaires
• intégrer la résolution CAPTCHA en CI
• résoudre reCAPTCHA v2 via l'API

Réglez l'écran des options de compte une fois, puis fiabilisez vos workflows CAPTCHA. – Obtenez votre clé CaptchaAI.