CapMonster Cloud API

Riconoscimento Automatico CAPTCHA tramite API di CapMonster Cloud

Il riconoscimento CAPTCHA tramite l’API di CapMonster Cloud è un processo automatizzato per riconoscere e risolvere parole o simboli tramite interfacce di programmazione. Con CapMonster Cloud puoi automatizzare il bypass dei CAPTCHA e velocizzare il tuo flusso di lavoro.

Come Funziona

L’API risolve i CAPTCHA seguendo questo processo:

1. Invio della Richiesta

Il client invia una richiesta al server API, fornendo i dati CAPTCHA (immagine, chiavi del sito, URL).

2. Elaborazione

Il server API elabora la richiesta, riconosce il CAPTCHA e inizia a risolverlo.

3. Ricezione della Soluzione

Il server API risolve il CAPTCHA, consentendo al client di continuare con la verifica.

Perché Usare un'API per Risolvere i CAPTCHA

Le API (Interfacce di Programmazione delle Applicazioni) automatizzano le azioni sui siti web.

Compilazione di moduli di registrazione

Estrazione e copia dei dati

Invio di vari tipi di informazioni a un server

Risoluzione CAPTCHA Automatica tramite API

L'API CapMonster Cloud utilizza richieste HTTP standard con dati in formato JSON.

Indirizzi API

createTask
Crea un'attività per la risoluzione del CAPTCHA.
javascript
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Verifica lo stato dell’attività e recupera i risultati.
javascript
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Recupera il saldo attuale dell’account.
javascript
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Fornisce i dati più recenti di browser e sistema operativo.
javascript
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Algoritmo di risoluzione dei CAPTCHA

Ottenere la chiave

Per prima cosa, ottieni la tua chiave API unica nel pannello personale di CapMonster Cloud.

Invio di una richiesta per creare un'attività

Invia una richiesta HTTP POST all'indirizzo:

javascript

https://api.capmonster.cloud/createTask

Includi la tua chiave API e i dettagli dell'attività nella richiesta.

Ecco come dovrebbe apparire la tua richiesta:

json

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

Il server restituirà l'identificatore del CAPTCHA (taskId) o un codice di errore se qualcosa va storto.

Ottenere la risposta

Dopo aver creato l'attività, invia una richiesta per ottenere la risposta all'indirizzo:

javascript

https://api.capmonster.cloud/getTaskResult

Includi la tua chiave API e l'identificatore dell'attività (taskId).

Ecco come dovrebbe apparire la tua richiesta:

json

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

Il server risolverà il CAPTCHA o fornirà informazioni che l'attività è ancora in corso.

Esempio di risposta:

json

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

Gestione degli errori: tipi principali e istruzioni per la risoluzione dei problemi

Errori principali che potresti incontrare:

INVALID KEY

Codice di errore API: ERROR_KEY_DOES_NOT_EXIST

Questa notifica indica che la chiave API inserita è errata o non esiste. Verifica se l'hai inserita correttamente e riprova.

NO FUNDS

Codice di errore API: ERROR_ZERO_BALANCE

Questa notifica indica che non hai fondi sufficienti per completare l'attività (cioè il saldo è zero). Ricarica il tuo account per continuare a risolvere.

BIG IMAGE SIZE

Codice di errore API: ERROR_TOO_BIG_CAPTCHA_FILESIZE

Questa notifica indica che la dimensione del CAPTCHA supera il limite.

ZERO IMAGE SIZE

Codice di errore API: ERROR_ZERO_CAPTCHA_FILESIZE

Questa notifica indica che la dimensione del CAPTCHA che stai caricando è inferiore a 100 byte.

CAPTCHA ID IS NOT FOUND

Codice di errore API: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

Il CAPTCHA non è stato trovato nel sistema (il suo ID non è stato localizzato). Lo stato del CAPTCHA deve essere controllato entro i primi 5 minuti dall'invio. Assicurati di controllare entro questo lasso di tempo.

CAPTCHA UNSOLVABLE

Codice di errore API: ERROR_CAPTCHA_UNSOLVABLE

Questo tipo di CAPTCHA non è supportato dal servizio, o l'immagine non contiene una risposta leggibile, il che significa che è rumore. Potrebbe essere danneggiata o renderizzata in modo errato.

CAPTCHA IS NOT READY

Codice di errore API: CAPTCHA_NOT_READY

Il CAPTCHA non è ancora stato risolto. Attendi un minuto o due.

REQUEST IS NOT ALLOWED FROM YOUR IP

Codice di errore API: ERROR_IP_NOT_ALLOWED

Questa notifica indica che la richiesta da questo indirizzo IP è stata rifiutata. Apri le impostazioni del tuo account personale e aggiungi il tuo IP alla lista dei consentiti.

IP BANNED

Codice di errore API: ERROR_IP_BANNED

Hai superato il limite di richieste con una chiave API errata. Verifica la chiave e prova a creare nuovamente l'attività.

INCORRECT METHOD

Codice di errore API: ERROR_NO_SUCH_METHOD

Il tipo di CAPTCHA (valore del parametro "type") è errato. Verifica la correttezza del metodo utilizzato.

THE TOKEN IS EXPIRED

Codice di errore API: ERROR_TOKEN_EXPIRED

Durante il riconoscimento del CAPTCHA, il provider ha notato che il token aggiuntivo è scaduto. Crea una nuova attività, ottieni un nuovo token e riprova la richiesta.

NO FREE SERVERS

Codice di errore API: ERROR_NO_SLOT_AVAILABLE

Tutti i server sono occupati. Riprova più tardi.