Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications, à vos environnements de QA, de préproduction ou de production, ou à des systèmes pour lesquels vous avez une autorisation écrite. Il ne porte ni sur l'automatisation de sites tiers, ni sur la neutralisation d'anti-bot.
Avant d'autoriser l'extension CaptchaAI dans votre organisation, une équipe achat ou sécurité veut trois réponses : le coût est-il prévisible, le fournisseur répond-il en cas d'incident, et l'intégration tient-elle la charge ? Ce modèle rassemble les points à vérifier lors d'une revue fournisseur, à inscrire dans votre revue de code. CaptchaAI y répond avec une API unique pour toutes les familles de CAPTCHA et une latence stable.
Modèle de coûts : la facturation au thread
C'est le point qui rassure le plus une équipe achat. CaptchaAI facture au thread (un CAPTCHA en cours), pas au CAPTCHA résolu : chaque plan inclut des résolutions illimitées par thread, sans plafond journalier ni surcoût par type. Le plan BASIC ($15/mois, 5 threads) suffit à valider l'intégration ; STANDARD ($30/mois, 15 threads) absorbe les premières charges parallèles. La facturation reste en dollars US, ce qui garde le budget linéaire et prévisible.
Architecture cible et gestion des secrets
Le flux d'intégration
Votre composant interne appelle CaptchaAI via HTTPS pour récupérer un token, puis l'injecte dans votre formulaire ou votre route d'API. Tracer chaque étape révèle les régressions lors des montées de version.
Le stockage de la clé
La clé API vit dans un coffre (Vault, AWS Secrets Manager, Azure Key Vault) ou un secret CI, jamais dans le code source, et se monte en variable d'environnement au runtime.
Le token dans la bonne session
La moitié des échecs vient d'ici : appliquez le token dans la session qui a déclenché le défi (même contexte navigateur, même client HTTP, même cookie jar). Une session dépareillée est la première cause de rejet.
Exemple : vérifier le solde depuis votre suite de tests
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))
Observabilité et journalisation
Instrumentez les appels CAPTCHA : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de la file d'attente. Séparez les journaux par environnement et corrélez chaque identifiant à votre traçage distribué (OpenTelemetry) pour rejouer un scénario complet.
Indicateurs à suivre
Fixez-les comme des objectifs internes à mesurer, pas des seuils imposés :
- Latence de première résolution.
- Taux de réussite par famille de CAPTCHA.
- Écart entre « tâche résolue » et « workflow accepté » — il révèle les vrais problèmes avant vos utilisateurs.
Liste de contrôle avant intégration
- Le périmètre est strictement limité à vos propres applications ou à des sources autorisées.
- La clé API est stockée dans un secret CI ou un coffre, jamais dans le code source.
- Les durées d'appel et les codes retour sont tracés pour chaque exécution.
- Le token est appliqué dans la session qui a déclenché le défi.
- Une stratégie de retry idempotent et plafonnée couvre les erreurs transitoires.
Dépannage des erreurs courantes
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_WRONG_USER_KEY |
Clé copiée avec une espace parasite ou mauvais compte. | Recopiez la clé depuis le tableau de bord et stockez-la en secret CI. |
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche. | Rechargez et ajoutez une alerte de solde. |
ERROR_BAD_PARAMETERS |
Paramètre requis manquant ou mal formé. | Revalidez l'URL de la page et le sitekey face au HTML réel. |
| Token refusé après résolution | Token appliqué dans une autre session. | Gardez résolution et envoi dans le même contexte. |
FAQ
Quels types de CAPTCHA l'extension CaptchaAI prend-elle en charge ?
reCAPTCHA v2 et v3, Cloudflare Turnstile et Challenge, GeeTest v3, le CAPTCHA image/OCR, les grilles et BLS, plus CaptchaFox, Friendly Captcha et Lemin en bêta. hCaptcha et FunCaptcha ne sont pas pris en charge ; GeeTest v4 reste à venir.
Comment estimer le budget mensuel de l'extension ?
Partez du nombre de résolutions simultanées, pas du volume : la facturation au thread inclut des résolutions illimitées. Choisissez le plan selon le parallélisme visé — BASIC ($15/mois, 5 threads) pour valider, un palier au-dessus ensuite.
Peut-on utiliser l'extension sur des sites tiers ?
Non. Les exemples portent sur vos propres applications ou des environnements autorisés par écrit. Pour une source externe, validez d'abord les conditions d'utilisation et la base juridique.
Que doit contenir une revue de sécurité avant adoption ?
Le stockage de la clé, l'isolation des environnements, la traçabilité des appels, le plafonnement des tentatives et une base juridique par source traitée.
Guides connexes
- Le démarrage rapide CaptchaAI
- La QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
- Intégrer la résolution 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.
