Guide
Tâche (Token)
reCAPTCHA v3

ReCaptchaV3 : résolution de reCAPTCHA v3

TIP

Créez la tâche avec la méthode createTask et obtenez les résultats avec la méthode getTaskResult.

Les types de tâches que nous prenons en charge sont les suivants :

  • ReCaptchaV3Task : ce type de tâche nécessite vos propres proxies.
  • ReCaptchaV3EnterpriseTask : ce type de tâche nécessite vos propres proxies.
  • ReCaptchaV3TaskProxyLess : utilise les proxies intégrés au serveur.
  • ReCaptchaV3EnterpriseTaskProxyLess : utilise les proxies intégrés au serveur.

Créer une tâche

Créez une tâche de reconnaissance avec la méthode createTask.

Avant de créer une tâche, vous pouvez en apprendre davantage sur les éléments suivants :

Si vous obtenez une réponse invalide, vous pouvez en apprendre davantage sur les éléments suivants :

Structure de l’objet de tâche

PropriétésTypeRequisDescription
typeStringRequiredReCaptchaV3Task
ReCaptchaV3TaskProxyLess
ReCaptchaV3EnterpriseTask
ReCaptchaV3EnterpriseTaskProxyLess
websiteURLStringRequiredAdresse Web du site utilisant généralement c’est une valeur fixe. (Ex : https://google.com)
websiteKeyStringRequiredLa clé publique de domaine, rarement mise à jour. (Ex : b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxyStringOptionalApprenez comment utiliser les proxies
pageActionStringOptionalPour les sites v2: transmettez le paramètre sa s’il est disponible dans la requête anchor.
Pour les sites v3: recherchez grecaptcha.execute pour trouver le paramètre d’action.
enterprisePayloadObjectOptionalPour la version entreprise, recherchez grecaptcha.enterprise.render et transmettez le paramètre s
isSessionBoolOptionalLorsqu’il est activé, le mode session renvoie la valeur recaptcha-ca-t, utilisée comme cookie (généralement dans la version 3).

Remarque: Certains sites web nécessitent la valeur recaptcha-ca-e, généralement dans la version 2. Si une telle valeur existe, elle est automatiquement renvoyée; aucun autre paramètre supplémentaire n’est requis.
apiDomainStringOptionalNom de domaine pour le chargement du captcha. Normalement, ce paramètre n’a pas besoin d’être transmis.
• http://www.google.com/
• http://www.recaptcha.net/
WARNING

Si vous ne savez pas comment transmettre les paramètres, veuillez vous référer à notre blog pour utiliser l’extension capsolver pour obtenir automatiquement les paramètres.

Si vous constatez que le score de jeton que vous obtenez est faible, veuillez envoyer les données json obtenues par l’extension au service client pour optimisation.

Exemple de demande

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "ReCaptchaV3Task",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      "s": "SOME_ADDITIONAL_TOKEN" // Optional
    },
    "pageAction": "submit", // Optional
    "apiDomain": "", // Optional
    "proxy": "http:ip:port:user:pass", // socks5:ip:port:user:pass, Optional
  }
}

Après avoir soumis la tâche, vous devriez recevoir dans la réponse un ‘ID de tâche’ si tout se passe bien. Veuillez lire errorCode : liste complète des erreurs si vous n’avez pas reçu l’ID de tâche.

Exemple de réponse

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" 
}

Obtenir les résultats

Une fois que vous avez l’ID de tâche, vous devez soumettre l’ID de tâche pour récupérer la solution. La structure de la réponse est expliquée dans getTaskResult.

En fonction de la charge du système, vous obtiendrez les résultats dans un délai de 1s à 10s

Exemple de demande

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Exemple de réponse

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", // User-Agent
        "createTime": 1671615324290, // Temps de génération du jeton
        "gRecaptchaResponse": "3AHJ......", // Token
        "recaptcha-ca-t": "AbEM......", // Certains sites web v3 disposent d'un mode session. Après l'activation de isSession, ce paramètre sera renvoyé et utilisé comme cookie.
        "recaptcha-ca-e": "Abp_......" // Certains sites web v2 possèdent ce paramètre, utilisé comme cookie. Si une telle valeur est présente, elle sera automatiquement renvoyée.
    },
    "status": "ready"
}

Utiliser la demande SDK

# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
 
import capsolver
 
# capsolver.api_key = "..."
solution = capsolver.solve({
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_kl-", ...
})
reCAPTCHA v2MTCaptcha