Skip to main content
Questo documento introduce un’API di riconoscimento dei CAPTCHA alfanumerici, basata su tecnologie di deep learning, utilizzabile per riconoscere CAPTCHA alfanumerici di lunghezza variabile. Inserendo il contenuto dell’immagine del CAPTCHA, si ottiene il risultato del CAPTCHA.

​
Procedura di richiesta

Per utilizzare l’API di riconoscimento dei CAPTCHA alfanumerici, 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 inviterà a registrarti e a effettuare il login; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza necessità di richiederne uno per ogni servizio. La prima richiesta ti darà un credito gratuito, per un’esperienza senza costi; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di riconoscimento dei CAPTCHA alfanumerici →

​
Utilizzo di base

Iniziamo a comprendere il modo di utilizzo di base, che consiste nell’inserire l’immagine del CAPTCHA alfanumerico di lunghezza variabile da elaborare, per ottenere il risultato elaborato. È necessario semplicemente passare un campo image, che rappresenta l’immagine del CAPTCHA alfanumerico, come mostrato nell’immagine:

Dopo di che, dobbiamo convertire l’immagine del CAPTCHA in un’immagine codificata in Base64. Si consiglia di utilizzare l’estensione per Google Chrome FeHelper per la conversione; puoi fare riferimento all’immagine sottostante per le istruzioni specifiche:

Successivamente, puoi copiare il codice Base64 ottenuto dall’estensione FeHelper, ricordando che non deve includere il prefisso data:image/png;base64; il contenuto specifico è il seguente:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, che includono:
  • accept: il formato di risposta desiderato, 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:
  • image: l’immagine del CAPTCHA codificata in Base64 (senza il prefisso data:image/png;base64).
Dopo aver selezionato, puoi notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” puoi effettuare un test, come mostrato nell’immagine sopra, e qui abbiamo ottenuto il seguente risultato:
Il risultato restituito ha diversi campi, descritti come segue:
  • text, il contenuto testuale elaborato dall’immagine del CAPTCHA alfanumerico di lunghezza variabile.
Possiamo vedere che abbiamo ottenuto il risultato della verifica dell’immagine del CAPTCHA alfanumerico di lunghezza variabile; dobbiamo solo fare riferimento al contenuto testuale nel campo text per superare la verifica. Inoltre, se desideri generare il codice di integrazione corrispondente, puoi semplicemente copiarlo, ad esempio il codice CURL è il seguente:
Il codice di integrazione in Python è il seguente:

​
Modalità asincrona (async)

Per impostazione predefinita, l’API è sincrona e bloccante: una richiesta attenderà fino a quando il risultato del riconoscimento non sarà completato prima di restituire. Se stai effettuando un cambio di risolutori multipli (multi-solver rotation) e desideri “ottenere 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 risultato del riconoscimento text (la struttura dei campi è completamente identica a quella della modalità sincrona):
Informazioni di fatturazione: nella modalità asincrona, la creazione di un compito e l’interrogazione “in elaborazione” non comportano costi; si paga solo una volta quando si ottiene con successo il risultato del riconoscimento (allo stesso prezzo della modalità sincrona). Pertanto, annullare i compiti non completati durante il cambio non comporterà costi. /captcha/tasks è comune a tutte le interfacce CAPTCHA (token e serie di riconoscimento), puoi interrogare con lo stesso task_id.

​
Gestione degli errori

Quando chiami 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 dei codici di verifica numerici in inglese, che può essere utilizzata per riconoscere codici di verifica numerici in inglese di lunghezza variabile. Inserisci il contenuto dell’immagine del codice di verifica, e otterrai il risultato del codice di verifica. 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.