ReCaptchaV2 : résolution de reCAPTCHA v2
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 :
ReCaptchaV2TaskProxyLess
: utilise les proxies intégrés au serveur.ReCaptchaV2EnterpriseTask
: ce type de tâche nécessite vos propres proxies.ReCaptchaV2EnterpriseTaskProxyLess
: 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 un Task, si vous avez besoin d’utiliser des tokens dans des outils d’automatisation tels que playwright et puppeteer, vous devrez peut - être trouver leurs fonctions de rappel. Référence:
Structure de l’objet de tâche
Si vous ne savez pas comment définir les paramètres, utilisez l’extension capsolver pour obtenir automatiquement les paramètres dont vous avez besoin.
- article de référence: Comment détecter un CAPTCHA et extraire ses paramètres et
Si vous trouvez que le token V2 n’est pas valide, utilisez l’extension capsolver pour obtenir la configuration json et envoyez - la à notre service client pour la configuration. Une fois configuré, le score de jeton sera grandement amélioré.
- article de référence: Comment résoudre recaptcha V2, invisible V2, V3, V3 Enterprise ≥ 0,9 Score et
Propriétés | Type | Requis | Description |
---|---|---|---|
type | String | Required | ReCaptchaV2TaskProxyLess ReCaptchaV2EnterpriseTask ReCaptchaV2EnterpriseTaskProxyLess |
websiteURL | String | Required | Adresse Web du site utilisant généralement c’est une valeur fixe. (Ex : https://google.com) |
websiteKey | String | Required | La clé publique de domaine, rarement mise à jour. (Ex : b989d9e8-0d14-41sda0-870f-97b5283ba67d) |
proxy | String | Optional | Apprenez comment utiliser les proxies |
pageAction | String | Optional | Pour 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. |
enterprisePayload | Object | Optional | Pour la version entreprise, recherchez grecaptcha.enterprise.render et transmettez le paramètre s |
isInvisible | Bool | Optional | Passez vrai s’il n’y a pas de case à cocher Je ne suis pas un robot mais le défi apparaîtra toujours, généralement requis en mode invisible v2 |
isSession | Bool | Optional | Lorsqu’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. |
apiDomain | String | Optional | Nom 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/ |
Exemple de demande
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2Task",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
"enterprisePayload": {
"s": "SOME_ADDITIONAL_TOKEN" // Optional
},
"isInvisible": false, // 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
Après avoir obtenu 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
"secChUa": "xxx", // Sec-Ch-Ua
"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": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
})