API reCAPTCHA Enterprise v3

Par solvethree Mis à jour

Obtenez un jeton reCAPTCHA v3 Enterprise depuis votre backend. Configurez le site une fois, puis envoyez son nom d’hôte, l’action et un proxy. Nous renverrons le jeton avec l’agent utilisateur et les indications client à utiliser lors de son envoi.

Essayer l’API
Sur cette page

Effectuer la requête

Configurez un profil de site actif dans votre espace de travail avant la première résolution. Envoyez le nom d’hôte dans site et l’action reCAPTCHA réelle de la page dans action. Enterprise v3 est utilisé par défaut ; utilisez recaptchaType: v3 pour la version v3 standard. La tâche ne nécessite ni type, ni URL complète de page, ni clé de site.

Créez la tâche avec POST https://api.solvethree.com/v1/tasks. Authentifiez-vous avec une clé API de l’espace de travail dans l’en-tête Authorization: Bearer.

Corps de la tâche · remplacez la cible et le proxy de l’exemple
{
  "site": "example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example-recaptcha-001"
}

Envoyer le jeton

Lisez solution.token lorsque la tâche est prête. Envoyez-le dans le champ CAPTCHA de votre application via le même proxy, en utilisant les valeurs userAgent et secChUa renvoyées. Effectuez la résolution peu avant la requête qui nécessite le jeton ; ne constituez pas de cache de jetons pour plus tard.

Une tâche prête signifie que la solution a été générée. Vérifiez la réponse de la cible pour savoir si elle a accepté la requête.

Attente et délais d’expiration

La création attend jusqu’à 15 secondes par défaut. Utilisez ?waitMs=0 si vous préférez recevoir immédiatement un identifiant de tâche et interroger son état.

Arrêtez-vous à ready ou failed. Si la création dépasse le délai d’attente, réutilisez le requestId d’origine avec des paramètres identiques pour récupérer la tâche. Un nouvel ID peut créer une autre résolution facturable.

Prix

$2.00 pour 1,000 résolutions, prélevés sur le solde de votre espace de travail. Les résolutions échouées sont remboursées. Commencez avec $5 de crédit de bienvenue ; le dépôt payant minimum est de $10.

API reCAPTCHA Enterprise v3 · solvethree