Documentation
Tout ce qu'il faut pour envoyer votre première résolution et la faire accepter.
Votre première résolution en quatre étapes
- 01Créer un compte
Inscrivez-vous et vérifiez votre e-mail. Les nouveaux comptes reçoivent 0,10 $US de crédit gratuit, sans carte.
- 02Créer une clé API
Dans le tableau de bord, sous Clés. Les clés commencent par cn- et ne sont affichées qu'une fois : conservez la vôtre en lieu sûr.
- 03Envoyer une résolution
Envoyez en POST le type, la sitekey et l'URL de la page à /v1/solve?wait=60 avec Authorization: Bearer cn-…
- 04Soumettre le token
Placez le token là où la page l'attend et soumettez-le dans les deux minutes environ.
curl -X POST "https://api.captchano.com/v1/solve?wait=60" \
-H "Authorization: Bearer cn-YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "recaptcha_v2",
"sitekey": "6LcABC...",
"url": "https://example.com/login",
"proxy": "http://user:pass@host:port"
}'
# 200 OK
# { "id": "slv_…", "status": "ready",
# "solution": { "token": "03AGdBq25S…" },
# "cost": "0.00598", "solveTime": 18.4 }Choisissez votre intégration
Des exemples fonctionnels sur l'API réelle, avec les pièges propres à chaque outil.
Faites accepter vos tokens
La plupart des tokens valides mais rejetés s'expliquent par l'une de ces causes.
Un token obtenu sur une IP ou un navigateur différent de celui qui le soumet est la cause de rejet la plus fréquente.
Pour reCAPTCHA v3, envoyez le même nom d'action que celui utilisé par la page. Une différence fait discrètement baisser le score.
Les tokens expirent au bout de deux minutes environ et sont à usage unique. Résolvez juste avant de soumettre, et à nouveau à chaque nouvelle tentative.
Bloquant ou polling
Avec ?wait=N (jusqu'à 120 secondes), la requête de résolution reste en attente jusqu'à ce que le résultat soit prêt. Sans ce paramètre, vous recevez immédiatement un id de tâche et interrogez GET /v1/task/{id} toutes les cinq secondes. Une solution payée reste récupérable pendant dix minutes : une connexion interrompue ne vous fait donc pas perdre la résolution.
Facturation
Vous n'êtes facturé que lorsqu'une résolution réussit ; les résolutions échouées sont gratuites. Chaque réponse inclut son cost, et GET /v1/balance renvoie votre crédit restant. Les tarifs par type figurent sur la page des tarifs.
Clés et équipes
Un compte peut détenir jusqu'à dix clés actives. Nommez-les par projet ou par client et le tableau de bord indique l'utilisation par clé ; en révoquer une n'affecte pas les autres.
FAQ de la documentation
Existe-t-il un SDK officiel ?
Oui. Des SDK open source pour Python, Node.js et TypeScript, Go et PHP sont disponibles sur GitHub. Vous n'en avez pas besoin pour autant : CaptchaNo est une simple API REST avec du JSON en entrée et en sortie, donc n'importe quel client HTTP convient, et les guides d'intégration montrent les quelques lignes nécessaires pour chaque langage et outil.
Quels types de défi sont pris en charge ?
reCAPTCHA v2 (case à cocher et invisible), reCAPTCHA v3, les widgets reCAPTCHA Enterprise de type case à cocher, Cloudflare Turnstile, DataDome et les captchas image ou texte, tous avec le même format de requête.
Ai-je besoin d'un proxy ?
Pour DataDome, oui, car le cookie est lié à l'IP qui l'a obtenu. Pour les défis à token, c'est facultatif mais cela améliore l'acceptation, car le site peut comparer l'endroit où le token a été produit avec celui où il est soumis.
Que se passe-t-il quand une résolution échoue ?
La tâche se termine avec le statut failed et un code d'erreur, et vous n'êtes pas facturé. Réessayez avec une nouvelle requête.
Où puis-je voir mon utilisation ?
Le tableau de bord liste chaque résolution avec son type, sa durée, son coût et sa clé, et affiche votre solde et vos dépenses par clé.
Guides utiles
Prêt à développer ?
Commencez par un essai gratuit de 3 jours, puis payez par résolution réussie à mesure que votre trafic augmente. Aucune carte requise pour l'essai.