Data ostatniej aktualizacji: czerwca 23, 2022
Dzięki kluczowi API HubSpot programiści mogą tworzyć niestandardowe aplikacje za pomocą interfejsów API HubSpot
. Każdy klucz jest przypisany do konta HubSpot, a nie do pojedynczego użytkownika, i tylko jeden klucz może być używany jednocześnie.Uwaga:od 30 listopada 2022 r. klucze API HubSpot nie będą mogły być używane jako metoda uwierzytelniania w celu uzyskania dostępu do interfejsów API HubSpot. Ponadto od 15 lipca 2022 r. konta, które nie mają już wygenerowanego klucza API HubSpot, nie będą mogły go utworzyć.
Zamiast tego trzeba będzie użyć prywatnego tokena dostępu do aplikacji lub OAuth do uwierzytelniania wywołań API. Dowiedz się więcej otej zmianiei o tym,jakzmigrować integracjęzkluczem API, aby zamiast niego używać aplikacji prywatnej.
Dostęp do swojego klucza API
Aby uzyskać dostęp do klucza API swojego konta, musisz mieć uprawnienia Super Administratora
.- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do pozycji Integracje > Klucz API.
- Jeśli klucz nigdy nie został wygenerowany dla Twojego konta, kliknij Generate API klucz.
- Jeśli klucz API został już wygenerowany, kliknij Pokaż, aby wyświetlić 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.
Zmieniaj swój klucz API
Udostępnienie klucza API programiście daje mu pełny dostęp do wprowadzania zmian na koncie użytkownika za pośrednictwem interfejsu API HubSpot, w tym do odczytywania zarejestrowanych wiadomości e-mail z połączonych kont e-mail i innych danych innych firm.
W celu zwiększenia bezpieczeństwa warto co sześć miesięcy wymieniać klucz API HubSpot. Rotacja klucza API HubSpot spowoduje dezaktywację istniejącego klucza API i wygenerowanie nowego. HubSpot wyświetli informacje o wieku klucza API i zaleci, kiedy należy go zmienić.
Powiadomienia e-mail są wysyłane co 180 dni do superadministratorów i użytkowników, którzy ostatnio utworzyli lub zmienili klucz API, jeśli klucz API nie został zmieniony w tym czasie.
Chociaż może to powodować przestoje i wymagać wysiłku, stanowi dodatkową warstwę bezpieczeństwa, uniemożliwiając złośliwym aplikacjom uzyskanie dostępu do informacji HubSpot za pomocą istniejącego klucza API.
Aby zmienić swój klucz API HubSpot:
- Na swoim koncie HubSpot kliknij ikonę ustawień na głównym pasku nawigacyjnym.
- W menu lewego paska bocznego przejdź do pozycji Integracje > Klucz API.
- Kliknij menu rozwijane Akcje, a następnie wybierz opcję Obróć klucz.
- Kliknij przycisk Obróć i wygasić ten klucz teraz. Zaznacz pole wyboru reCAPTCHA. Twój istniejący klucz zostanie dezaktywowany i zostanie utworzony nowy klucz API.
- Kliknij przycisk Kopiuj i zastąp nieaktywny klucz API używany przez Twoje aplikacje nowym kluczem API.
Wywołania API z użyciem nieaktywnego klucza API HubSpot będą teraz kończyły się niepowodzeniem, a żadna aplikacja korzystająca z tego klucza nie będzie już mogła uzyskać dostępu do informacji użytkownika.
Zmiana klucza API nie będzie miała wpływu na połączenie z integracją Salesforce
. Jeśli jednak masz zainstalowaną niestandardową integrację, po jej zmianie będziesz musiał zaktualizować swój klucz API.Uwaga: zmiana klucza API nie będzie miała wpływu na połączone aplikacje zainstalowane za pośrednictwem App Marketplace
.Dezaktywacja klucza API
Dezaktywacja klucza API nie
spowoduje utworzenia nowego klucza. Wywołania interfejsu API przy użyciu dezaktywowanego klucza API HubSpot nie powiodą się, a żadna 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 pozycjiIntegracje>Klucz API.
- Kliknij menu rozwijaneAkcje.
- Kliknij opcjęDezaktywuj klucz i kliknij przyciskDezaktywuj ten klucz teraz. Zaznacz pole wyboru reCAPTCHA.
Wyświetlanie dziennika kontroli 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 kartę Dziennik audytu.
Wyświetl dziennik wywołań klucza API
Aby ułatwić sobie rozwiązywanie problemów z integracją lub upewnić się, że postępujesz zgodnie z zasadami Wytyczne HubSpot dotyczące korzystania z interfejsu APImożna wyświetlić rejestr połączeń z kluczem API z ostatnich 7 dni.
- W koncie HubSpot kliknij ikonę ustawień w głównym panelu nawigacyjnym.
- W menu lewego paska bocznego przejdź do pozycji Integracje > Klucz API.
- W zakładce Rejestr połączeń wyświetl wszystkie działania z ostatnich 7 dni.
