Skip to content
On this page
Home
>Tâche (Jeton)
>HCaptcha

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 proxies
  • HCaptchaTaskProxyLess 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ésTypeRequisDescription
typeStringRequiredHCaptchaTask
HCaptchaTaskProxyLess
websiteURLStringRequiredAdresse Web du site utilisant hcaptcha, 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)
isInvisibleBooleanOptionalDéfinissez true s'il s'agit d'un captcha invisible
proxyStringOptionalApprenez comment utiliser les proxies
enterprisePayloadObjectOptionalDonné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.
getCaptchaObjectOptionalsi vous obtenez une réponse invalide, vous pouvez essayer ce paramètre, vous pouvez apprendre à Solve HCaptcha
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".

Exemple de demande

txt
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
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

json
{
  "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

json
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

json
{
  "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

python
# 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",
})
go
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)
}