Configurer un profil de site reCAPTCHA
Configurez le site dans Profils de site et attendez que son profil affiche active avant de demander un jeton. Envoyer un nom d’hôte et une action à l’API de tâches ne crée pas de profil.
Sur cette page
Ajoutez le site dans la console
- 1.
Vérifiez l’espace de travail
Configurez le profil dans l’espace de travail dont vous utiliserez la clé API pour créer les tâches. Un profil dans un autre espace de travail ne suffit pas. Si la console affiche Ajouter du crédit pour continuer, suivez cette invite avant de poursuivre la configuration.
- 2.
Ouvrez Ajouter un site
Dans Profils de site, sélectionnez Ajouter un site. Saisissez la page HTTPS cible dans URL de la page. Sous Type de reCAPTCHA, choisissez Enterprise v3 ou v3 standard selon la page.
- 3.
Définissez les paramètres de capture
L’action de capture est obligatoire. Utilisez l’action pour laquelle vous souhaitez effectuer la résolution ; en cas de doute, trouvez d’abord l’action reCAPTCHA. Le formulaire comporte aussi les champs facultatifs URL de navigation, Clé de site et Valeur du Referer. La clé de site peut être détectée automatiquement.
- 4.
Envoyez le formulaire
Sélectionnez Ajouter le site. Les profils système vérifiés peuvent renseigner le contrat de page connu et l’action de capture sans récupération en direct ; le formulaire explique l’action choisie. Les autres soumissions peuvent passer par les états en attente, capture en cours, validation en cours ou en cours d’examen.
Vérifiez l’état du profil obtenu. ACTIVE s’affiche sous la forme active, et c’est l’état requis pour la résolution. Si la capture échoue, la console affiche une raison et vous permet de réessayer.
Demandez un jeton à l’aide du profil actif
Ce corps de tâche utilise le nom d’hôte et l’action du profil :
{
"site": "accounts.example.com",
"action": "login",
"proxy": "http://user:[email protected]:8080",
"requestId": "example_login_001"
}siteest le nom d’hôte de l’URL de la page, sans protocole ni chemin.actionest l’action de la requête protégée. Faites-la correspondre au profil que vous souhaitez utiliser.- La valeur par défaut de
recaptchaTypeestenterprise-v3. Pour un profil v3 standard, définissez-la explicitement surv3. - Remplacez la valeur de substitution du proxy par le proxy HTTP(S) que vous utiliserez également pour la requête cible.
Le guide de démarrage rapide Python et le guide de démarrage rapide Node.js montrent comment envoyer la requête et utiliser le résultat.
Corrigez un profil manquant ou inactif
- Aucun profil n’est disponible pour la tâche.
Comparez l’espace de travail associé à votre clé API et le nom d’hôte de la tâche avec le profil que vous avez configuré.
Essayez ceci : Ajoutez le profil de site voulu dans l’espace de travail qui créera la tâche. Répéter la création de tâche ne créera pas le profil manquant.
- Le profil est en attente, en cours de capture, de validation ou d’examen.
Consultez son état actuel dans Profils de site.
Essayez ceci : Attendez que le profil devienne actif avant de demander une résolution. Ces états ne remplacent pas un profil actif.
- La capture a échoué.
Lisez la raison de l’échec affichée dans la console.
Essayez ceci : Corrigez le problème indiqué par cette raison, puis relancez la capture.
- Un profil est actif, mais l’action visée ne trouve toujours pas de profil correspondant.
Comparez le nom d’hôte, l’action de capture et le type de reCAPTCHA. Si l’action d’exécution diffère, vérifiez qu’il existe une cible de capture unique et non ambiguë.
Essayez ceci : Configurez un profil correspondant au nom d’hôte, à l’action et au type visés plutôt que de modifier la tâche avec une action sans rapport dans le seul but de sélectionner un profil existant.
Sources et référence de l’API
Lancez votre première tâche.
Démarrez avec $5 de crédit dans votre espace de travail.