reCAPTCHA v2

reCAPTCHA V2

reCAPTCHA v2 exige que l’utilisateur coche la case « I’m not a robot » et peut lui proposer un défi de reconnaissance d’image.

recaptchav2
Exemple CAPTCHA Normal.

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

RecaptchaV2TaskProxyless

task.websiteURL

text

oui

Adresse d’une page Web cible. Peut être situé n’importe où sur le site Web, même dans une zone membre. Nos ouvriers n’y naviguent pas, mais simulent plutôt la visite.

task.websiteKey

text

oui

Clé du site reCAPTCHA. Vous pouvez lire par ici comment la trouver.

task.isInvisible

boolean

non

Indiquez si reCAPTCHA est invisible ou non. Cela rendra un widget approprié pour nos travailleurs.

Exemple de la requête

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

{
« clientKey »: « YOUR_API_KEY »,
« task »: {
« type »: « RecaptchaV2TaskProxyless »,
« websiteURL »: « http://mywebsite.com/recaptcha/test.php »,
« websiteKey »: « 6Lc_aCMTAAAAABx7u2N0D1XnVbI_v6ZdbM6rYf16 »,
« isInvisible »: false
}
}

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.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.
Précédent - Image To Text
Suivant - reCAPTCHA V3