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
- 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