Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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, è necessario prima visitare la pagina corrispondente all’API di riconoscimento dei CAPTCHA alfanumerici e richiedere il servizio corrispondente. Una volta entrati nella pagina, cliccare sul pulsante “Acquire”, come mostrato nell’immagine: Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di login per registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si verrà riportati automaticamente alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare l’API senza costi.

​
Utilizzo di base

Per prima cosa, è importante 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:

Successivamente, dobbiamo convertire l’immagine del CAPTCHA in un’immagine codificata in Base64. Si consiglia di utilizzare l’estensione per Google Chrome FeHelper per effettuare la conversione. Per ulteriori dettagli sull’uso, fare riferimento all’immagine sottostante:

Dopo aver ottenuto il codice Base64 dall’estensione FeHelper, ricordarsi di non includere il prefisso data:image/png;base64. Il contenuto specifico è il seguente:

Possiamo vedere che 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, si può 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, e si ottiene il seguente risultato: 
{
  "text": "7364"
}
Il risultato restituito contiene diversi campi, descritti di seguito:
  • 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, e possiamo passare la verifica semplicemente basandoci sul contenuto testuale del campo text. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente: 
curl -X POST 'https://api.xhuoapi.ai/v1/captcha/recognition/image2text' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}'
Il codice di integrazione in Python è il seguente: 
import requests

url = "https://api.xhuoapi.ai/v1/captcha/recognition/image2text"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image": "iVBORw0KGgoAAAANSUhEUgAAAgUAAAE3CAYAAAA6xjI2AAAAAX..."
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di riconoscimento dei CAPTCHA alfanumerici per riconoscere CAPTCHA alfanumerici di lunghezza variabile. Inserendo il contenuto dell’immagine del CAPTCHA, si ottiene il risultato del CAPTCHA. Speriamo che questo documento ti aiuti a integrare e utilizzare meglio l’API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.