HCaptcha : résolution de HCaptcha
Créez la tâche avec la méthode createTask et obtenez les résultats avec
la méthode getTaskResult.
Maintenant, nous avons satisfait aux exigences de presque tous les sites Web à score élevé, et nous prenons également en charge les types de questions invisible
, dessiner une boîte
et d'autres types
Les types de tâches que nous prenons en charge :
HCaptchaTask
ce type de tâche nécessite vos propres proxiesHCaptchaTaskProxyLess
utilise le proxy intégré du serveur
Annonce d'instabilité du service hCaptcha
Nous nous excusons pour l'instabilité récente du service hCaptcha due à des mises à jour d'images et d'autres problèmes. Nous regrettons profondément les désagréments causés. Si vous rencontrez des nouvelles images rendant le service indisponible, veuillez attendre que nous les mettions à jour. Pour toute autre question, n'hésitez pas à nous contacter à tout moment.
Si vous recevez une réponse invalide en utilisant HCaptchaTask
, veuillez nous contacter
car chaque site a des paramètres spécifiques, et cela fonctionne généralement correctement après notre configuration.
Afin de garantir le taux de réussite des jetons, veuillez utiliser un userAgent fixe
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36
(des mises à jour peuvent survenir à tout moment, veuillez en être conscient.)
Créer une tâche
Créez une tâche avec la méthode createTask pour créer une tâche.
Structure de l'objet de la tâche
Propriétés | Type | Requis | Description |
---|---|---|---|
type | String | Required | HCaptchaTask HCaptchaTaskProxyLess |
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 ) |
isInvisible | Boolean | Optional | Définissez true s'il s'agit d'un captcha invisible |
proxy | String | Optional | Apprenez comment utiliser les proxies |
enterprisePayload | Object | Optional | Données personnalisées utilisées dans certaines implémentations d'hCaptcha Enterprise. Vous devez donc mettre true dans le paramètre isEnterprise . Dans la plupart des cas, vous le voyez comme rqdata à l'intérieur des requêtes réseau. IMPORTANT : vous DEVEZ fournir userAgent si vous soumettez un captcha avec le paramètre data . La valeur doit correspondre à l'User-Agent que vous utilisez lors de l'interaction avec le site cible. |
getCaptcha | Object | Optional | si vous obtenez une réponse invalide, vous pouvez essayer ce paramètre, vous pouvez apprendre à Solve HCaptcha |
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". |
Exemple de demande
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
//Requis. Peut utiliser HCaptchaTaskProxyless ou HCaptchaTask
"type": "HCaptchaTaskProxyLess",
//Requis
"websiteURL": "",
// Requis
"websiteKey": "00000000-0000-0000-0000-000000000000",
// Optionnel
"isInvisible": true,
// Optionnel
"enterprisePayload": {
//Optionnel, requis si le site utilise HCaptcha Enterprise
"rqdata": ""
},
//Optionnel, c'est requis si vous utilisez HCaptchaTask
"proxy": "http:ip:port:user:pass",
// socks5:ip:port:user:pass
//Optionnel
"getCaptcha": "fetch request base64 content",
"userAgent": ""
}
}
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 le résultat
Utilisez la méthode getTaskResult pour obtenir les résultats de la reconnaissance.
En fonction de la charge du système, vous obtiendrez les résultats dans l'intervalle 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 utilisé pour résoudre le captcha
"userAgent": "xxx",
//expireTime du jeton
"expireTime": 1671615324290,
"timestamp": 1671615024290,
"captchaKey": "E0_xxx",
//token du captcha
"gRecaptchaResponse": "3AHJ....."
},
"status": "ready"
}
Utiliser la demande SDK
# pip install --upgrade capsolver
# export CAPSOLVER_API_KEY='...'
import capsolver
# capsolver.api_key = "..."
solution = capsolver.solve({
"type": "HCaptchaTaskProxyLess",
"websiteURL": "",
"websiteKey": "00000000-0000-0000-0000-000000000000",
})
package main
import (
"fmt"
capsolver_go "github.com/capsolver/capsolver-go"
"log"
)
func main() {
// first you need to install sdk
//go get github.com/capsolver/capsolver-go
//export CAPSOLVER_API_KEY='...' or
//capSolver := CapSolver{ApiKey:"..."}
capSolver := capsolver_go.CapSolver{}
solution, err := capSolver.Solve(map[string]any{
"type": "HCaptchaTaskProxyLess",
"websiteURL": "",
"websiteKey": "00000000-0000-0000-0000-000000000000",
})
if err != nil {
log.Fatal(err)
return
}
fmt.Println(solution)
}