Vai al contenuto principale

​
Introduzione

hCaptcha è un servizio di verifica CAPTCHA fornito da Ace Data Cloud. Con la soluzione hCaptcha, tramite l’API unificata di Ace Data Cloud, puoi utilizzare cURL per chiamare rapidamente hCaptcha, ottenendo il Token hCaptcha, il riconoscimento delle immagini hCaptcha e altre funzionalità.

​
Prerequisiti

  • Avere un account su Ace Data Cloud e ottenere un API Token
  • Ambiente terminale con cURL installato

​
Uso Base

L’endpoint principale per chiamare l’API hCaptcha è: 
POST https://api.acedata.cloud/captcha/token/hcaptcha
Esempio completo di comando cURL: 
curl -X POST https://api.acedata.cloud/captcha/token/hcaptcha \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo"}'
Sostituisci YOUR_API_TOKEN con il Token reale ottenuto dalla piattaforma Ace Data Cloud.

​
Esempio di Risposta

Dopo una chiamata riuscita, viene restituito un dato in formato JSON, ad esempio: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Utilizzo di jq per Gestire la Risposta

Si consiglia di utilizzare lo strumento jq per formattare l’output: 
curl -s -X POST https://api.acedata.cloud/captcha/token/hcaptcha \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "a5f74b19-9e45-40e0-b45d-47ff91b7a6c2", "website_url": "https://accounts.hcaptcha.com/demo"}' | jq .

​
Gestione degli Errori

Codici di errore comuni:
Codice StatoDescrizione
401Autenticazione fallita, controlla l’API Token
403Saldo insufficiente o accesso negato
429Limite di frequenza richieste superato
500Errore interno del server

​
Passi Successivi