Vai al contenuto principale
Questo documento introduce un’istruzione per l’integrazione dell’API di riconoscimento delle immagini Recaptcha2, che può identificare il contenuto inserito dall’utente e l’immagine del codice captcha Recaptcha2, restituendo infine le coordinate delle piccole immagini da cliccare per completare la verifica.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima richiedere il servizio corrispondente sulla pagina API di riconoscimento delle immagini Recaptcha2, una volta entrati nella pagina, cliccare sul pulsante “Acquire”, come mostrato nell’immagine: Se non sei ancora loggato o registrato, verrai automaticamente reindirizzato alla pagina di accesso che ti invita a registrarti e accedere; dopo aver effettuato il login o la registrazione, verrai riportato automaticamente alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare gratuitamente questa API.

​
Utilizzo di base

Prima di tutto, è necessario comprendere il modo di utilizzo di base; dobbiamo catturare l’immagine del codice captcha Recaptcha2 dal sito web, qui l’URL del sito di esempio: https://www.google.com/recaptcha/api2/demo, la pagina specifica è mostrata nell’immagine qui sotto:

Dobbiamo cliccare sulla casella di controllo del captcha affinché appaia l’immagine del captcha; nel’immagine sopra, la freccia gialla indica un testo, questo testo è il valore di question di seguito. Prima di tutto, è necessario passare un campo image, che è l’immagine specifica del captcha Recaptcha2, quest’immagine è quella indicata dalla freccia rossa nell’immagine sopra, e deve essere ridimensionata a una dimensione standard (100x100, 300x300, 450x450), in modo che il servizio possa determinare il tipo di immagine; la compressione dell’immagine deve essere effettuata da te, in questo documento si consiglia un sito di compressione, dove puoi comprimere le dimensioni e il peso dell’immagine, il risultato compresso è mostrato nell’immagine qui sotto: È inoltre necessario inserire il parametro di contenuto di riconoscimento relativo all’immagine del captcha question, abbiamo fornito solo il seguente elenco di contenuti, che può servire come riferimento:

​
Tabella dei contenuti in cinese

{
  "/m/0pg52": "出租车",
  "/m/01bjv": "巴士",
  "/m/02yvhj": "校车",
  "/m/04_sv": "摩托车",
  "/m/013xlm": "拖拉机",
  "/m/01jk_4": "烟囱",
  "/m/014xcs": "人行横道",
  "/m/015qff": "红绿灯",
  "/m/0199g": "自行车",
  "/m/015qbp": "停车计价表",
  "/m/0k4j": "汽车",
  "/m/015kr": "桥",
  "/m/019jd": "船",
  "/m/0cdl1": "棕榈树",
  "/m/09d_r": "山",
  "/m/01pns0": "消防栓",
  "/m/01lynh": "楼梯"
}

​
Tabella dei contenuti in inglese

{
  "/m/0pg52": "taxis",
  "/m/01bjv": "bus",
  "/m/02yvhj": "school bus",
  "/m/04_sv": "motorcycles",
  "/m/013xlm": "tractors",
  "/m/01jk_4": "chimneys",
  "/m/014xcs": "crosswalks", // pedestrian crossings è lo stesso
  "/m/015qff": "traffic lights",
  "/m/0199g": "bicycles",
  "/m/015qbp": "parking meters",
  "/m/0k4j": "cars",
  "/m/015kr": "bridges",
  "/m/019jd": "boats",
  "/m/0cdl1": "palm trees",
  "/m/09d_r": "mountains or hills",
  "/m/01pns0": "fire hydrant",
  "/m/01lynh": "stairs"
}
Da quanto sopra, possiamo impostare il parametro question come corrispondente al id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del id del 
import requests

url = "https://api.acedata.cloud/captcha/recognition/recaptcha2"

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

payload = {
    "question": "/m/01pns0",
    "image": "iVBORw0KGgoAAAANSUhEUgAAASoAAAEsCAIAAAD7AWllAAAAAX..."
}

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 relativo codice di errore e informazioni. 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 compreso come utilizzare l’API di riconoscimento delle immagini Recaptcha2 per far inserire agli utenti il contenuto da riconoscere e l’immagine del codice captcha Recaptcha2, infine restituire le coordinate della piccola immagine da cliccare per completare la 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.