Så här hanterar du ditt kontos API-nyckel
Ägare, administratörer och chefer har tillgång till fliken API-nycklar.
Ta reda på hur du får tillgång till och hanterar dina API-nycklar för ditt Klaviyo-konto.
Om du vill lära dig hur du skapar eller klonar en privat API-nyckel kan du läsa så skapar du privata API-nycklar.
Skillnader mellan offentliga och privata API-nycklar
Din offentliga API-nyckel kallas även för ditt webbplats-ID. Detta är ett kort alfanumeriskt värde. Den här offentliga nyckeln är en unik identifierare för ditt Klaviyo-konto och det finns bara en per konto. Du kan inkludera din offentliga API-nyckel i webbplatskoden. Det ger inte behörighet att läsa privata kontodata.
Privata API-nycklar gör att applikationer kan läsa eller ändra data i ditt Klaviyo-konto, till exempel listor, enligt de behörigheter (scopes) som du väljer. Behandla privata API-nycklar som lösenord: förvara dem på en säker plats och exponera dem aldrig för allmänheten. Ett Klaviyo-konto kan generera så många privata API-nycklar som behövs.
Så ska du göra om din API-nyckel har exponerats
Din offentliga API-nyckel är avsedd för användning i offentlig webbplatskod. Det låter inte någon läsa privata data i ett Konto, men det kan användas för att skicka in data via klient-API:er, till exempel händelser och profiluppdateringar.
Håll privata API-nycklar konfidentiella. Någon med en privat nyckel kan använda dess behörigheter för att visa eller redigera kunddata.
Om en privat API-nyckel exponeras ska du radera den omedelbart och sedan skapa en ny privat API-nyckel. Uppdatera varje applikation som använde den exponerade nyckeln så att den använder den nya nyckeln. Ge ersättningsnyckeln bara de behörigheter som applikationen behöver och använd en annan privat API-nyckel för varje applikation.
Hitta dina API-nycklar
Kopiera eller ladda ned en privat API-nyckel när du skapar den, innan du lämnar bekräftelsesidan. Du kan inte visa hela nyckeln igen senare. Förvara den säkert, till exempel i ett valv eller en lösenordshanterare, och dela den bara med personer som du litar på. Om du inte sparade nyckeln kan du skapa en ny nyckel eller klona den befintliga.
- Klicka på ditt kontonamn längst ner till vänster.
- Klicka på Inställningar.
- Välj fliken API-nycklar .
- Visa din offentliga API-nyckel (webbplats-ID).
- Under Privata API-nycklar granskar du nyckelnamn och åtkomstnivåer. Du kan identifiera en nyckel genom dess 4 sista tecken, men du kan inte visa eller kopiera hela nyckeln här.
Om en nyckel inte finns på fliken Aktiv kan du kontrollera Inaktiv eller Inaktiverad om de flikarna visas.
Klona privata API-nycklar
När du klonar befintliga privata API-nycklar kommer den klonade nyckeln att:
- Vara en helt annan nyckel än originalet.
- Använd samma namn som originalet.
- Har samma omfattningar som originalet, förutom föråldrade omfattningar som inte längre stöds.
Kloning lämnar den ursprungliga nyckeln kvar. Kopiera eller ladda ner den klonade nyckeln och förvara den säkert. Om du vill använda den i en applikation uppdaterar du applikationens inställningar med den nya nyckeln. Ta bort den ursprungliga nyckeln när den inte längre behövs.
Ta bort en privat API-nyckel
Att ta bort en privat API-nyckel kan inte ångras. API-begäranden som använder den kommer att sluta fungera. Om du ersätter en nyckel som inte har exponerats ska du uppdatera och testa applikationerna som använder den innan du tar bort den. Om nyckeln exponeras ska du ta bort den omedelbart.
- Öppna fliken API-nycklar genom att följa stegen ovan. Under Privata API-nycklar hittar du nyckeln du vill ta bort.
- Öppna 3-punktsmenyn bredvid nyckeln och välj Ta bort.
- Klicka på Ta bort i bekräftelsedialogrutan.
Ytterligare resurser
- Så skapar eller klonar du en privat API-nyckel
Lär dig hur du skapar en privat API-nyckel, som är en unik identifierare som används för API-anrop, och hur du definierar ett omfång.
- Förstå hur information utbyts mellan Klaviyo och appar
Läs om hur information synkroniseras mellan Klaviyo och dina tredjepartsappar via ett programmeringsgränssnitt (API). De flesta data som utbyts via en Klaviyo-integration är enkelriktade: data hämtas in till ditt Klaviyo-konto så att du kan dra nytta av ett brett omfång av dina kunders data.
- Klaviyo's API reference guide