Menù della documentazione

Lista di errori dell'API

Questa è la lista di errori che la nostra API può produrre. Consigliamo vivamente agli sviluppatori di registrare e analizzare tutti gli errori dell'API e agire subito di conseguenza, ad esempio risolvendo i bug nella tua app e distribuendo aggiornamenti ai tuoi utenti. Proteggiamo attivamente la nostra API da richieste "senza senso", che per esempio producono lo stesso errore se la stessa richiesta è ripetuta più volte. Ciò include i ban agli IP e alle sottoreti così come le sospensioni degli account in alcuni casi di estrema importanza.

Identificatore Codice Descrizione
0 Il codice 0 è per la "mancanza di errori".
1 ERROR_KEY_DOES_NOT_EXIST Chiave di autorizzazione dell'account non trovata nel sistema. Assicurati di averla copiata correttamente senza spazi né tabulazioni.
2 ERROR_NO_SLOT_AVAILABLE Al momento non ci sono lavoratori captcha disponibili, i clienti devono aumentare l'offerta massima nelle Impostazioni API all'interno dell'area clienti, oppure scegliere un orario meno trafficato per creare i task. Puoi trovare più informazioni sul funzionamento delle offerte nelle FAQ.
3 ERROR_ZERO_CAPTCHA_FILESIZE La dimensione del captcha che stai caricando è inferiore a 100 byte.
4 ERROR_TOO_BIG_CAPTCHA_FILESIZE La dimensione del captcha che stai caricando supera i 500.000 byte.
10 ERROR_ZERO_BALANCE L'account ha un saldo pari a zero o negativo.
11 ERROR_IP_NOT_ALLOWED La richiesta con la chiave dell'account corrente non è consentita dal tuo IP. Consulta la sezione con la lista di IP che si trova nelle impostazioni di sicurezza all'interno dell'area clienti.
12 ERROR_CAPTCHA_UNSOLVABLE Il captcha non è stato risolto da 5 lavoratori diversi. Questi task vengono addebitati ai clienti perché richiedono del tempo ai nostri lavoratori.
12 ERROR_BAD_DUPLICATES La funzione di riconoscimento al 100% non ha funzionato a causa della mancanza di tentativi di guessing.
14 ERROR_NO_SUCH_METHOD Richiesta all'API fatta con un metodo inesistente. Spesso questo accade quando i programmatori digitano male i nomi dei metodi.
15 ERROR_IMAGE_TYPE_NOT_SUPPORTED Non si è potuto determinare il tipo di file del captcha dal suo header exif oppure il tipo di immagine non è supportato. Gli unici formati consentiti sono JPG, GIF e PNG. Le immagini devono contenere l'header EXIF che contiene le informazioni sul tipo di immagine.
16 ERROR_NO_SUCH_CAPCHA_ID Il captcha richiesto non esiste nella tua lista di captcha attivi oppure è scaduto.
I captcha vengono rimossi dall'API 60 secondi dopo che un lavoratore li ha completati. Durante questo tempo la tua app deve inviare le valutazioni dei risultati di tutti i task e le richieste di segnalazione di captcha corretti/sbagliati.
21 ERROR_IP_BLOCKED Il tuo IP è bloccato a causa di un utilizzo scorretto dell'API. Cerca il motivo qui.
22 ERROR_TASK_ABSENT La proprietà "task" è vuota o non impostata nel metodo createTask.
23 ERROR_TASK_NOT_SUPPORTED Il tipo di task non è supportato oppure è scritto male. Controlla la proprietà "type" nell'oggetto del task.
24 ERROR_INCORRECT_SESSION_DATA Mancano alcuni dei valori richiesti per l'emulazione utente seguente. L'output API contiene più informazioni su ciò che manca.
25 ERROR_PROXY_CONNECT_REFUSED Non ci si può connettere al proxy del task, connessione respinta.
Scopri di più su come lavorare con proxy in questa sezione di FAQ.
26 ERROR_PROXY_CONNECT_TIMEOUT Non ci si può connettere al proxy del task, connessione scaduta.
Scopri di più su come lavorare con proxy in questa sezione di FAQ.
27 ERROR_PROXY_READ_TIMEOUT Tempo di lettura del proxy del task è scaduto
Scopri di più su come lavorare con proxy in questa sezione di FAQ.
28 ERROR_PROXY_BANNED L'IP del proxy è bannato dal servizio bersaglio.
29 ERROR_PROXY_TRANSPARENT Il task è rifiutato durante il controllo del proxy. Per nascondere l'IP del nostro server il proxy non deve essere trasparente. Usiamo il nostro strumento di controllo proxy per fare il debug del tuo proxy.
30 ERROR_RECAPTCHA_TIMEOUT Il task Recaptcha è scaduto, forse a causa di un server proxy lento o di un server Google
31 ERROR_RECAPTCHA_INVALID_SITEKEY Il fornitore di captcha ha segnalato che la site key non è valida.
32 ERROR_RECAPTCHA_INVALID_DOMAIN Il fornitore di captcha ha segnalato che il dominio per questa site key non è valido.
33 ERROR_RECAPTCHA_OLD_BROWSER Il fornitore di captcha ha segnalato che il browser user-agent non è compatibile col suo javascript
34 ERROR_TOKEN_EXPIRED Il server fornitore del captcha ha segnalato che il token variabile aggiuntivo è scaduto. Prova di nuovo con un nuovo token.
35 ERROR_PROXY_HAS_NO_IMAGE_SUPPORT Il proxy non supporta il trasferimento di dati di immagini dai server Google. Usiamo il nostro strumento di controllo proxy per fare il debug del tuo proxy.
36 ERROR_PROXY_INCOMPATIBLE_HTTP_VERSION Il proxy non supporta richieste GET lunghe con con una lunghezza di circa 2000 byte e non supporta le connessioni SSL. Usiamo il nostro strumento di controllo proxy per fare il debug del tuo proxy.
49 ERROR_PROXY_NOT_AUTHORISED Il nome utente e la password del proxy sono sbagliati. Usiamo il nostro strumento di controllo proxy per fare il debug del tuo proxy.
51 ERROR_INVISIBLE_RECAPTCHA Si è cercato di risolvere l'Invisible Recaptcha come un captcha normale.
52 ERROR_FAILED_LOADING_WIDGET Non si è potuto caricare il widget che fornisce i captcha nel browser del lavoratore. Invia un nuovo task.
53 ERROR_VISIBLE_RECAPTCHA Si è tentato di risolvere il consueto Recaptcha V2 come Recaptcha V2 invisibile. Togli la spunta 'isInvisible' dal carico utile dell'API.
54 ERROR_ALL_WORKERS_FILTERED
Non ci sono lavoratori non filtrati dal metodo reportIncorrectRecaptcha.
55 ERROR_ACCOUNT_SUSPENDED Il sistema ha sospeso il tuo account per un motivo importante. Contatta l'assistenza per informazioni.