- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf das Zahnradsymbol.
- Gehen Sie in der linken Seitenleiste zu Integrationen > Private Apps.
- Klicken Sie auf Private App erstellen.
- Konfigurieren Sie auf der Registerkarte Grundlegende Informationen die Details Ihrer App:
- Geben Sie den Namen Ihrer App ein.
- Bewegen Sie den Mauszeiger über das Platzhalterlogo und klicken Sie auf das Symbol zum Hochladen, um ein quadratisches Bild hochzuladen, das als Logo für Ihre App dienen soll.
- Geben Sie eine Beschreibung für Ihre App ein.
- Klicken Sie auf die Registerkarte Bereiche.
- Aktivieren Sie das Kontrollkästchen Lesen oder Schreiben für jeden Bereich, auf den Ihre private App zugreifen können soll. Sie können auch über die Suchleiste Bereich suchen nach einem bestimmten Bereich suchen.
- Ist Ihre App fertig konfiguriert, klicken Sie oben rechts auf App erstellen.
- Überprüfen Sie im Dialogfeld die Informationen zum Zugriffstoken Ihrer App und klicken Sie dann auf Mit dem Erstellen fortfahren.
Sobald Ihre App erstellt ist, können Sie mithilfe des Zugriffstokens der App API-Aufrufe durchführen. Wenn Sie die Informationen zu Ihrer App bearbeiten oder ihre Bereiche ändern müssen, klicken Sie auf Details bearbeiten.
Um API-Aufrufe durchzuführen, gehen Sie zur Detailseite Ihrer App.
- Klicken Sie auf der Zugriffstoken-Karte auf Token anzeigen, um Ihr Zugriffstoken offenzulegen. Klicken Sie auf Kopieren, um das Token in Ihre Zwischenablage zu kopieren.
- Sie können dann das Zugriffstoken einfügen, um es Ihren Entwicklern zur Verfügung zu stellen, oder es selbst bei der Entwicklung Ihrer App verwenden. Legen Sie beim Aufrufen eines HubSpot-API-Endpunkts den Wert des Feldes Autorisierung auf Bearer [YOUR_TOKEN]. Wenn Sie zum Beispiel die Kontakte-API mit Node.js und axios aufrufen, würde die Anfrage wie folgt aussehen:
Wenn Ihr Zugriffstoken verloren gegangen ist oder anderweitig kompromittiert wurde, können Sie das Token rotieren. Es wird ein neues Zugriffstoken erstellt und das ursprüngliche Zugriffstoken verfällt.
- Klicken Sie in Ihrem HubSpot-Account in der Hauptnavigationsleiste auf die Seite mit den Einstellungen.
- Gehen Sie zu Integrationen > Private Apps.
- Klicken Sie auf den Namen Ihrer privaten App.
- Klicken Sie neben Ihrem Zugriffstoken auf Rotieren:
- Wenn Ihr Token kompromittiert wurde und Sie den Zugriff sofort widerrufen möchten, klicken Sie auf Rotieren und jetzt verfallen lassen.
- Auch wenn keine unmittelbare Bedrohung für Ihr Token besteht, wird empfohlen, es alle sechs Monate zu rotieren. Wenn Sie bereit sind, ein regelmäßiges Rotieren Ihres Tokens zu initiieren, klicken Sie auf Rotieren und später verfallen lassen, wodurch das Token in 7 Tagen abläuft.
- Wenn Ihre App schon früher umgestellt werden kann, klicken Sie auf Jetzt verfallen lassen.
- Wenn Sie entscheiden, dass Sie mehr Zeit benötigen, können Sie auf Rotieren abbrechen klicken, wodurch das Verfallen des ursprünglichen Tokens aufgehoben wird und das neue Zugriffstoken widerrufen wird.
So überprüfen Sie die API-Aufrufe, die Ihre App in den letzten 30 Tagen durchgeführt hat:
- Klicken Sie auf der Detailseite Ihrer App auf die Registerkarte Protokolle.
- Überprüfen und filtern Sie die API-Aufrufe Ihrer privaten App:
- Klicken Sie auf die Dropdown-Menüs Methode und Antwort, um Ihre historischen API-Aufrufe nach Anfragemethode oder Antwortcode zu filtern.
- Klicken Sie auf das Dropdown-Menü für das Startdatum oder das Enddatum, um Ihre Aufrufprotokolle auf einen bestimmten Zeitraum einzugrenzen.
- Sie können auch über das Suchfeld Suche nach Anfrage-URL nach bestimmten Aufrufen suchen.
- Um die API-Aufrufprotokolle zu exportieren, klicken Sie auf Protokolle exportieren (CSV). Geben Sie dann einen Datumsbereich (bis zu den letzten 30 Tagen) an und klicken Sie auf Exportieren.
- Wählen Sie im Pop-up-Feld den Datumsbereich der API-Aufrufe aus, die Sie exportieren möchten, und klicken Sie auf Exportieren. Sie erhalten eine E-Mail mit einem Download-Link, sobald der Export zum Download bereitsteht.