Account e fatturazione
Chiavi API
Come creare, rinominare, impostare la scadenza e rimuovere una chiave API per poter chiamare l’API di FlowHunt dal tuo codice.
Una chiave API consente a uno script o a un’applicazione di chiamare l’API di FlowHunt come il tuo workspace senza effettuare l’accesso. Le chiavi appartengono al workspace, non a te personalmente, quindi le chiamate fatte con una di esse agiscono su quel workspace.
Creare una chiave#
Apri la scheda API Keys
Clicca su Settings nell’area dell’account, poi sulla scheda API Keys.
Aggiungi la chiave
Clicca su Add API Key. Nella finestra Create API Key, inserisci un Name che ti dica dove viene usata la chiave, ad esempio “Script di esportazione notturna”. Clicca su Add API Key per confermare.
Copiala subito
La finestra successiva mostra la chiave con un pulsante Copy to clipboard. FlowHunt mostra la chiave completa una sola volta e non può mostrarla di nuovo. Conservala in un gestore di segreti o in una variabile d’ambiente, mai nel codice che sottoponi al versionamento.
Se perdi una chiave, creane una nuova e rimuovi quella vecchia.
Usare la chiave#
La stessa finestra contiene Try API key, che apre il riferimento API su api.flowhunt.io/docs. Il riferimento elenca ogni endpoint e mostra come inviare la chiave. Un pulsante PHP SDK rimanda al pacchetto PHP di FlowHunt per i progetti PHP.
Gestire le chiavi#
L’elenco API Keys mostra il Name di ogni chiave, una versione mascherata della chiave, quando è stata Last used e la sua data Valid to.
- Rinominare o impostare una scadenza. Apri una chiave e modifica il suo Name o la data Valid to, poi clicca su Update API Key. La data di scadenza può essere impostata solo dopo la creazione.
- Rimuovere una chiave. Aprila e clicca su Remove API Key, poi conferma. Tutto ciò che usa ancora quella chiave smetterà di funzionare.
- Cercare. Usa la casella di ricerca sopra l’elenco per trovare una chiave.
Usa Last used per trovare le chiavi di cui nessuno ha più bisogno. Una chiave che non è mai stata usata, o non lo è stata per mesi, è una buona candidata alla rimozione.
Chi può farlo#
Owner e Admin possono creare, modificare e rimuovere chiavi. Editor può vedere l’elenco e creare chiavi, ma non può modificarle né rimuoverle. Member, Guest e Maintainer non vedono la scheda. Vedi team e ruoli.
Il tuo piano non limita quante chiavi puoi creare. I workspace annullati non possono creare chiavi.
Tratta una chiave come una password
Chiunque possieda la chiave può chiamare l’API come il tuo workspace. Se una chiave potrebbe essere stata compromessa, rimuovila dall’elenco e creane una sostitutiva.