Pourquoi solvethree utilise un profil de site plutôt qu’un champ websiteKey

1. 1.

   Ouvrez Ajouter un site

   Accédez à Profils de site et sélectionnez Ajouter un site. Saisissez l’URL HTTPS de la page cible. La tâche utilisera son nom d’hôte, et non cette URL complète. Renseignez les champs facultatifs URL de navigation et Referer si la configuration de la page le nécessite.

2. 2.

   Choisissez le type et vérifiez la clé de site

   Sélectionnez Enterprise v3 pour une intégration reCAPTCHA Enterprise, ou Regular v3 pour reCAPTCHA v3 standard. Le formulaire peut détecter automatiquement la clé de site ; vous pouvez la remplacer dans le champ facultatif Clé de site.

3. 3.

   Définissez l’action de capture

   L’action de capture est obligatoire. Pour la requête ci-dessous, configurez un profil avec l’action de capture login. Les profils système vérifiés peuvent renseigner la configuration de page connue et l’action de capture sans récupération en direct ; lisez l’explication du formulaire concernant l’action choisie.

4. 4.

   Envoyez le profil et attendez son activation

   Sélectionnez Ajouter un site. Les soumissions peuvent passer par les états en file d’attente, capture, validation ou examen avant de devenir actives ; aucune durée de capture n’est garantie. Certains comptes affichent Ajouter du crédit pour continuer. Si la capture échoue, examinez la raison avant de réessayer.

Utilisez un profil par nom d’hôte, action de capture et type de reCAPTCHA. Une correspondance exacte avec l’action d’exécution sélectionne son profil. Les autres actions d’exécution nécessitent une cible de capture non ambiguë ; ne supposez donc pas qu’un seul profil pour un nom d’hôte couvre toutes les actions.

Une fois le profil actif, envoyez cet objet directement comme corps JSON à POST /v1/tasks. Authentifiez-vous avec Authorization: Bearer suivi de la clé API de votre espace de travail, et conservez cette clé sur le serveur.

{
  "site": "accounts.example.com",
  "action": "login",
  "proxy": "http://user:[email protected]:8080",
  "requestId": "example_login_001"
}

• site est le nom d’hôte : sans schéma, chemin ni paramètres de requête. L’URL complète de la page doit figurer dans le profil de la console.
• action est l’action d’exécution de cette tâche. Ici, login correspond à l’action de capture configurée ci-dessus.
• proxy fournit le proxy pour la résolution. Un seul des champs proxy ou proxyCandidates est requis ; n’envoyez pas les deux.
• requestId est facultatif. Si la création dépasse le délai d’attente, le renvoi de la même requête avec le même identifiant renvoie la tâche existante. Modifier les paramètres de la tâche tout en réutilisant cet identifiant provoque un conflit.

Ne reprenez pas websiteKey, websiteURL, type ou url de la structure de requête de l’API précédente. Pour reCAPTCHA, recaptchaType vaut par défaut enterprise-v3, ce qui explique son absence dans l’exemple. Pour Regular v3, définissez recaptchaType sur v3.