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.
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.websiteURL
text
oui
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
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.