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
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)
pageActionStringRequiredValeur d’action du widget. Le propriétaire du site définit ce que l’utilisateur fait sur la page via ce paramètre. Valeur par défaut : verify Exemple : grecaptcha.execute('site_key', {action:'login_test'}).
minScoreDoubleOptionalValeur de 0,1 à 0,9.
proxyStringOptionalApprenez comment utiliser les proxies
enterprisePayloadObjectOptionalCharge utile d’entreprise
apiDomainStringOptionalDomaine à partir duquel charger reCAPTCHA Enterprise.
Par exemple :
• http://www.google.com/
• http://www.recaptcha.net/
Ne pas utiliser de paramètre si vous ne savez pas pourquoi il est nécessaire.
userAgentStringOptionalUser-Agent du navigateur utilisé dans l’émulation. Il est nécessaire d’utiliser une signature d’un navigateur moderne, sinon Google vous demandera de “mettre à jour votre navigateur”.
cookiesArrayOptionalApprenez comment utiliser les cookies
anchorStringOptionalComment contourner toutes les versions de reCAPTCHA Enterprise v2, v2 invisible, v3, v3 entreprise avec un score de 0,9
reloadStringOptionalComment contourner toutes les versions de reCAPTCHA Enterprise v2, v2 invisible, v3, v3 entreprise avec un score de 0,9

Exemple de demande

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    // Requis
    "type": "ReCaptchaV3Task",
    // Requis
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    // Requis
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    // Requis
    "pageAction": "login",
    // Optionnel
    "minScore": 0.7,
    "enterprisePayload": {
      // Optionnel, requis si le site utilise reCAPTCHA Enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    // Optionnel
    "apiDomain": "",
    // Optionnel
    "userAgent": "",
    // Optionnel
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ],
    // Optionnel
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    // Optionnel, Vous n'avez besoin de le soumettre qu'une fois et d'obtenir le résultat avec succès, vous pouvez supprimer ce paramètre
    "anchor": "base64 content",
    "reload": "base64 content"
  }
}

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
        "expireTime": 1671615324290, // Expiration du jeton
        "gRecaptchaResponse": "3AHJ....." // Jeton de solution
    },
    "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