Data ostatniej aktualizacji: stycznia 20, 2023
Dzięki kluczowi API HubSpot Twoi programiści mogą tworzyć niestandardowe aplikacje za pomocą interfejsów API HubSpot. Każdy klucz jest specyficzny dla konta HubSpot, a nie dla pojedynczego użytkownika, i tylko jeden klucz jest dozwolony w danym czasie.
Uwaga: od 30 listopada 2022 r. klucze API HubSpot są wycofywane i nie są już obsługiwane. Dalsze korzystanie z kluczy API HubSpot stanowi zagrożenie dla bezpieczeństwa konta i danych użytkownika. Podczas tej fazy deprecjacji firma HubSpot może w każdej chwili dezaktywować klucz użytkownika.
Zamiast tego należy uwierzytelnić się za pomocą prywatnego tokena dostępu do aplikacji lub OAuth. Dowiedz się więcej o tej zmianie i jak zmigrować integrację zkluczem API, aby zamiast tego użyć prywatnej aplikacji.
Dostęp do klucza API
Aby uzyskać dostęp do klucza API swojego konta, musisz mieć uprawnienia Super Admin.
- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do Integrations > API key.
- Jeśli klucz nigdy nie został wygenerowany dla Twojego konta, kliknij Generate API klucz.
- Jeśli już wygenerowałeś klucz API, kliknij Pokaż, aby wyświetlić swój klucz.
- Po wyświetleniu klucza kliknij przycisk Kopiuj, aby go skopiować. Następnie możesz wkleić klucz, aby przekazać go swoim programistom lub użyć go w swoich aplikacjach.
Zmień swój klucz API
Udostępnienie klucza API programiście da mu pełny dostęp do wprowadzania zmian na Twoim koncie za pośrednictwem interfejsu API HubSpot, w tym odczytywania zalogowanych wiadomości e-mail z podłączonych kont e-mail i innych danych stron trzecich.
W celu zwiększenia bezpieczeństwa warto rozważyć zmianę klucza API firmy HubSpot co sześć miesięcy. Rotacja klucza API HubSpot spowoduje dezaktywację istniejącego klucza API i wygenerowanie nowego. HubSpot wyświetli wiek klucza API i zaleci, kiedy należy go zmienić.
Powiadomienia e-mail są wysyłane co 180 dni do super administratorów i użytkowników, którzy ostatnio utworzyli lub obrócili klucz API, jeśli klucz API nie został obrócony w tym czasie.
Chociaż może to spowodować przestoje i wymagać wysiłku, dodaje warstwę bezpieczeństwa, uniemożliwiając złośliwym aplikacjom dostęp do informacji HubSpot za pomocą istniejącego klucza API.
Aby obrócić klucz API HubSpot:
- Na swoim koncie HubSpot kliknij ikonę ustawień na głównym pasku nawigacyjnym.
- W menu lewego paska bocznego przejdź do Integrations > API key.
- Kliknij menu rozwijane Akcje, a następnie wybierz opcję Obróć klucz.
- Kliknij Rotate i wygasić ten klucz teraz. Zaznacz pole wyboru reCAPTCHA. Twój istniejący klucz zostanie dezaktywowany i zostanie utworzony nowy klucz API.
- Kliknij Kopiuj i zastąp nieaktywny klucz API używany przez Twoje aplikacje tym nowym kluczem API.
Wywołania API przy użyciu nieaktywnego klucza API HubSpot będą teraz kończyły się niepowodzeniem, a każda aplikacja korzystająca z tego klucza nie będzie już mogła uzyskać dostępu do informacji użytkownika.
Obrócenie klucza API nie będzie miało wpływu na połączenie z integracją Salesforce. Jeśli jednak masz zainstalowaną niestandardową integrację, będziesz musiał zaktualizować klucz API po jego rotacji.
Uwaga: Podłączone aplikacje zainstalowane za pośrednictwem App Marketplace nie będą miały wpływu na rotację klucza API.
Dezaktywuj swój klucz API
Dezaktywacja Twojego klucza API nie spowoduje utworzenia nowego klucza. Wywołania API przy użyciu nieaktywnego klucza API HubSpot zakończą się niepowodzeniem, a każda aplikacja korzystająca z tego klucza nie będzie mogła uzyskać dostępu do informacji o użytkowniku.
Aby dezaktywować swój klucz API:- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do Integracje > Klucz API.
- Kliknij menu rozwijane Akcje .
- Kliknij Dezaktywuj klucz i kliknij Dezaktywuj ten klucz teraz. Zaznacz pole wyboru reCAPTCHA.
Zobacz dziennik audytu API
Możesz wyświetlić datowany dziennik użytkowników, którzy przeglądali, tworzyli lub dezaktywowali klucz API twojego konta w sekcji Dziennik audytu.
- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do Integrations > Klucz API.
- Kliknij zakładkę Dziennik audytu.
Wyświetl dziennik wywołań klucza API
Aby pomóc w usuwaniu błędów w jednej z integracji lub upewnić się, że przestrzegasz zasad Wskazówki dotyczące korzystania z interfejsu API firmy HubSpotmożna wyświetlić dziennik połączeń klucza API z ostatnich 7 dni.
- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do Integracje > Klucz API.
- W zakładce Dziennik połączeń przejrzyj całą aktywność z ostatnich 7 dni.
