Votre première résolution de CAPTCHA sur solvethree

1. 1.

   Inscrivez-vous et configurez votre espace de travail

   Commencez par l’inscription. Utilisez le même espace de travail pour votre clé API, votre profil de site et votre crédit.

2. 2.

   Créez une clé

   Ouvrez Clés API dans la console. Sélectionnez Créer une clé API, saisissez un Nom de la clé, puis sélectionnez Créer la clé.

3. 3.

   Enregistrez le secret

   Copiez le secret affiché sous Enregistrez votre clé API et conservez-le en lieu sûr avant de sélectionner J’ai enregistré cette clé. Afficher les préfixes ne permettra pas de récupérer le secret complet ultérieurement. Conservez la clé sur votre serveur, pas dans le code du navigateur.

Le crédit de bienvenue est de $5. Si vous devez ajouter des fonds, le dépôt minimum est de $10. reCAPTCHA coûte $2.00 pour 1,000 résolutions ; une tâche au statut ready est facturée et une résolution échouée est remboursée.

1. 1.

   Ajoutez la page cible

   Ouvrez Profils de site et sélectionnez Ajouter un site. Saisissez l’URL de page HTTPS de la cible et choisissez Enterprise v3.

2. 2.

   Définissez l’action de capture

   Utilisez l’action requise pour l’opération que vous intégrez. L’exemple de requête ci-dessous utilise login ; ne l’utilisez donc que s’il s’agit de l’action réelle de la cible. Ajoutez un profil par combinaison de nom d’hôte, d’action de capture et de type de reCAPTCHA.

3. 3.

   Attendez le statut actif

   Sélectionnez Ajouter le site. Certains comptes verront d’abord Ajouter du crédit pour continuer. Selon la soumission, le profil peut passer par des états de capture, de validation ou d’examen. Continuez uniquement lorsqu’il est actif ; aucune durée de capture n’est garantie. Si la capture échoue, lisez la raison avant de réessayer.

Envoyer un nom d’hôte et une action dans une tâche ne crée pas de profil. Pour cette première résolution, utilisez l’action de capture exacte du profil dans la tâche. Consultez la configuration des profils de site pour les champs facultatifs et le choix de l’action.

Envoyez le corps suivant à POST https://api.solvethree.com/v1/tasks. Authentifiez-vous avec l’en-tête Authorization contenant Bearer suivi de votre clé API d’espace de travail.

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

• Remplacez site par le nom d’hôte de la cible, pas par l’URL complète de sa page. Remplacez action par l’action sélectionnée pour votre première résolution.
• Remplacez proxy par l’URL et les identifiants de votre proxy HTTP. Cette requête utilise un seul proxy ; n’envoyez pas également proxyCandidates.
• Choisissez un requestId pour cette requête logique et conservez-le avec les paramètres envoyés. Il accepte 1–64 lettres ASCII, chiffres, traits de soulignement ou traits d’union.
• N’incluez pas type ni url. Lorsque recaptchaType est omis, la requête utilise Enterprise v3 par défaut.

Pour une implémentation Python complète, consultez reCAPTCHA Enterprise en Python. La requête présentée ici montre les valeurs à préparer au préalable.

Conservez l’identifiant de tâche renvoyé lors de la création. Récupérez la tâche avec GET https://api.solvethree.com/v1/tasks/:id, en remplaçant :id par cet identifiant et en utilisant la même authentification Bearer.

• Vérifiez si la réponse HTTP indique un échec avant de lire son corps comme une réponse de tâche réussie.
• Tant que le statut est pending ou solving, continuez les interrogations périodiques. Aucun de ces statuts ne contient de solution utilisable.
• Lorsque le statut est ready, arrêtez les interrogations périodiques et lisez solution.
• Lorsque le statut est failed, arrêtez les interrogations périodiques et examinez errorCode et error. La résolution échouée est remboursée.

Une réponse au statut ready a cette structure. Ces valeurs de jeton et d’identité de navigateur sont des exemples, pas une solution utilisable.

{
  "id": "example-task",
  "status": "ready",
  "solution": {
    "token": "EXAMPLE_TOKEN",
    "userAgent": "EXAMPLE_USER_AGENT",
    "secChUa": "EXAMPLE_CLIENT_HINTS"
  }
}

1. 1.

   Envoyez le jeton, pas l’identifiant de tâche

   Placez solution.token à l’endroit où la cible prévue attend son jeton reCAPTCHA. Examinez la requête sortante pour vérifier qu’elle n’envoie pas l’identifiant de tâche ou un ancien jeton.

2. 2.

   Utilisez l’identité de navigateur renvoyée

   Utilisez solution.userAgent et solution.secChUa pour la requête destinée à la cible, avec le même proxy que celui fourni pour cette résolution. Ne les mélangez pas avec une autre identité de navigateur et ne soumettez pas le jeton à une autre URL cible.

3. 3.

   Vérifiez la réponse de la cible

   Vérifiez que la cible a accepté l’opération prévue. Une tâche au statut ready signifie que solvethree a généré une solution ; cela ne garantit pas que la cible accepte votre requête ultérieure.

Avant de lancer un lot, faites accepter cette requête unique par la cible. Si elle est rejetée, vérifiez le jeton envoyé, l’identité de navigateur, le proxy et l’URL cible avant d’acheter d’autres résolutions.