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é.
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
task.type
text
oui
task.ChallengeCaption
text
oui
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
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
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
"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.
Français
English