Périmètre sûr : Ce guide s'applique exclusivement à vos propres applications, à vos environnements de test ou à des sources pour lesquelles 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.
Le taux de réussite d'un CAPTCHA ne dépend pas seulement du solveur : il varie fortement selon l'ASN du proxy qui porte la requête. Un même formulaire renvoie un défi trivial derrière une IP résidentielle propre, et un défi durci derrière un bloc datacenter déjà signalé. Ce lien entre réputation réseau et difficulté du défi sépare un pipeline de collecte stable d'un pipeline capricieux, et c'est lui que ce guide vous apprend à mesurer.
Pourquoi l'ASN du proxy pèse sur le taux de réussite
Un ASN (Autonomous System Number) identifie le réseau propriétaire d'une plage d'IP. Les anti-bots classent ces plages par réputation : un proxy résidentiel grand public inspire davantage confiance qu'un proxy datacenter hébergé sur une plage connue pour le scraping. Deux requêtes identiques déclenchent donc des défis de difficulté différente selon l'ASN, et des taux de réussite différents.
Traiter tous vos proxys comme interchangeables masque ce signal. Segmentez par ASN, et un pic d'échecs cesse d'être un mystère global pour devenir un bloc identifiable à retirer, réchauffer ou remplacer. C'est la différence entre subir une dégradation diffuse et corriger une cause précise.
Mesurer le taux de réussite par ASN
Rattachez chaque appel à l'ASN du proxy, puis agrégez : le tableau de bord montre quels réseaux tiennent la charge et lesquels vous font perdre du budget.
Les chiffres ci-dessous reposent sur des mesures observées et des retours d'utilisateurs. Les résultats varient selon l'environnement, le volume et le moment de la journée.
| Indicateur | Objectif à viser | Ce qu'il révèle |
|---|---|---|
| Latence (p95) | < 60 s pour les défis à token | La traîne est contenue et vos timeouts bien dimensionnés. |
| Taux de réussite par ASN | Seuil d'alerte fixé par bloc | Le proxy n'est pas grillé. |
| Coût par résolution acceptée | Stable sur la semaine | Le volume n'érode pas la marge via des retries. |
Séparez la réussite du solveur de celle du workflow : un token obtenu n'est pas une page acceptée. L'écart entre les deux, corrélé à un ASN, trahit un bloc de proxys en fin de vie.
Brancher CaptchaAI et tracer chaque appel
Votre composant interne appelle CaptchaAI en HTTPS pour récupérer un token, en passant le proxy en paramètre optionnel de la tâche, puis injecte ce token dans la même session que celle qui a déclenché le défi. Une session cohérente évite le rejet le plus fréquent après résolution. La clé CaptchaAI vit dans un coffre (HashiCorp Vault, AWS Secrets Manager) ou un secret CI, jamais dans le code source. Voici un exemple côté client de 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))
Instrumentez ensuite chaque appel pour obtenir des métriques exploitables — durée d'obtention du token, code retour HTTP, identifiant de tâche et ASN du proxy — puis corrélez les identifiants à votre traçage distribué (OpenTelemetry). Vous rejouez alors un scénario complet depuis un identifiant unique, l'étiquette ASN transforme un tableau de bord générique en outil de décision, et le temps de diagnostic en cas d'incident se réduit nettement.
Dépannage
La plupart des tickets sur cette intégration tiennent en quelques symptômes récurrents. Chaque ligne se corrige sans quitter votre éditeur.
| Symptôme | Cause probable | Correctif |
|---|---|---|
| Taux de réussite qui s'effondre sur un seul ASN | Bloc de proxys grillé ou signalé | Retirez l'ASN de la rotation, puis réchauffez-le ou remplacez-le. |
ERROR_ZERO_BALANCE |
Solde sous le minimum par tâche | Rechargez et ajoutez une alerte de solde au tableau de bord. |
ERROR_WRONG_USER_KEY |
Clé copiée avec un espace ou mauvais compte | Recopiez la clé depuis le tableau de bord et stockez-la en secret CI. |
ERROR_BAD_PARAMETERS |
sitekey, URL de page ou proxy manquant ou mal formé | Revalidez les paramètres envoyés contre le HTML en direct. |
| Token refusé après résolution | Token injecté dans une autre session que celle du défi | Gardez résolution et soumission dans le même contexte de session. |
Liste de contrôle
| Vérification | Réglage recommandé |
|---|---|
| Périmètre | Limité à vos propres applications ou à des sources autorisées. |
| Clé CaptchaAI | Stockée dans un coffre ou un secret CI, jamais en clair. |
| Étiquetage | Chaque appel taggé avec l'ASN du proxy, la durée et le code retour. |
| Retry | Idempotent, plafonné à trois tentatives pour les erreurs transitoires. |
| Tableaux de bord | Taux de réussite segmenté par ASN, pas seulement en global. |
FAQ
Un proxy datacenter fait-il forcément chuter le taux de réussite ?
Pas systématiquement, mais souvent : les plages datacenter sont plus surveillées et déclenchent des défis plus durs. Mesurez par ASN avant de conclure — certains blocs datacenter restent performants, d'autres proxys résidentiels sont déjà grillés.
Comment isoler l'ASN responsable d'un pic d'échecs ?
Segmentez votre taux de réussite par ASN, puis triez par volume d'échecs : le bloc fautif ressort immédiatement. Retirez-le de la rotation, observez le taux global remonter, puis réchauffez-le ou remplacez-le.
Faut-il changer de proxy à chaque échec de résolution ?
Non. Un échec isolé relève souvent d'une simple nouvelle tentative. Ne retirez un ASN de la rotation que lorsque son taux de réussite reste sous votre seuil d'alerte sur un volume représentatif, pas sur une poignée d'appels.
Peut-on transmettre le proxy à CaptchaAI dans la requête ?
Oui. Le proxy se passe en paramètre optionnel de la tâche, avec le sitekey et l'URL de la page, pour résoudre le défi dans le contexte réseau où il apparaît.
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
Segmentez vos mesures, retirez les ASN grillés et laissez CaptchaAI résoudre le reste. – Obtenez votre clé CaptchaAI.
