Menù della documentazione

reportIncorrectRecaptcha: invia un reclamo per un token Recaptcha

I reclami sono accettati soltanto per i Recaptcha V2 e V3, incluso Enterprise Recaptcha. È importante che tu legga la descrizione seguente, altrimenti il nostro sistema potrebbe bannare le tue segnalazioni.

A causa dell'impossibilità di controllare la tua regnalazione come facciamo con i captcha grafici, il tuo reclamo supera prima le analisi delle statistiche nel nostro backend, poi è accettato soltanto in caso di esito positivo. In sostanza, ciò che facciamo è paragonare le statistiche delle tue segnalazioni con le statistiche di altri clienti di fiducia. Se il tuo tasso di segnalazione si discosta di molto dalle altre segnalazioni, allora sarà ignorato per alcuni giorni. Così, per risultati migliori, devi monitorare i tuoi processi di automazione costantemente e inviare segnalazioni soltanto se sei sicuro al 100% che il Recaptcha era sbagliato.

Non tutte le segnalazioni vengono accettate. Per calcolare il tuo tasso medio di fallimento con un livello di accuratezza corretto, devono essere inviati almeno 100 task recaptcha per account per il riconoscimento in 24 ore.

Le segnalazioni devono essere inviate entro 60 secondi dal completamento del task. Se mandi una segnalazione oltre questo tempo, l'API restituirà l'errore ERROR_NO_SUCH_CAPTCHA_ID. È consentito inviare soltanto una segnalazione per task.

Indirizzo: https://api.anti-captcha.com/reportIncorrectRecaptcha
Metodo: POST
Content-type: application-json

Proprietà della richiesta

Proprietà Tipo Richiesto Scopo
clientKey Stringa
taskId Numero intero

Esempio di richiesta

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportIncorrectRecaptcha
        


Struttura di risposta

Proprietà Tipo Scopo
errorId Numero intero Identificatore dell'errore.
0: nessun errore, l'operazione è riuscita.
>1: identificatore dell'errore. Un codice di errore e una breve descrizione sono trasferite nelle proprietà errorCode e errorDescription.
errorCode Stringa
errorDescription Stringa Breve descrizione dell'errore
status Stringa
Risultato dell'operazione. Ricevi o un codice di errore oppure status="success" quando il reclamo è accettato.

Esempio di risposta

JSON senza errori
          {
    "errorId":0,
    "status":"success"
}
        
JSON con un errore
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}