Informazioni sulle chiavi API

In questo articolo spieghiamo cos’è un’API e come generare una chiave API per concedere l’accesso al tuo account Mailchimp. Parleremo anche di dove rivolgersi per richiedere supporto per eventuali domande sull’API di marketing Mailchimp.

Che cos’è un’API?

API è l'acronimo di application programming interface (interfaccia di programmazione di un'applicazione). Puoi pensare all’API come una modalità di comunicazione tra varie app. Invii e ricevi dati tra le app utilizzando richieste e risposte API. Una chiave API è una serie unica di caratteri inclusa in una richiesta per verificare che il sistema che ha inviato la richiesta sia autorizzato a comunicare con il sistema che la riceve.

Genera una chiave API

Spesso dovrai generare una chiave API quando imposti un’integrazione con il tuo account Mailchimp. Gli utenti con autorizzazioni Manager possono generare e visualizzare le proprie chiavi API. Gli utenti con autorizzazioni Amministratore possono visualizzare anche le chiavi API generate da altri utenti con account.

Per generare una chiave API, segui queste indicazioni.

1. Fai clic sull’icona del tuo profilo e seleziona Profilo.
2. Fai clic sul menu a tendina Extra e scegli Chiavi API.
3. Nella sezione Le tue chiavi API, fai clic su Crea una chiave.
4. Assegna un nome alla tua chiave. Adopera un nome descrittivo, in modo da sapere quale app la utilizza. Ricorda che vedrai solo questo nome e le prime quattro cifre nella tua lista di chiavi API.
5. Fai clic su “Generate Key” (Genera chiave).
6. Una volta generata la chiave, fai clic su “Copy Key to Clipboard” (Copia chiave negli appunti). Salva la chiave in un luogo sicuro: non potrai visualizzarla o copiarla di nuovo. Se perdi questa chiave, dovrai generarne una nuova e aggiornare qualsiasi integrazione che la utilizza.
7. Fai clic su “Done” (Fatto).

Revoca una chiave API

Se ritieni che una chiave API sia stata compromessa o se non usi più l’integrazione che accedeva al tuo account mediante tale chiave API, puoi revocarla. Dopo avere revocato una chiave API, non potrai riattivarla. Dovrai generare una nuova chiave e aggiornare eventuali integrazioni che utilizzavano la chiave originale.

Per revocare una chiave API, segui questa procedura.

1. Fai clic sull’icona del tuo profilo e seleziona Profilo.
2. Fai clic sul menu a tendina Extra e scegli Chiavi API.
3. Trova la chiave API da revocare e fai clic su Revoca.
4. Nella finestra pop-up, digita REVOCA , quindi fai clic su Revoca per confermare l’operazione.

Sicurezza delle chiavi API

Le chiavi API consentono l’accesso completo al tuo account Mailchimp. È necessario proteggerle allo stesso modo in cui proteggi la tua password. Tieni presente questi scenari comuni quando lavori con le chiavi API.

• Assegna a ciascuna integrazione una diversa chiave API. Assegna nomi descrittivi a ciascuna chiave in modo da sapere quale chiave corrisponde a quale app. Se una chiave API specifica viene compromessa, puoi revocare tale chiave senza disabilitare l’accesso a tutte le altre integrazioni.
• Fai attenzione a non mostrare la chiave al pubblico (ad esempio, in schermate, video o documentazione di aiuto). Ricorda che la sfocatura dei dati non sempre è sufficiente. È meglio rimuovere completamente i dati.
• A causa dei potenziali rischi di sicurezza associati all’esposizione delle chiavi API dell’account, Mailchimp non supporta l’implementazione dal lato client della nostra API utilizzando richieste CORS o includendo chiavi API nelle app mobili.
• Se devi condividere l’accesso al tuo account, genera una nuova chiave e assegnale un nome in modo da sapere quale chiave revocare, se necessario. Non inviare mai una chiave API per email. Ciò potrebbe consentire l’accesso al tuo account Mailchimp se gli hacker dovessero compromettere il tuo account email.
• Se revochi l’accesso di un utente al tuo account Mailchimp, noi rimoveremo eventuali chiavi API create da quell’utente dal tuo account.
• L’accesso a ciascun endpoint è determinato dal ruolo dell’utente che ha generato la chiave API. Per ulteriori informazioni sulle autorizzazioni degli utenti, visita la pagina Gestisci livelli utente nel tuo account.

Supporto API

Il nostro team di supporto Mailchimp non è formato per la risoluzione approfondita dei problemi relativi alle API. Se cerchi uno sviluppatore che ti aiuti nelle configurazioni di qualcosa adoperando l'API, consulta la nostra esaustiva Directory degli esperti. Questa elenca gli esperti Mailchimp di terze parti che possono essere assunti per aiutarti.

Se sei uno sviluppatore che desidera creare la sua integrazione con Mailchimp, consulta la nostra documentazione API.