In questo articolo, spiegheremo cos'è una chiave API e come puoi crearne una o eliminare una chiave API esistente.

Buono a sapersi

Solo gli utenti Brevo con autorizzazione per le chiavi API possono accedere alla pagina Chiavi API e MCP, creare una nuova chiave API o eliminare una chiave API esistente.

➡️ Per ulteriori informazioni sulle autorizzazioni utente e sui livelli di autorizzazione, consulta il nostro articolo dedicato Autorizzazioni utente e livelli di autorizzazione in Brevo.

Che cos'è una chiave API?

Una chiave API è un codice utilizzato per identificare e autenticare un'applicazione o un utente. Funge da identificatore univoco e fornisce un token segreto per l'autenticazione.

Ad esempio, puoi usare una chiave API per collegare il tuo sito web o il tuo sistema informativo a Brevo. Questo ti consentirà di attivare automaticamente e manualmente determinate azioni tra i due.

Con una chiave API puoi anche collegarti alla nostra API per aggiungere automaticamente nuovi contatti e svolgere attività più complesse, come:

• Creare e programmare campagne dall'API.
• Esportare utenti appartenenti a particolari liste.
• Esportare le statistiche di una campagna, ecc.

Per accedere alla lista completa dei comandi che puoi utilizzare con la nostra API, consulta la relativa documentazione.

Dove posso trovare le mie chiavi API?

Per proteggere e rendere più sicure le tue chiavi API esistenti, queste non sono visibili sul tuo account Brevo. Nella pagina Chiavi API e MCP vengono visualizzate solo le ultime cifre delle chiavi, in modo da poter distinguere tra diverse chiavi, se necessario:

Ecco perché le consigliamo vivamente di memorizzare la sua chiave API in un ambiente sicuro quando la crea. Se ha perso la sua chiave API, le consigliamo di crearne una nuova, memorizzarla in un ambiente sicuro e sostituire quella precedente.

Creazione di una chiave API

Quando configuri un'integrazione con il tuo account Brevo, potresti dover creare una nuova chiave API:

1. Click your account dropdown and select Settings > SMTP & API > API Keys & MCP.
2. Click Generate a new API key.
   
3. Name your API key. Make sure it specifies with which integration the API key will be used so that you can easily recognize it.
4. Click Generate.
   
5. Copia la tua chiave API e conservala in un posto sicuro.
   
   ❗️ Importante

   Your API key is only visible during this step. Once your API key is created, you won't be able to copy it anymore and you'll need to create a new one if you lose it.
   
6. (Optional) Activate the Create MCP server API key option to generate a version of the API key allowing you to connect an AI system to Brevo via the MCP protocol. To learn more, check our dedicated article What is Model Context Protocol (MCP)?.
   💡 Buono a sapersi

   If you activate the Create MCP server API key, the API key created in step 4 is deactivated and a MCP version of the API key is generated instead.
7. Clicca su OK.

La nuova chiave API è stata creata.

Disattivazione di una chiave API

Se vuoi sospendere temporaneamente l'uso di una chiave API invece di cancellarla completamente, puoi disattivarla:

1. Clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > SMTP e API > API Keys & MCP (Chiavi API e MCP).
2. Seleziona la chiave API che desideri disattivare.
3. Clicca su Deactivate API key (Disattiva chiave API).
   

Hai disattivato con successo la tua chiave API.

To reactivate a key, select it again and click Activate API key.

Elimina una chiave API

Se il tuo account è stato compromesso o se non utilizzi più un'integrazione che richiede una particolare chiave API, puoi eliminare quella chiave API:

1. Clicca sul menu a discesa dell'account e seleziona Settings (Impostazioni) > SMTP e API > API Keys & MCP (Chiavi API e MCP).
2. Selezionare la chiave API che si desidera eliminare.
3. Clicca su Elimina chiave API.

La chiave API è stata eliminata correttamente.

Migliori pratiche di gestione delle chiavi API

Le chiavi API ti forniscono un accesso completo al tuo account Brevo e devono essere protette al pari di una password. Ecco alcune migliori pratiche da tenere a mente quando lavori con le chiavi API:

• Utilizza una chiave API diversa per ogni integrazione e specifica il nome dell'integrazione nel nome della chiave API, in modo da sapere esattamente quale chiave corrisponde a ciascuna integrazione. In questo modo, se una chiave API viene compromessa, puoi eliminarla senza influire sulle altre integrazioni.
• Conserva le chiavi API in un ambiente sicuro, non in un documento Word o su un post-it.
• Non mostrare mai pubblicamente la tua chiave API. Assicurati di nascondere la tua chiave API o, meglio ancora, tagliala completamente negli screenshot o nei video.
• Non inviare mai una chiave API via email, in quanto ciò consentirà l'accesso al tuo account Brevo se qualcuno viola il tuo account email.
• Elimina sempre le chiavi API che non usi più per limitare i rischi di fuga delle informazioni.

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.

Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.