Come gestire le chiavi API del tuo account
I proprietari, gli amministratori e i responsabili possono accedere alla scheda Chiavi API.
Scopri come accedere alle tue chiavi API e come gestirle per il tuo account Klaviyo.
Se vuoi sapere come creare o clonare una chiave API privata, leggi come creare chiavi API private.
Differenza tra chiavi API pubbliche e private
La tua chiave API pubblica è anche chiamata ID sito. Si tratta di un valore alfanumerico breve. Questa chiave pubblica è un identificatore univoco per il tuo account Klaviyo e ce n'è solo 1 per account. Puoi includere la tua chiave API pubblica nel codice del sito web. Non concede l'autorizzazione a leggere i dati privati dell'account.
Le chiavi API private consentono alle applicazioni di leggere o modificare i dati nel tuo account Klaviyo, ad esempio gli elenchi, in base alle autorizzazioni (ambiti) che selezioni. Tratta le chiavi API private come password: conservale in un luogo sicuro e non rivelarle mai al pubblico. Un account Klaviyo può generare tutte le chiavi API private necessarie.
Cosa fare se la chiave API viene esposta
La tua chiave API pubblica è destinata all'uso nel codice di siti web pubblici. Non permette a qualcuno di leggere i dati privati dell'account, ma può essere utilizzata per inviare dati tramite API client, come eventi e aggiornamenti del profilo.
Mantieni riservate le chiavi API private. Chiunque disponga di una chiave privata può usare le sue autorizzazioni per visualizzare o modificare i dati dei clienti.
Se una chiave API privata viene esposta, eliminala immediatamente, poi crea una nuova chiave API privata. Aggiorna ogni applicazione che utilizzava la chiave esposta in modo che utilizzi la nuova chiave. Concedi alla chiave sostitutiva solo i permessi di cui l'applicazione ha bisogno e usa una chiave API privata diversa per ogni applicazione.
Trova le tue chiavi API
Copia o scarica una chiave API privata quando la crei, prima di uscire dalla pagina di conferma. Non puoi visualizzare di nuovo la chiave completa in un secondo momento. Conservala in modo sicuro, ad esempio in un vault o in un gestore di password, e condividila solo con parti di cui ti fidi. Se non hai salvato la chiave, crea una nuova chiave o clona quella esistente.
- Fai clic sul nome del tuo account in basso a sinistra.
- Fai clic su Impostazioni.
- Seleziona la scheda chiavi API .
- Visualizza la tua chiave API pubblica (ID sito).
- In chiavi API private, controlla i nomi delle chiavi e i livelli di accesso. Puoi identificare una chiave dalle ultime 4 caratteri, ma qui non puoi visualizzare né copiare la chiave completa.
Se una chiave non è nella scheda Attiva, controlla Inattiva o Disabilitata se queste schede vengono visualizzate.
Clonare chiavi API private
Quando cloni chiavi API private esistenti, la chiave clonata:
- Sarà una chiave completamente diversa dall'originale.
- Usa lo stesso nome dell’originale.
- Avere gli stessi scope dell'originale, ad eccezione degli scope obsoleti che non sono più supportati.
La clonazione lascia la chiave originale al suo posto. Copia o scarica la chiave clonata e conservala in modo sicuro. Per utilizzarla in un’applicazione, aggiorna le impostazioni dell’applicazione con la nuova chiave. Elimina la chiave originale quando non serve più.
Elimina una chiave API privata
L'eliminazione di una chiave API privata non può essere annullata. Le richieste API che lo utilizzano smetteranno di funzionare. Se stai sostituendo una chiave che non è stata esposta, aggiorna e testa le applicazioni che la utilizzano prima di eliminarla. Se la chiave è esposta, eliminala immediatamente.
- Apri la scheda chiavi API seguendo i passaggi sopra. In Chiavi API private, trova la chiave che vuoi eliminare.
- Apri il menu con tre puntini accanto alla chiave e seleziona Elimina.
- Fai clic su Elimina nella finestra di dialogo di conferma.
Risorse aggiuntive
- How to create or clone a private API key
Learn how to create a private API key, which is a unique identifier used for API calls, as well as define a scope.
- Understanding how information is exchanged between Klaviyo and apps
Learn about how information syncs between Klaviyo and your third-party apps via an application programming interface (API). Most data exchanged via a Klaviyo integration is one-way: data is pulled into your Klaviyo account so you can leverage a broad scope of your customer's data.
- Klaviyo's API reference guide