Tester l’API CAPTCHA dans Insomnia

Vous avez besoin d’une clé API d’espace de travail, d’un profil actif pour le site cible et d’un proxy. Configurez le profil du site avant d’envoyer la tâche : fournir un nom d’hôte et une action ne crée pas de profil.

Utilisez un environnement local privé nommé solvethree-local avec les variables ci-dessous. Ces noms ont été choisis pour ce guide ; ce ne sont pas des champs d’API supplémentaires. Ne placez pas la clé API ni les identifiants du proxy dans des configurations partagées.

1. 1.

   Configurer la requête de création

   Créez une requête POST avec api_base suivi de /tasks. Ajoutez le paramètre de requête waitMs avec la valeur 0. Sélectionnez l’authentification Bearer et fournissez api_key comme jeton ; la requête doit envoyer un en-tête Authorization utilisant le schéma Bearer.

2. 2.

   Construisez le corps JSON

   Choisissez un corps JSON contenant site, action, proxy et requestId. Renseignez les trois premiers à partir des variables locales correspondantes, et requestId à partir de request_id. Envoyez exactement un des champs proxy ou proxyCandidates ; ce guide utilise proxy. N’ajoutez pas type ni url. Omettre recaptchaType sélectionne la valeur par défaut, enterprise-v3.

3. 3.

   Envoyez la requête et examinez la réponse

   Vérifiez la réponse HTTP avant de la lire comme les données d’une tâche réussie. Si la création réussit, copiez l’identifiant de tâche renvoyé dans task_id. Conservez le corps de la tâche et request_id au cas où vous auriez besoin de récupérer la requête.

4. 4.

   Récupérez cette tâche

   Créez une requête GET avec api_base suivi de /tasks/ et de l’identifiant de tâche copié. Définissez waitMs sur 15000, utilisez la même clé Bearer et laissez le corps vide. Copiez l’identifiant manuellement ; ce guide ne repose pas sur une expression de chaînage des réponses.

Create task
  Method: POST
  URL: https://api.solvethree.com/v1/tasks?waitMs=0
  Auth: Bearer Token — your private workspace key
  Body: JSON — site, action, proxy and a stable requestId

Retrieve task
  Method: GET
  URL: https://api.solvethree.com/v1/tasks/PASTE_RETURNED_ID?waitMs=15000
  Auth: Bearer Token — the same workspace key
  Body: none

Keep the task's proxy in the JSON body. Insomnia's own network proxy setting
controls its API connection, not the proxy used to generate/submit the solution.

La requête HTTP renvoie une réponse d’échec.

Examinez l’erreur HTTP avant d’essayer de lire les données d’une tâche réussie.

Essayez ceci : Corrigez le problème de requête ou d’authentification signalé. Ne soumettez pas à répétition des données invalides inchangées et ne supposez pas que chaque erreur indique un crédit insuffisant.

La tâche est pending ou solving.

Aucun de ces statuts ne contient de solution utilisable.

Essayez ceci : Renvoyez la requête GET pour le même identifiant de tâche. Ne créez pas une autre tâche simplement parce que celle-ci n’est pas terminée.

La tâche est failed.

Lisez errorCode et error ; site-unreachable est une erreur de tâche possible.

Essayez ceci : Cessez de récupérer cette tâche et corrigez la cause signalée avant d’en démarrer une autre. Les résolutions échouées sont remboursées.

La requête de création expire sans renvoyer d’identifiant.

Un délai de connexion dépassé ne prouve pas que la création a échoué.

Essayez ceci : Soumettez à nouveau le même corps de tâche avec le même requestId pour récupérer la tâche existante. Modifier les données tout en réutilisant cet identifiant provoque un conflit.

Une tâche reCAPTCHA ready fournit un jeton. Si vous le soumettez à la cible, utilisez les valeurs userAgent et secChUa renvoyées avec le même proxy que celui utilisé pour la résolution. Une réponse ready confirme qu’une solution a été générée, pas que la requête de votre application a réussi.