Salta ai contenuti

Chiavi API gratuite

Le Chiavi API gratuite sono disponibili senza costi aggiuntivi, offrendo un accesso limitato all’API anti-spam.

Condizioni per le Chiavi API gratuite:

Accesso gratuito vs. a pagamento

Passare alle Chiavi API a pagamento sblocca funzionalità aggiuntive come Analisi API e Registri, permettendoti di monitorare l’utilizzo dell’API per i tuoi siti web e applicazioni.

FunzionalitàGratuitaA pagamento
Limite di richiesta50 richieste/giornoBasato sul volume acquistato
Limiti di referrerUn referrer per chiaveRegolabile
Analisi APINo
Registri delle richieste APINo
È richiesta l’attribuzioneNo

Generare una Chiave API gratuita

Le Chiavi API gratuite sono legate a un nome di dominio specifico e funzionano solo su siti web ospitati sul nome di dominio fornito.

Genera una Chiave API gratuita
Se stai utilizzando un numero di porta non standard, inserisci il nome di dominio e la porta in questo formato: esempio.com:3000.

Il server genererà una nuova Chiave API gratuita e un segreto:

{
"hostname": "esempio.com",
"apiKey": "ckey_49960de...",
"secret": "csec_55de16dde79f94...",
"licenza": "...",
"verifica": {
"DNS": {
"name": "@",
"type": "TXT",
"value": "altcha-verification=..."
}
}
}

Il segreto csec_... viene utilizzato per la verifica del payload (come segreto HMAC) e deve rimanere confidenziale, mai esposto pubblicamente.

Fai riferimento alla documentazione per apprendere come generare una nuova Chiave API utilizzando l’API.

Verifica del Dominio

Anche se facoltativa, la verifica del dominio è fortemente consigliata. Verificare il possesso del proprio nome di dominio tramite il record DNS TXT configurato con il valore fornito altcha-verification=... aggiunge un ulteriore livello di sicurezza.

La verifica del dominio garantisce che la tua Chiave API sia correttamente associata al nome di dominio con cui è destinata a funzionare.

Per verificare il nome di dominio, segui questi passaggi:

  1. Accedi al pannello di gestione dei tuoi record DNS.
  2. Aggiungi un record TXT con i seguenti dettagli:
    • Tipo di Record: TXT
    • Host/Nome: @ (o il tuo nome di dominio)
    • Valore/Testo: altcha-verification=abc... (sostituisci abc... con il tuo token di verifica unico ottenuto alla generazione della Chiave API)
  3. Salva le modifiche.

Una volta che il record DNS è stato aggiunto con successo e propagato, il possesso del dominio verrà verificato. Ciò garantisce l’utilizzo sicuro della tua Chiave API con il nome di dominio specificato.

Attribuzione per le Chiavi API gratuite

Quando si utilizza la Chiave API gratuita, DEVI visualizzare “Protetto da ALTCHA” insieme al logo nel widget (cioè non utilizzare hidelogo o hidefooter). Se non stai utilizzando il widget, DEVI includere un’attribuzione nel piè di pagina del tuo sito web, almeno sulla homepage:

<a href="https://altcha.org">Protetto da ALTCHA</a>

Puoi tradurre o modificare il testo, ma deve trasmettere un significato simile a “Protetto da ALTCHA”. Il link deve reindirizzare a https://altcha.org e non dovrebbe includere rel="nofollow".

Attribuzione Chiave API gratuita

Non nascondere il logo e il piè di pagina con le Chiavi API gratuite