Zarządzanie kluczami API konta
Właściciele, administratorzy i menedżerowie mają dostęp do karty Klucze API.
Dowiedz się, jak uzyskać dostęp do kluczy API swojego konta Klaviyo i nimi zarządzać.
Jeśli chcesz dowiedzieć się więcej o tworzeniu lub klonowaniu prywatnego klucza API, przeczytaj jak tworzyć prywatne klucze API.
Różnica między publicznymi a prywatnymi kluczami API
Publiczny klucz API jest również nazywany identyfikatorem witryny. To krótka wartość alfanumeryczna, Ten klucz publiczny to unikatowy identyfikator Twojego konta Klaviyo i każde konto ma tylko jeden taki klucz. Możesz dodać swój publiczny klucz API do kodu strony internetowej. Nie daje on uprawnień do odczytu prywatnych danych konta.
Prywatne klucze API pozwalają aplikacjom odczytywać lub zmieniać dane na Twoim koncie Klaviyo, takie jak listy, zgodnie z uprawnieniami (zakresami), które wybierzesz. Prywatne klucze API należy traktować jak hasła: przechowuj je w bezpiecznym miejscu i nigdy nie ujawniaj ich publicznie. Konto Klaviyo może wygenerować dowolną liczbę prywatnych kluczy API.
Co zrobić w przypadku ujawnienia klucza API
Twój publiczny klucz API jest przeznaczony do użycia w kodzie publicznej witryny internetowej. Nie umożliwia komuś odczytu prywatnych danych konta, ale może być używany do przesyłania danych za pośrednictwem API po stronie klienta, takich jak zdarzenia i aktualizacje profilu.
Zachowaj prywatne klucze API w poufności. Ktoś, kto ma prywatny klucz, może używać jego uprawnień do wyświetlania lub edytowania danych klientów.
Jeśli prywatny klucz API zostanie ujawniony, usuń go natychmiast, a następnie utwórz nowy prywatny klucz API. Zaktualizuj każdą aplikację, która korzystała z ujawnionego klucza, aby używała nowego klucza. Nadawaj kluczowi zastępczemu tylko te uprawnienia, których potrzebuje aplikacja, i używaj innego prywatnego klucza API dla każdej aplikacji.
Znajdowanie kluczy API
Skopiuj lub pobierz prywatny klucz API w momencie jego tworzenia, zanim opuścisz stronę potwierdzenia. Nie możesz później ponownie wyświetlić pełnego klucza. Przechowuj go bezpiecznie, np. w sejfie lub menedżerze haseł, i udostępniaj go tylko zaufanym osobom. Jeśli nie zapisałeś klucza, utwórz nowy klucz lub sklonuj istniejący.
- W lewym dolnym rogu kliknij nazwę swojego konta.
- Kliknij przycisk Ustawienia.
- Wybierz kartę Klucze API .
- Wyświetl swój publiczny klucz API (identyfikator witryny).
- W sekcji Prywatne klucze API sprawdź nazwy kluczy i poziomy dostępu. Możesz zidentyfikować klucz po jego ostatnich 4 znakach, ale nie możesz tutaj wyświetlić ani skopiować całego klucza.
Jeśli klucza nie ma na karcie Aktywni, sprawdź Nieaktywni lub Wyłączone, jeśli te karty są widoczne.
Klonowanie prywatnych kluczy API
Gdy klonujesz istniejące prywatne klucze API, sklonowany klucz będzie:
- To zupełnie inny klucz niż klucz oryginalny.
- Użyj tej samej nazwy co oryginalna.
- Mają taki sam zakres uprawnień jak oryginał, z wyjątkiem przestarzałych zakresów, które nie są już obsługiwane.
Klonowanie pozostawia oryginalny klucz bez zmian. Skopiuj lub pobierz sklonowany klucz i przechowuj go w bezpiecznym miejscu. Aby użyć go w aplikacji, zaktualizuj ustawienia tej aplikacji, korzystając z nowego klucza. Usuń oryginalny klucz, gdy nie będzie już potrzebny.
Usuń prywatny klucz API
Usunięcia prywatnego klucza API nie można cofnąć. Żądania API, które z niego korzystają, przestaną działać. Jeśli zastępujesz klucz, który nie został ujawniony, zaktualizuj i przetestuj aplikacje, które z niego korzystają, zanim go usuniesz. Jeśli klucz jest ujawniony, usuń go natychmiast.
- Otwórz kartę klucze API, wykonując powyższe kroki. W sekcji Prywatne klucze API znajdź klucz, który chcesz usunąć.
- Otwórz menu z 3 kropkami obok klucza i wybierz Usuń.
- Kliknij Usuń w oknie dialogowym potwierdzenia.
Dodatkowe źródła
- Jak utworzyć lub sklonować prywatny klucz API
Dowiedz się, jak utworzyć prywatny klucz API, który jest unikalnym identyfikatorem używanym do wywołań API, a także jak zdefiniować zakres.
- Informacje o sposobie wymiany informacji między Klaviyo a aplikacjami
Dowiedz się, jak informacje synchronizują się między Klaviyo a aplikacjami innych firm za pośrednictwem interfejsu programowania aplikacji (API). Większość danych wymienianych za pośrednictwem integracji Klaviyo jest przesyłana jednokierunkowo: dane są pobierane do konta Klaviyo, aby można było wykorzystać szeroki zakres danych o klientach.
- Klaviyo's API reference guide