Vai al contenuto principale

​
Introduzione

reCAPTCHA è un servizio di captcha fornito da Ace Data Cloud, una soluzione Google reCAPTCHA. Attraverso l’API unificata di Ace Data Cloud, puoi integrare rapidamente reCAPTCHA con Python, realizzando funzionalità come Token reCAPTCHA v2, riconoscimento reCAPTCHA v2, Token reCAPTCHA v3, ecc.

​
Prerequisiti

  • Possedere un account Ace Data Cloud e ottenere un API Token
  • Ambiente Python 3.7 o superiore
  • Installare la libreria requests: pip install requests

​
Uso Base

L’endpoint principale per chiamare l’API reCAPTCHA è: 
POST https://api.acedata.cloud/captcha/token/recaptcha2
Esempio completo di codice Python: 
import requests

url = "https://api.acedata.cloud/captcha/token/recaptcha2"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "website_url": "https://www.google.com/recaptcha/api2/demo"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Sostituisci YOUR_API_TOKEN con il Token reale ottenuto dalla piattaforma Ace Data Cloud.

​
Gestione della Risposta

Dopo una chiamata riuscita, l’API restituisce dati in formato JSON. Si consiglia di controllare il codice di stato HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Chiamata riuscita:", result)
else:
    print(f"Chiamata fallita, codice stato: {response.status_code}")
    print(response.text)

​
Uso Avanzato

Per le API che supportano attività asincrone, è possibile ottenere i risultati tramite un URL di callback: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Il risultato sarà inviato al tuo server tramite l'URL di callback

​
Gestione degli Errori

Codici di errore comuni:
Codice StatoDescrizione
401Autenticazione fallita, verifica API Token
403Saldo insufficiente o accesso negato
429Frequenza di richieste superata
500Errore interno del server

​
Altri Endpoint

Il servizio reCAPTCHA offre anche i seguenti endpoint:
  • POST https://api.acedata.cloud/captcha/recognition/recaptcha2
  • POST https://api.acedata.cloud/captcha/token/recaptcha3

​
Passi Successivi