HCAPTCHA Grid base click

HCAPTCHA Grid base click

HCaptcha Grid Base click est un CAPTCHA dans lequel l’utilisateur sélectionne une séquence d’images qui sont données dans le captcha. Ce schéma fournit de meilleurs résultats que les autres captcha en termes de performance, de convivialité et de sécurité.

HCAPTCHA Grid base click
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

HCaptchaClickTask

task.ChallengeCaption

text

oui

La légende du défi. Par exemple Veuillez cliquer sur chaque image contenant une voiture.

task.ImageIndex1

text

oui

La base64 de l’image à la position 1.

task.ImageIndex2

text

oui

La base64 de l’image à la position 2.

task.ImageIndex3

text

oui

La base64 de l’image à la position 3.

task.ImageIndex4

text

oui

La base64 de l’image à la position 4.

task.ImageIndex5

text

oui

La base64 de l’image à la position 5.

task.ImageIndex6

text

oui

La base64 de l’image à la position 6.

task.ImageIndex7

text

oui

La base64 de l’image à la position 7.

task.ImageIndex8

text

oui

La base64 de l’image à la position 8.

task.ImageIndex9

text

oui

La base64 de l’image à la position 9.

Exemple de la requête

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

{
« clientKey »: « YOUR_API_KEY »,
« task »: {
« type »: « HCaptchaClickTask »,
« ChallengeCaption »: « Please click each image containing a car »,
« ImageIndex1 »: « base64 of image 1 »,
« ImageIndex2 »: « base64 of image 2 »,
« ImageIndex3 »: « base64 of image 3 »,
« ImageIndex4 »: « base64 of image 4 »,
« ImageIndex5 »: « base64 of image 5 »,
« ImageIndex6 »: « base64 of image 6 »,
« ImageIndex7 »: « base64 of image 7 »,
« ImageIndex8 »: « base64 of image 8 »,
« ImageIndex9 »: « base64 of image 9 »
}
}

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": "ready",
"solution": {
"ImageResult1": "CLICK",
"ImageResult2": "NONE",
"ImageResult3": "CLICK",
"ImageResult4": "CLICK",
"ImageResult5": "NONE",
"ImageResult6": "NONE",
"ImageResult7": "NONE",
"ImageResult8": "NONE",
"ImageResult9": "NONE"
}
}

{
"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.gRecaptchaResponse.
  • 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.