Périmètre sûr : ce guide s'applique uniquement à vos propres applications, à vos environnements de QA ou de production, ou à des systèmes que vous êtes autorisé à automatiser. Il ne porte ni sur l'automatisation de sites tiers, ni sur l'anti-détection.
GeeTest v4 est marqué « à venir » dans l'extension CaptchaAI : ce type n'est pas encore pris en charge. L'extension et l'API résolvent GeeTest v3, pas v4. La vraie question n'est donc pas « comment résoudre GeeTest v4 », mais « comment garder un workflow stable sous GeeTest v3, prêt pour v4 ».
Ce que le statut « à venir » signifie
« À venir » : la prise en charge de GeeTest v4 est prévue mais pas encore livrée. Si une page passe à v4, l'extension ne la traitera pas encore. État par type :
| Type | Statut dans l'extension |
|---|---|
| GeeTest v3, reCAPTCHA v2/v3, Cloudflare Turnstile et Challenge, image/OCR, grilles | Pris en charge |
| GeeTest v4 | À venir |
| hCaptcha, FunCaptcha | Non pris en charge |
N'écrivez pas de code supposant que v4 fonctionne déjà.
Ce que l'extension prend déjà en charge
L'extension résout GeeTest v3 en un clic dans Chrome, Edge et Firefox, avec la même clé API que vos scripts — de quoi couvrir la majorité des pages protégées aujourd'hui. La facturation reste au thread : chaque plan, de BASIC ($15/mois, 5 threads) aux paliers VIP, inclut des résolutions illimitées par thread.
Garder le workflow de l'extension stable
Traitez l'extension comme un workflow reproductible, pas un simple bouton. Quatre points font la différence :
- L'état du compte. Clé API et solde valides ; surveillez le solde avant les gros lots.
- Le profil de navigateur. Réutilisez un profil stable plutôt qu'un contexte neuf.
- Le type détecté. Vérifiez qu'il correspond à un type pris en charge (GeeTest v3, pas v4).
- L'après-résolution. Appliquez le token dans la même session que le défi : une session différente est la première cause de rejet.
Gérer la clé API et les secrets
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. Sous RGPD, limitez les données personnelles journalisées : un identifiant de tâche suffit au diagnostic.
Vérifier le solde avant un lot
Un contrôle simple évite qu'un lot échoue en silence faute de solde :
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 chaque appel CAPTCHA : durée d'obtention du token, code retour HTTP, identifiant de tâche, taille de la file interne. Séparez les journaux par environnement et corrélez les identifiants à votre traçage distribué (OpenTelemetry). En cas d'incident, ce réflexe divise par deux le temps de diagnostic — utile pour une équipe QA d'un éditeur SaaS à Lyon qui valide chaque nuit ses formulaires de connexion GeeTest v3.
Liste de contrôle avant la mise en production
- Le périmètre est limité à vos propres applications ou à des sources autorisées.
- La clé CaptchaAI est stockée dans un coffre ou un secret CI, jamais dans le dépôt.
- Le type détecté correspond à un type pris en charge (GeeTest v3, pas v4).
- Durées d'appel, codes retour et retry idempotent tracés à chaque exécution.
Dépannage
| Symptôme | Cause probable | Correctif |
|---|---|---|
ERROR_WRONG_USER_KEY |
Espace parasite dans la clé, ou mauvais compte. | Recopiez la clé et stockez-la en secret CI. |
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche. | Rechargez et ajoutez une alerte de solde. |
| Token refusé après résolution | Token appliqué dans une session différente du défi. | Gardez résolution et soumission dans la même session. |
FAQ
GeeTest v4 est-il déjà pris en charge par l'extension CaptchaAI ?
Non — GeeTest v4 est « à venir » et n'est pas encore résolu. GeeTest v3 l'est, en un clic dans l'extension comme via l'API.
Comment savoir si une page utilise GeeTest v3 ou v4 ?
Inspectez la requête réseau du défi et les paramètres de la page. Dans le doute, testez sur votre environnement : l'extension traite v3 et signale tout type non pris en charge.
Sur quels navigateurs l'extension fonctionne-t-elle ?
Sur Chrome, Edge et Firefox, avec votre clé API existante. Le même compte alimente l'extension et vos scripts.
Devrai-je modifier mon intégration quand GeeTest v4 arrivera ?
CaptchaAI expose une API unique entre les types : à la sortie de v4, vous ajusterez le type de tâche en gardant la même boucle. La facturation au thread ne bouge pas.
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. – Obtenez votre clé CaptchaAI.
