Passa al contenuto principale

Creazione di chiavi API Growth+This feature requires the Growth+ plan or higher

Le chiavi API consentono alle applicazioni esterne di connettersi in modo sicuro al suo account EquipDash. Ogni chiave può essere limitata a operazioni specifiche, in modo da proteggere i suoi dati.


Generazione di una nuova chiave API​

  1. Fare clic su Impostazioni nella barra laterale.
  2. Selezionare API e integrazioni dal menu delle impostazioni.
  3. Nella scheda Chiavi API, fare clic su + Crea chiave API.
  4. Compilare i seguenti campi:
    • Nome -- un'etichetta descrittiva per questa chiave (ad esempio "Integrazione sito web", "App mobile", "Connessione Zapier").
    • Permessi -- selezionare quali permessi deve avere questa chiave. Per i dettagli su ogni permesso, consultare Spiegazione dei permessi API.
    • Data di scadenza (facoltativo) -- impostare una data dopo la quale la chiave smetterà di funzionare. Lasciare vuoto per nessuna scadenza.
    • Lista IP consentiti (facoltativo) -- limitare la chiave a indirizzi IP specifici per una maggiore sicurezza. Inserire un indirizzo IP per riga.
  5. Fare clic su Crea.

La pagina delle impostazioni API e integrazioni


Copia della chiave API​

Dopo aver creato la chiave, EquipDash mostrerà la chiave API completa una sola volta.

  1. Copiare subito la chiave e conservarla in un luogo sicuro (ad esempio un gestore di password o una variabile d'ambiente).
  2. Fare clic su Fatto per chiudere la finestra di dialogo.
attenzione

La chiave API completa viene mostrata una sola volta. Dopo aver chiuso questa finestra di dialogo, vedrà solo il prefisso della chiave (ad esempio edsk_live_abc1...). Se perde la chiave, dovrà crearne una nuova.


Gestione delle chiavi esistenti​

Tutte le sue chiavi API sono elencate nella pagina API e integrazioni, nella scheda Chiavi API. Per ogni chiave può vedere:

  • Nome -- l'etichetta che le ha assegnato.
  • Prefisso chiave -- i primi caratteri della chiave, utili per l'identificazione.
  • Permessi -- a cosa ha accesso la chiave.
  • Data di creazione -- quando è stata generata la chiave.
  • Ultimo utilizzo -- quando la chiave è stata usata l'ultima volta per effettuare una richiesta API.
  • Stato -- se la chiave è attiva o revocata.

Modifica di una chiave​

  1. Fare clic sul nome della chiave per visualizzarne i dettagli.
  2. È possibile aggiornare Nome, Permessi, Data di scadenza e Lista IP consentiti.
  3. Fare clic su Aggiorna.

Revoca di una chiave​

Se una chiave è stata compromessa o non serve più:

  1. Fare clic sul pulsante Revoca accanto alla chiave.
  2. Confermare l'operazione.

La revoca di una chiave blocca immediatamente tutte le richieste API che la utilizzano. Questa operazione non può essere annullata: se necessario, dovrà crearne una nuova.

Eliminazione di una chiave​

Per rimuovere definitivamente una chiave e i relativi log delle richieste:

  1. Fare clic sul pulsante Elimina accanto alla chiave.
  2. Confermare l'operazione.

Utilizzo della chiave API​

Includa la sua chiave API nell'intestazione Authorization di ogni richiesta API:

Authorization: Bearer edsk_live_your_full_key_here

Per la documentazione API completa, consulti Riferimento API di EquipDash.