API key
Una API key è una stringa segreta che dimostra che un altro sistema è autorizzato a leggere i tuoi dati. Funziona come una password, con una differenza: a inserirla è un programma, non una persona, e resta valida finché non la revochi.
Da sapere: l'editor e l'account di Gatherino sono disponibili in inglese o ceco. I moduli compilati dai tuoi rispondenti possono essere mostrati in 18 lingue, inclusa questa.
La chiave si crea nelle impostazioni e viene mostrata una sola volta. Salvala subito in una variabile d'ambiente o in un gestore di segreti sul tuo server: non potrai più rileggerla, perché viene memorizzata in una forma da cui il valore originale non può essere ricavato.
L'errore più comune è inserire la chiave nel JavaScript della pagina. Il sorgente della pagina nel browser è pubblico: chiunque può copiare la chiave e scaricare ogni risposta da ciascuno dei tuoi moduli. Le chiamate API vanno quindi eseguite su un server che custodisce la chiave e restituisce solo ciò che è destinato a essere pubblico.
Se una chiave viene compromessa, non verificare se qualcuno l'ha usata: revocala e generane una nuova. La revoca è immediata e la vecchia chiave smette di funzionare.
In pratica
- La chiave va in una variabile d'ambiente lato server, non in un repository e non nel frontend.
- Preferisci una chiave separata per ogni integrazione, così puoi revocare solo quella.
- Sostituisci la chiave quando una persona che la conosceva lascia il team.
FAQ
Dove creo una API key?
In Impostazioni → API keys. Viene mostrata una sola volta.
Come viene inviata la chiave?
In un header Authorization: Bearer <key> oppure in un header x-api-key.
Cosa succede se revoco una chiave?
Smette di funzionare immediatamente e le integrazioni che la usano ricevono un errore 401.
Correlati
Prova Gatherino gratis
Piano gratuito: 3 moduli e 100 risposte al mese. Nessuna carta di credito, dati ospitati nell'UE.
Inizia gratis →