UNLOCK API
Codici di errore

Codici di errore

I metodi JSON restituiscono errorId 1 con errorCode ed errorDescription. in.php e res.php restituiscono il nome dell'errore come testo, oppure {"status":0,"request":"ERROR_NAME"} con json=1. Lo stato HTTP è 200 in entrambi i casi, quindi leggi sempre il body.

Chiave, account e limiti

  • ERROR_KEY_DOES_NOT_EXIST
    Restituito da: JSONNon addebitato

    La chiave è errata. Copiala di nuovo dalla pagina account. (in.php e res.php: ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    Restituito da: in.php, res.phpNon addebitato

    in.php e res.php: la chiave è errata. Copiala di nuovo dalla pagina account.

  • ERROR_IP_NOT_ALLOWED
    Restituito da: EntrambiNon addebitato

    La richiesta arriva da un IP che non è nella lista consentiti dell'account. Aggiungi l'IP nella pagina account.

  • ERROR_IP_BANNED
    Restituito da: EntrambiNon addebitato

    Questo account è bloccato. Contatta il supporto dalla pagina account.

  • ERROR_ZERO_BALANCE
    Restituito da: EntrambiNon addebitato

    Il saldo non copre il task. Aggiungi fondi; non è stato addebitato nulla.

  • ERROR_TOO_MANY_REQUESTS
    Restituito da: EntrambiNon addebitato

    Troppe richieste. Rallenta i controlli dei risultati a uno ogni 5 secondi.

Task rifiutato all'invio

  • ERROR_TASK_NOT_SUPPORTED
    Restituito da: JSONNon addebitato

    Il tipo di task è sconosciuto o disattivato. Controlla il nome del tipo.

  • ERROR_BAD_PARAMETERS
    Restituito da: EntrambiNon addebitato

    Un campo obbligatorio manca o ha un formato errato.

  • ERROR_PAGEURL
    Restituito da: EntrambiNon addebitato

    websiteURL o pageurl manca o non è un indirizzo http(s) completo.

  • ERROR_GOOGLEKEY
    Restituito da: in.php, res.phpNon addebitato

    googlekey manca in una richiesta reCAPTCHA in.php.

  • ERROR_BAD_PROXY
    Restituito da: EntrambiNon addebitato

    Un task con proxy richiede proxyAddress e proxyPort.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    Restituito da: EntrambiNon addebitato

    L'immagine manca o è troppo piccola.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    Restituito da: EntrambiNon addebitato

    L'immagine supera 100 KB.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    Restituito da: EntrambiNon addebitato

    L'immagine non è un base64 valido.

  • ERROR_NO_SLOT_AVAILABLE
    Restituito da: EntrambiNon addebitato

    Troppe richieste in questo momento, il task non è stato accettato. Riprova tra qualche secondo; non è stato addebitato nulla.

Controllo del risultato

  • CAPCHA_NOT_READY
    Restituito da: in.php, res.phpNon addebitato

    Solo in.php e res.php: il task è ancora in corso. Controlla di nuovo tra 5 secondi.

  • ERROR_WRONG_CAPTCHA_ID
    Restituito da: EntrambiNon addebitato

    Non esiste alcun task con questo id nel tuo account.

  • ERROR_WRONG_ID_FORMAT
    Restituito da: in.php, res.phpNon addebitato

    res.php: l'id manca o non è un numero.

  • ERROR_CAPTCHA_UNSOLVABLE
    Restituito da: EntrambiRimborsato

    Il task non è stato risolto in tempo. L'importo è tornato sul saldo.

  • ERROR_PROXY_CONNECTION_FAILED
    Restituito da: EntrambiRimborsato

    Il risolutore non è riuscito a connettersi tramite il tuo proxy. Verifica che sia online e che le credenziali siano corrette.

Un task può fallire anche dopo essere stato accettato, ad esempio quando i parametri della pagina sono errati. getTaskResult restituisce allora il motivo come errorCode (uno dei codici sopra) e l'importo è già tornato sul saldo.