Skip to main content
Questo documento presenterà una guida all’integrazione dell’API di riconoscimento del protocollo Recaptcha2, che consente agli utenti di completare la verifica senza dover riconoscere e cliccare sulle immagini del codice captcha di Recaptcha2, ma semplicemente inviando la Website Key per attivare la decodifica automatica in background.

​
Processo di richiesta

Per utilizzare l’API di riconoscimento del protocollo Recaptcha2, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta include un credito gratuito, che consente di provare il servizio gratuitamente; se il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di riconoscimento del protocollo Recaptcha2 →

​
Utilizzo di base

Iniziamo a comprendere il modo di utilizzo di base, che consiste nell’inserire l’URL del sito web che necessita di elaborazione del captcha, per ottenere il risultato elaborato. Prima di tutto, è necessario trasmettere un campo website_url, il nostro sito di esempio è: https://www.google.com/recaptcha/api2/demo, dobbiamo ottenere il website_key dalla pagina website_url, per farlo, apri questa pagina, premi F12 per accedere alla console e infine cerca globalmente recaptcha-demo nella pagina Element, otterremo il seguente risultato:

Dove la stringa corrispondente a data-sitekey è il valore di website_key, di seguito sono riportati i risultati specifici dei parametri:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta che desideri ricevere, qui è impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • website_url: l’URL del sito web che necessita di elaborazione del captcha.
  • website_key: l’identificatore della chiave del sito in Recaptcha2.
Dopo aver selezionato, possiamo notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante «Try» è possibile effettuare un test, come mostrato nell’immagine sopra, qui abbiamo ottenuto il seguente risultato:
I risultati della richiesta contengono diversi campi, come segue:
  • token, il risultato della verifica dopo l’elaborazione del compito Recaptcha2.
Possiamo vedere che abbiamo ottenuto il risultato della verifica del compito Recaptcha2, quindi possiamo utilizzarlo per inviare una richiesta POST o simulare l’invio al sito web di destinazione, utilizzabile una sola volta, con una validità di 120 secondi, si consiglia di utilizzarlo entro 60 secondi. Di seguito verrà fornito un frammento di codice Python per inviare il token elaborato al sito web di destinazione per superare il Recaptcha2. Prima di tutto, dobbiamo capire come il sito invia la richiesta POST, in modo da poter inserire il token generato. Dobbiamo prima aprire la console F12, quindi completare manualmente la verifica, infine possiamo vedere che il sito ha inviato una richiesta POST. Dobbiamo solo esaminare la costruzione di questa richiesta POST, il processo specifico è il seguente:
  • Prima completare manualmente la verifica, come mostrato nell’immagine qui sotto:

  • Poi cliccare su invia, osservando le variazioni nella rete della console, come mostrato nell’immagine qui sotto:

  • Analizzare la costruzione della richiesta POST inviata, infine è possibile fare clic destro su questa richiesta per copiare il codice CURL, come mostrato nell’immagine qui sotto:

Dall’analisi dell’immagine sopra, si può notare che l’URL della richiesta POST è: https://www.google.com/recaptcha/api2/demo, dobbiamo solo inviare il parametro g-recaptcha-response, quindi dobbiamo solo passare il token elaborato nei dati sottostanti, il codice CURL specifico per la verifica del token è il seguente:
Il codice Python corrispondente per la verifica del token è il seguente:
Poi eseguiamo il codice e osserviamo che la console mostra il seguente risultato:

Infine, abbiamo superato la verifica del protocollo Recaptcha2. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente:
Il codice di integrazione Python è il seguente:

​
Modalità asincrona (async)

Per impostazione predefinita, l’API è bloccante e sincrona: una richiesta attenderà fino a quando il token non sarà elaborato prima di restituire. Se stai effettuando una rotazione multi-solver e desideri “ricevere immediatamente il task_id dopo aver inviato il compito, per poi programmare altri risolutori e tornare più tardi a prendere il risultato”, puoi passare async: true nel corpo della richiesta. Passando async: true, l’interfaccia restituirà immediatamente un task_id, senza bloccare l’attesa:
Successivamente, utilizza il task_id per interrogare POST /captcha/tasks (si consiglia ogni 3~5 secondi) per ottenere il risultato:
Durante l’elaborazione verrà restituito status: processing:
Una volta completata l’elaborazione, verrà restituito status: ready e il token:
Informazioni di fatturazione: in modalità asincrona, la creazione di un compito e l’interrogazione “in elaborazione” non comportano costi; si fattura solo una volta quando si ottiene con successo il risultato (allo stesso prezzo della modalità sincrona). Pertanto, annullare i compiti non completati durante la rotazione non comporterà costi. /captcha/tasks è comune a tutte le interfacce di verifica dei captcha (token e serie di riconoscimento), è possibile interrogare con lo stesso task_id.

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di riconoscimento del protocollo Recaptcha2 per consentire agli utenti di non dover riconoscere e selezionare le immagini del captcha Recaptcha2, ma di completare la verifica semplicemente inviando la Website Key. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.