Périmètre sûr. Ce guide s'applique à vos propres applications 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.
La promo Discord de CaptchaAI vous offre 100 threads gratuits pour éprouver l'extension de navigateur sans engager de budget. Le point délicat n'est pas le clic qui active l'offre : c'est la façon dont vous transformez ces threads en une intégration stable. Ce guide vous mène de l'activation de la promo à une première résolution fiable.
À qui s'adresse la promo 100 threads gratuits
Cette offre vise les équipes qui évaluent un fournisseur de résolution de CAPTCHA avant de l'intégrer. Prenez une équipe QA à Bruxelles qui doit franchir une étape protégée par CAPTCHA dans sa propre préproduction : le premier essai réussit en cinq minutes, mais l'intégration doit tenir à travers déploiements, aléas réseau et changement de famille. Les 100 threads gratuits couvrent cette mise au point. Si vous collectez des données personnelles, minimisez-les et vérifiez vos obligations RGPD.
Architecture d'intégration de l'extension CaptchaAI
Votre composant interne appelle CaptchaAI via HTTPS pour récupérer un token, puis l'injecte dans votre formulaire ou votre route d'API. Traitez l'extension comme un workflow de navigateur reproductible, pas comme un bouton à activer une fois ; tracer chaque étape révèle les régressions.
De l'activation de la promo à la première résolution
- Capturez les entrées du solveur : uniquement les paramètres attendus par la famille de CAPTCHA (sitekey, URL de page, action, proxy éventuel). En stocker plus crée de fausses pistes.
- Envoyez la tâche à
https://ocr.captchaai.com/in.phpavecjson=1. Tout statut différent de1est une erreur à journaliser. - Interrogez le résultat sur
https://ocr.captchaai.com/res.php: attendez 15 s, puis toutes les 5 s, avec un plafond de 120 s par tâche. - Appliquez le token dans la même session que celle ayant déclenché le défi (même navigateur, même client HTTP, même cookie jar). Une session incohérente est la première cause de rejet.
- Mesurez la latence, les retries et l'acceptation en aval : réussite du solveur et réussite du workflow diffèrent.
Configuration des secrets et de la clé API
- La clé CaptchaAI vit dans un coffre (Vault, AWS Secrets Manager…) ou un secret CI, jamais dans le code source.
- Le déploiement la monte en variable d'environnement au runtime.
- Prévoyez une rotation régulière et une alerte de solde pour ne pas épuiser vos threads sans le voir.
Vérifier le solde avec l'API
Exemple côté client, depuis votre propre 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 indicateurs à suivre
- Durée d'obtention du token et code retour HTTP par appel CAPTCHA.
- Identifiant de tâche corrélé à votre traçage distribué (OpenTelemetry).
- Logs séparés par environnement pour rejouer un scénario à partir d'un identifiant unique.
Côté indicateurs, visez une latence médiane sous 25 s pour les CAPTCHA à token et sous 8 s pour l'image/OCR, puis suivez séparément le taux de réussite du solveur et l'acceptation du token en aval. Ces valeurs varient selon l'environnement, le volume et l'heure.
Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_WRONG_USER_KEY |
Clé copiée avec des espaces parasites ou mauvais compte. | Recopiez la clé depuis le tableau de bord, stockez-la en secret CI. |
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche. | Rechargez et ajoutez une alerte de solde. |
ERROR_PAGEURL / ERROR_BAD_PARAMETERS |
Entrée manquante ou mal formée. | Revalidez l'URL de page, le sitekey et les champs du solveur. |
| Token refusé après résolution | Token appliqué dans une session différente. | Gardez la résolution et l'envoi du formulaire dans la même session. |
FAQ
Comment activer la promo 100 threads gratuits sur Discord ?
Rejoignez le serveur Discord officiel de CaptchaAI et suivez les instructions épinglées de l'offre ; le crédit est associé à votre compte. Les modalités exactes figurent sur le canal officiel : vérifiez-les avant de bâtir votre plan de test.
Les 100 threads gratuits remplacent-ils un abonnement payant ?
Non. C'est un crédit destiné à valider votre intégration. Pour la production continue, les plans démarrent à BASIC ($15/mois, 5 threads) et montent jusqu'à VIP-3 ($7,500/mois, 5 000 threads), tous facturés au thread avec résolutions illimitées.
Quels CAPTCHA l'extension peut-elle résoudre ?
Les familles disponibles couvrent reCAPTCHA v2 et v3 (invisible et Enterprise inclus), Cloudflare Turnstile et Challenge, GeeTest v3, l'image/OCR, les grilles d'images et BLS. CaptchaFox (bêta), Friendly Captcha (bêta) et Lemin (bêta) sont en bêta. hCaptcha et FunCaptcha (Arkose Labs) ne sont pas pris en charge.
Guides connexes
- Démarrage rapide CaptchaAI
- QA CAPTCHA en environnements autorisés
- Tester l'endpoint API sur vos formulaires
- Intégration CAPTCHA en continu
- Résoudre reCAPTCHA v2 via l'API
Mettez vos 100 threads gratuits au travail : obtenez votre clé CaptchaAI.
