Extension CaptchaAI ou API : quand utiliser laquelle

Périmètre sûr : ce guide s'applique à vos propres applications, à vos environnements de QA, de préproduction ou de production, ou à des systèmes que vous êtes autorisé à tester. Il ne couvre ni l'automatisation de sites tiers, ni la neutralisation de protections anti-bot.

La réponse courte : choisissez l'extension de navigateur quand un humain pilote la session, et l'API quand un programme s'en charge. L'extension CaptchaAI vit dans Chrome ou Firefox et injecte le token dans la page ; l'API s'appelle depuis votre code et renvoie un token que vous traitez. Tout le reste — effort d'intégration, volume, observabilité — découle de ce choix.

Extension et API : la différence en pratique

L'extension est une surface interactive : installation en quelques secondes, aucun code, et le défi CAPTCHA rempli dans l'onglet actif. C'est l'outil du testeur qui vérifie un formulaire à la main.

L'API est une surface programmable : vous soumettez une tâche, vous interrogez le résultat, votre script applique le token. C'est l'outil du worker, du job planifié et de la CI, sans interface graphique.

Quand privilégier l'extension

L'extension convient dès qu'un opérateur est devant l'écran :

• QA manuelle : vous validez un parcours protégé par un CAPTCHA sans écrire de code.
• Usage ponctuel : quelques résolutions par jour, sans pipeline à maintenir.
• Profils non techniques : un membre de l'équipe support ou produit qui ne touche pas au code.

Le token reste dans la bonne session : le même navigateur déclenche et résout le défi.

Quand l'API s'impose

Dès que le volume grimpe ou qu'aucun humain n'est dans la boucle, l'API devient la seule option viable :

• Automatisation headless : un worker déployé sur OVHcloud ou Scaleway n'a pas de navigateur graphique.
• CI/CD : vos tests de bout en bout traversent une étape protégée à chaque exécution.
• Fort débit : plusieurs résolutions simultanées, avec métriques et alertes à la clé.

Tableau de décision

Ce qui ne change pas : le compte et la facturation

La surface choisie n'affecte pas la facturation. CaptchaAI facture par thread — une résolution en cours — avec des résolutions illimitées par thread. Le plan d'entrée est BASIC ($15/mois, 5 threads), en dollars US. Aucun surcoût par type de CAPTCHA, aucun plafond quotidien.

Exemple : vérifier le solde avant un lot

Côté API, contrôlez le solde avant de lancer un traitement par lots dans 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))

Ce garde-fou évite une exécution qui échoue faute de solde ; l'extension affiche le solde dans son interface.

Observabilité côté API

Sur l'API, instrumentez vos appels dès le départ : durée d'obtention du token, code retour HTTP, identifiant de tâche et taille de votre file d'attente interne. Ces métriques alimentent vos tableaux de bord de QA et vos alertes.

Séparez les logs par environnement. Côté RGPD, appliquez la minimisation : ne journalisez que les champs nécessaires au diagnostic, jamais de données personnelles superflues.

Checklist avant de basculer

• Le périmètre reste limité à vos propres applications ou à des sources autorisées.
• La clé CaptchaAI est stockée dans un secret CI ou un coffre, jamais dans le code source.
• Une stratégie de retry idempotent couvre les erreurs transitoires, et les tests restent rejouables depuis votre CI.

FAQ

Peut-on utiliser l'extension et l'API en parallèle ?

Oui. Beaucoup d'équipes valident un parcours à la main via l'extension, puis reproduisent le flux via l'API pour la CI. Les deux partagent le même compte et le même solde.

L'extension fonctionne-t-elle sur un serveur sans interface graphique ?

Non. L'extension a besoin d'un navigateur affiché. Pour un serveur headless ou un job planifié, seule l'API convient.

La facturation dépend-elle de la surface choisie ?

Non. Le modèle est le même des deux côtés : par thread, avec résolutions illimitées. Passer de l'extension à l'API ne change ni votre plan ni votre coût.

Comment migrer de l'extension vers l'API sans tout réécrire ?

Reprenez les paramètres que le défi attend (sitekey, URL, action éventuelle), soumettez la tâche, interrogez le résultat, puis appliquez le token dans la même session HTTP qui poursuit le parcours. La logique reste identique d'un type de CAPTCHA à l'autre.

Guides connexes

• Démarrage rapide CaptchaAI
• QA CAPTCHA en environnements autorisés
• Tester l'endpoint API sur vos formulaires
• Intégration CAPTCHA en CI
• Résoudre reCAPTCHA v2 via l'API

Structurez vos workflows CAPTCHA avec une approche méthodique et reproductible. – Obtenez votre clé CaptchaAI.