Configurer des profils pour plusieurs actions reCAPTCHA

Dans Profils de site, configurez un profil par nom d’hôte, action de capture et type de reCAPTCHA. Dans cet exemple, les deux profils utilisent accounts.example.com et Enterprise v3.

1. 1.

   Ajouter le profil de connexion

   Choisissez Ajouter un site. Saisissez l’URL HTTPS de la page où s’exécute l’action de connexion, sélectionnez Enterprise v3 et définissez Action de capture sur login. Le formulaire accepte également les valeurs facultatives URL de navigation, Clé de site et Referer. Soumettez le formulaire avec Ajouter le site.

2. 2.

   Ajouter le profil de paiement

   Répétez l’opération pour la page de paiement sur le même nom d’hôte, en conservant Enterprise v3 et en définissant Action de capture sur checkout.

3. 3.

   Confirmer que les deux profils sont actifs

   Un profil actif doit être disponible pour votre espace de travail avant toute résolution. Si une capture échoue, examinez le motif affiché avant de réessayer. Envoyer une tâche avec un nom d’hôte et une action ne crée pas le profil manquant.

Envoyez chaque objet ci-dessous dans une requête POST /v1/tasks distincte. Authentifiez-vous avec la clé API de votre espace de travail via Authorization: Bearer, et conservez cette clé sur le serveur.

[
  {
    "site": "accounts.example.com",
    "action": "login",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "login-flow-001"
  },
  {
    "site": "accounts.example.com",
    "action": "checkout",
    "proxy": "http://USER:PASSWORD@PROXY:PORT",
    "requestId": "checkout-flow-001"
  }
]

Remplacez les valeurs de substitution du nom d’hôte et du proxy par votre nom d’hôte cible et votre URL de proxy. Chaque requête fournit un seul proxy ; n’ajoutez pas aussi proxyCandidates. Le champ recaptchaType omis vaut par défaut enterprise-v3. N’ajoutez pas de champs type ou url à ces requêtes reCAPTCHA.

Les deux valeurs requestId identifient des tâches logiques distinctes. Utilisez un nouvel ID pour une nouvelle résolution. Si la création de tâche expire, réutilisez le même ID avec la même requête pour récupérer la tâche existante ; réutiliser un ID avec des paramètres différents provoque un conflit.

Pour le nom d’hôte et le type de reCAPTCHA correspondants, une correspondance exacte de l’action d’exécution sélectionne son profil : login sélectionne le profil de connexion, et checkout sélectionne le profil de paiement.

Une action d’exécution différente nécessite une cible capturée sans ambiguïté. Si plusieurs cibles sont possibles, ne supposez pas que solvethree choisit un profil arbitraire. Utilisez l’action de capture configurée lorsque c’est possible. Si la sélection est signalée comme ambiguë, comparez le nom d’hôte, le type de reCAPTCHA et l’action de la tâche aux profils de la console, puis utilisez la réponse réelle de la console ou de l’API pour diagnostiquer l’incohérence.

Une clé de site unique pour chaque action n’est pas la règle de routage. Configurez les profils par nom d’hôte, action de capture et type de reCAPTCHA plutôt que d’essayer de distinguer les actions par les clés de site.