Zuletzt aktualisiert am: März 8, 2023
Mit einem der folgenden Abonnements verfügbar (außer in den angegebenen Fällen):
Alle
|
Mit dem HubSpot-API-Schlüssel können Ihre Entwickler benutzerdefinierte Anwendungen mit HubSpot-APIs erstellen. Jeder Schlüssel ist spezifisch für einen HubSpot-Account und nicht für einen Benutzer. Es ist immer nur ein Schlüssel zulässig.
Bitte beachten: seit dem 30. November 2022 sind HubSpot-API-Schlüssel veraltet und werden nicht mehr unterstützt. Stattdessen müssen Sie mithilfe des Zugriffstokens einer privaten App oder OAuth authentifizieren. Erfahren Sie mehr über diese Änderung und wie Sie eine API-Schlüssel-Integration migrieren, um stattdessen eine private App zu verwenden.
Wenn Sie in Ihrem Account ein Banner zur Deaktivierung Ihres API-Schlüssels sehen:
- Stellen Sie sicher, dass Sie alle betroffenen Integrationen migriert haben, und deaktivieren Sie dann den API-Schlüssel.
- Um zu überprüfen, ob der API-Schlüssel des Accounts in den letzten sieben Tagen verwendet wurde, können Sie den Verlauf des Aufrufprotokolls für Ihren API-Schlüssel anzeigen. Im Aufrufprotokoll werden keine mit dem Schlüssel durchgeführten Anfragen angezeigt, die älter als sieben Tagen sind.
- Apps, die auf der Seite „Verknüpfte Apps“ Ihrer Account-Einstellungen aufgeführt sind, müssen nicht migriert werden, da sie sich mit OAuth authentifizieren.
- Die API-Schlüssel für Entwickler sind von den Standard-API-Schlüsseln von HubSpot getrennt und werden nicht eingestellt. Entwickler-API-Schlüssel werden für die Verwaltung von Einstellungen im Zusammenhang mit Ihren HubSpot-Apps verwendet, einschließlich Webhooks-API-Abonnements- und Chronik-Events-API-Event-Typen.
API-Schlüssel aufrufen
Sie benötigen Super-Admin-Berechtigungen, um auf die API-Schlüssel Ihres Accounts zuzugreifen.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Wenn noch nie ein Schlüssel für Ihren Account generiert wurde, klicken Sie auf „API-Schlüssel generieren“.
- Wenn Sie bereits einen API-Schlüssel generiert haben, klicken Sie auf „Anzeigen“, um Ihren Schlüssel anzuzeigen.
- Klicken Sie bei angezeigtem Schlüssel auf „Kopieren“, um ihn zu kopieren. Sie können den Schlüssel dann einfügen, um ihn Ihren Entwicklern bereitzustellen oder in Ihren Anwendungen zu nutzen.
API-Schlüssel rotieren
Stellen Sie Ihren API-Schlüssel einem Entwickler bereit, kann dieser umfangreiche Änderungen an Ihrem Account über die API von HubSpot vornehmen und beispielsweise protokollierte E-Mails von verknüpften E-Mail-Konten und andere Drittanbieter-Daten lesen.
Um mehr Sicherheit zu gewährleisten, sollten Sie Ihren HubSpot-API-Schlüssel alle sechs Monate rotieren. Das Rotieren Ihres HubSpot-API-Schlüssels bewirkt, dass der vorhandene API-Schlüssel deaktiviert und ein neuer generiert wird. HubSpot zeigt das Alter der API-Schlüssel an und empfiehlt einen Zeitpunkt für das Rotieren Ihres HubSpot-API-Schlüssels.
Alle 180 Tage werden E-Mail-Benachrichtigungen an Super-Admins und Benutzer gesendet, die den API-Schlüssel zuletzt erstellt oder rotiert haben, sofern der API-Schlüssel in diesem Zeitraum nicht rotiert wurde.
Dies kann zwar zu einer Unterbrechung des Betriebs führen und Arbeit verursachen, aber es bietet auch zusätzliche Sicherheit, indem Sie schädliche Anwendungen daran hindern, Ihre HubSpot-Informationen mit Ihrem vorhandenen API-Schlüssel aufzurufen.
So rotieren Sie Ihren HubSpot-API-Schlüssel:
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf das Dropdown-Menü „Aktionen“ und wählen Sie „Schlüssel rotieren“ aus.
- Klicken Sie auf „Diesen Schlüssel jetzt rotieren und verfallen lassen“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen. Ihr bestehender Schlüssel wird deaktiviert und ein neuer API-Schlüssel wird erstellt.
- Klicken Sie auf „Kopieren“ und ersetzen Sie den deaktivierten API-Schlüssel, den Ihre Anwendungen verwendet haben, mit diesem neuen API-Schlüssel.
API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen jetzt fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen.
Das Rotieren Ihres API-Schlüssels hat keinen Einfluss auf Ihre Verknüpfung mit der Salesforce-Integration. Wenn Sie jedoch eine benutzerdefinierte Integration installiert haben, müssen Sie Ihren API-Schlüssel nach dem Rotieren aktualisieren.
Bitte beachten: Verknüpfte Apps, die über den App Marketplace installiert wurden, sind nicht betroffen, wenn Sie Ihren API-Schlüssel rotieren.
API-Schlüssel deaktivieren
Beim Deaktivieren Ihres API-Schlüssels wird kein neuer Schlüssel erstellt. API-Aufrufe mit dem deaktivierten HubSpot-API-Schlüssel schlagen fehl und alle Anwendungen, die den Schlüssel verwenden, können nicht mehr auf Ihre Informationen zugreifen.
So deaktivieren Sie Ihre API-Schlüssel:- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf das Dropdown-Menü „Aktionen“.
- Klicken Sie auf „Schlüssel deaktivieren“ und dann auf „Diesen Schlüssel jetzt deaktivieren“. Aktivieren Sie das reCAPTCHA-Kontrollkästchen.
API-Protokoll anzeigen
Sie können im Bereich „Protokoll“ anzeigen, welcher Benutzer zu welchem Zeitpunkt den API-Schlüssel des Accounts aufgerufen, erstellt oder deaktiviert hat.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Klicken Sie auf die Registerkarte „Protokoll“.
Aufrufprotokoll für Ihren API-Schlüssel anzeigen
Um das Debugging einer Ihrer Integrationen zu erleichtern oder die Einhaltung der API-Nutzungsrichtlinien von HubSpot zu gewährleisten, können Sie ein Protokoll der Aufrufe Ihres API-Schlüssels für die vorherigen 7 Tage anzeigen.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol, um die Einstellungen aufzurufen.
- Gehen Sie in der linken Seitenleiste zu „Integrationen“ > „API-Schlüssel“.
- Zeigen Sie auf der Registerkarte „API-Aufrufe“ alle Aktivitäten der letzten 7 Tage an.
