hCAPTCHA

hCAPTCHA

HCAPTCHA est une alternative reCAPTCHA la plus populaire. Les propriétés de cette tâche sont les mêmes que celle de reCAPTCHA à l’exception de la propriété type.

hcaptcha api solver
Exemple reCAPTCHA V3.

1. Créer une tâche CAPTCHA

La méthode createTask se charge de créer une tâche pour résoudre un type de CAPTCHA.

Adresse: https://api.scraptcha.com/createTask/

Méthode: POST

Content-type: application-json

Propriétés de la requête

Nom

Type

Obligatoire

Description

clientKey

text

oui

Vous pouvez trouver la clé du compte client par ici.

task.type

text

oui

HCaptchaTaskProxyless

task.websiteURL

text

oui

Adresse d’une page web cible. Elle peut être située n’importe où sur le site Web, même dans un espace réservé aux membres. Nos collaborateurs n’y naviguent pas mais simulent la visite à la place.

task.websiteKey

text

oui

hCaptcha sitekey

Exemple de la requête

POST /createTask HTTP/1.1
Host: api.scraptcha.com
Content-Type: application/json

{
« clientKey »: « YOUR_API_KEY »,
« task »: {
« type »: « HCaptchaTaskProxyless »,
« websiteURL »: « https://hcaptcha.com/ »
« websiteKey »: « 00000000-0000-0000-0000-000000000000 »
}
}

Structure de réponse

  • success
  • error

Le serveur retournera errorId = 0 et taskId en cas succès.

{
       "errorId": 0,
       "taskId": 123456
}

le serveur retournera errorId > 0 et errorCode

{
      "errorId": 1,
      "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
       "errorDescription": "ERROR_KEY_DOES_NOT_EXIST"
}

2. Demander un résultat de tâche

Address: https://api.scraptcha.com/getTaskResult

Method: POST

Content-type: application-json

Propriétés de la requête

Nom

Type

Obligatoire

Description

clientKey

text

oui

Vous pouvez trouver la clé du compte client par ici.

taskId

number

oui

Un identifiant « taskId » obtenu dans la méthode createTask.

Exemple de la requête

POST /getTaskResult HTTP/1.1
Host: api.scraptcha.com
Content-Type: application/json

{
         « clientKey »: « YOUR_API_KEY »,
         « taskId »: 123456
}

Structure de réponse

  • success
  • processing
  • error
{
"errorId": 0,
"status": 200,
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKvhKj9_xGBJKnQim...."
}
}

{
"errorId": 0,
"status": "processing"
}

{
"errorId": 1,
"errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
"errorDescription": "ERROR_CAPTCHA_UNSOLVABLE"
}

  • errorId = 0 et status = ready : Résolu avec succès, lire le résultat dans solution.text.
  • errorId = 0 et status = processing : La tâche n’est pas encore prête, attendre 2s puis refaire.
  • errorId > 0 : identificateur d’erreur. Code d’erreur et courte description transférés dans les propriétés errorCode et errorDescription.