Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications, 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 ni l'automatisation de sites tiers, ni le contournement de protections, ni l'évasion d'anti-bot.
Une extension de navigateur n'est fiable que si vous la traitez comme un workflow reproductible, pas comme un simple bouton à activer. Pour l'extension CaptchaAI, cela signifie garder sous contrôle l'état du compte, le type de CAPTCHA pris en charge et le comportement de la page après la résolution. C'est là que se concentrent les surprises et la charge de support.
La watchlist 2026 en un coup d'œil
CaptchaAI expose une seule API pour les familles courantes, avec une facturation par threads : à partir de BASIC ($15/mois, 5 threads), vous payez la concurrence, pas le nombre de résolutions. Revérifiez chaque ligne à chaque mise à jour de l'extension.
| Élément à surveiller | Statut début 2026 | Votre action |
|---|---|---|
| reCAPTCHA v2/v3, Turnstile, Cloudflare Challenge, GeeTest v3, image/OCR et grilles | Pris en charge | Intégrez sans réserve. |
| CaptchaFox (bêta), Friendly Captcha (bêta), Lemin (bêta) | En bêta | Testez à faible volume avant d'en dépendre. |
| GeeTest v4 | À venir, pas encore disponible | Prévoyez une solution de repli. |
| hCaptcha, FunCaptcha (Arkose Labs) | Non pris en charge | Hors périmètre CaptchaAI. |
| Paramètres transmis (sitekey, URL, action) | Stables, à revérifier | Comparez-les au HTML réel après un déploiement. |
Du navigateur au token, étape par étape
- Capturez les bons paramètres. Votre composant interne ne relève que ce que la famille de CAPTCHA attend (sitekey, URL, action). Stocker plus que nécessaire crée de fausses pistes de débogage.
- Appliquez le token dans la même session que celle qui a déclenché le défi — même contexte de navigateur, même client HTTP, même cookie jar. Une session dépareillée est la première cause de rejet.
- Envoyez la tâche via HTTPS, puis interrogez le résultat à intervalle régulier ; traitez tout statut anormal comme une erreur et journalisez la réponse complète.
- Mesurez la latence, les retries et l'acceptation en aval. Prévoyez un retry idempotent (trois tentatives, backoff exponentiel, plafond à 30 s) ; la réussite du solveur et celle du workflow complet restent deux métriques distinctes.
Secrets, clé API et vérification du solde
La clé CaptchaAI vit dans un coffre (HashiCorp Vault, AWS Secrets Manager, Azure Key Vault) ou dans un secret CI, jamais dans le code source ; le déploiement la monte en variable d'environnement au runtime. Si vos workers tournent sur OVHcloud ou Scaleway, gérez sa rotation avec vos autres secrets. Avant un lot, un composant client de votre suite de tests confirme que le solde couvre la charge prévue :
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))
Un solde nul déclenche ERROR_ZERO_BALANCE : ajoutez une alerte sur ce seuil et prévoyez une recharge automatique.
Observabilité et indicateurs à suivre
Séparez les journaux par environnement et corrélez les identifiants à votre traçage distribué (par exemple OpenTelemetry). Côté RGPD, minimisez les données personnelles : un identifiant de tâche suffit à reconstituer un incident. Instrumentez ensuite chaque appel autour des indicateurs suivants.
| Indicateur | Ce qu'il révèle | Seuil d'alerte |
|---|---|---|
| Durée d'obtention du token | Santé de l'intégration | Écart marqué avec votre médiane |
| Code retour HTTP | Erreurs API vs applicatives | Hausse des codes non-2xx |
| Taux de réussite du solveur | Qualité des paramètres transmis | En deçà de votre référence par famille |
| Taux d'acceptation en aval | Cohérence de session token/formulaire | Écart avec la réussite du solveur |
| Taille de la file d'attente | Saturation des threads | File qui croît sans se vider |
FAQ
L'extension CaptchaAI peut-elle s'exécuter côté serveur, sans interface ?
Oui. Un worker headless récupère le token via l'API et l'injecte dans la session qui poursuit le parcours. Seule compte la cohérence de session entre résolution et envoi du formulaire.
Où stocker la clé API sans l'exposer ?
Dans un coffre ou un secret d'intégration continue, monté en variable d'environnement au runtime. Jamais dans le code source ni un dépôt Git versionné. Prévoyez une rotation régulière et une alerte de solde faible.
CaptchaAI prend-il en charge hCaptcha pour ce workflow ?
Non — hCaptcha et FunCaptcha (Arkose Labs) ne sont pas pris en charge. CaptchaAI couvre reCAPTCHA v2/v3, Turnstile et Challenge, GeeTest v3 et les CAPTCHA image/OCR ; GeeTest v4 reste « à venir ».
Guides connexes
- Démarrage rapide CaptchaAI
- QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires web
- Intégrer la résolution de CAPTCHA en CI
- Résoudre reCAPTCHA v2 via l'API
Structurez vos workflows CAPTCHA avec une méthode reproductible et mesurable. – Obtenez votre clé CaptchaAI.
