Salta ai contenuti
ALTCHA ALTCHA ALTCHA

Chiavi API

Le chiavi API autorizzano l’accesso all’API e devono essere incluse con ogni richiesta. Ci sono due tipi:

  • Chiavi API a pagamento (che iniziano con key_...)
  • Chiavi API gratuite (che iniziano con ckey_..., dove c sta per crittografico)

Creazione di una nuova chiave API

Per ottenere una chiave API a pagamento, seguire questi passaggi:

  1. Registrati per un account nell’App ALTCHA su eu.altcha.org per i clienti dell’UE, o us.altcha.org per i clienti negli Stati Uniti.

  2. Dopo la registrazione, crea un nuovo progetto.

  3. Apri il progetto appena creato e vai alle impostazioni del progetto:

  4. Fare clic su “Crea chiave API,” dare un nome e fare clic su “Salva.”

Le chiavi API a pagamento sono specifiche della regione e possono essere utilizzate solo nella regione in cui sono state create.

Configurazione delle chiavi API

Durante la creazione di una nuova chiave API, vedrai diverse opzioni di configurazione:

  • Nome: Un nome personalizzato per aiutare a identificare la chiave.
  • Segreto: Un segreto chiave per la verifica crittografica, generato casualmente per impostazione predefinita.
  • Limiti di velocità: Un limite di velocità opzionale applicato a tutte le richieste autenticate con questa chiave.
  • Domini di referral: Un elenco opzionale di nomi di dominio consentiti. Inserire un dominio per riga. Per le porte non standard, formattare come <dominio>:8080.
  • Funzionalità: Abilita funzionalità specifiche per questa chiave API.

Limiti di velocità

È possibile configurare limiti di velocità personalizzati per ogni chiave API, espressi come richieste per intervallo (<richieste>/<intervallo>). Ad esempio:

  • 100/120s: Limita a 100 richieste ogni 120 secondi.
  • 100/10m: Limita a 100 richieste ogni 10 minuti.
  • 10/1h: Limita a 10 richieste ogni 1 ora.
  • 10/1d: Limita a 10 richieste al giorno.

Lasciare vuoto il campo Limiti di velocità permetterà richieste illimitate, ma si applicheranno comunque i limiti di velocità globali.

Funzionalità

Ogni chiave API deve avere almeno una funzionalità selezionata. Solo le funzionalità selezionate saranno accessibili con la chiave.