ReCaptchaV3 : résolution de reCAPTCHA v3
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és | Type | Requis | Description |
---|---|---|---|
type | String | Required | ReCaptchaV3Task ReCaptchaV3TaskProxyLess |
websiteURL | String | Required | Adresse Web du site utilisant hcaptcha, 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) |
pageAction | String | Required | Valeur 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'}) . |
minScore | Double | Optional | Valeur de 0,1 à 0,9. |
proxy | String | Optional | Apprenez comment utiliser les proxies |
enterprisePayload | Object | Optional | Charge utile d’entreprise |
apiDomain | String | Optional | Domaine à 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. |
userAgent | String | Optional | User-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”. |
cookies | Array | Optional | Apprenez comment utiliser les cookies |
anchor | String | Optional | Comment contourner toutes les versions de reCAPTCHA Enterprise v2, v2 invisible, v3, v3 entreprise avec un score de 0,9 |
reload | String | Optional | Comment 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-", ...
})