Senast uppdaterad: juni 28, 2023
Tillgänglig med något av följande abonnemang, om inte annat anges:
Alla produkter och planer
|
Med HubSpot API-nyckeln kan dina utvecklare skapa anpassade applikationer med HubSpot API:er. Varje nyckel är specifik för ett HubSpot-konto, inte för en enskild användare, och endast en nyckel tillåts åt gången.
Observera: Från och med den30 november 2022 är HubSpot API-nycklar överspelade och stöds inte längre. Istället måste du autentisera dig med en privat appåtkomsttoken eller OAuth. Läs mer omden här ändringen och hur dumigrerar en API-nyckelintegration för att istället använda en privat app.
Om du ser en banner i ditt konto om att avaktivera din API-nyckel:
- Se till att du har migrerat alla berörda integrationer ochavaktivera sedan API-nyckeln.
- Om du vill kontrollera om kontots API-nyckel har använts under de senaste sju dagarna kan duvisa din loggningshistorik för API-nyckelanrop. Samtalsloggen kommer inte att visa några förfrågningar som gjorts med nyckeln för mer än sju dagar sedan.
- Appar som anges påsidanAnslutna appari dina kontoinställningar behöver inte migreras, eftersom de autentiseras med OAuth.
- API-nycklar för utvecklare är skilda från standard-API-nycklar för HubSpot, och de är inte överspelade. API-nycklar för utvecklare används för att hantera inställningar som är relaterade till dina HubSpot-appar, inklusiveAPI-prenumerationer för webhooks ochAPI-händelsetyper för tidslinjehändelser.
Få tillgång till din API-nyckel
Du måste ha behörigheter som Superadministratör för att få tillgång till ditt kontos API-nyckel.
- I ditt HubSpot-konto klickar du på inställningsikonen i det övre navigeringsfältet.}
- Navigera till Integrationer > API-nyckel i menyn i vänster sidofält.
- Om en nyckel aldrig har genererats för ditt konto klickar du på Generera API-nyckel . nyckel.
- Om du redan har genererat en API-nyckel klickar du på Visa för att visa nyckeln.
- När nyckeln visas klickar du på Kopiera för att kopiera nyckeln. Du kan sedan klistra in nyckeln för att ge den till dina utvecklare eller använda den i dina program.
Rotera din API-nyckel
Om du ger din API-nyckel till en utvecklare får de full tillgång till att göra ändringar i ditt konto via HubSpot API, inklusive läsning av loggade e-postmeddelanden från anslutna e-postkonton och andra data från tredje part.
För ökad säkerhet bör du överväga att rotera din HubSpot API-nyckel var sjätte månad. Genom att rotera din HubSpot API-nyckel avaktiveras den befintliga API-nyckeln och en ny genereras. HubSpot visar API-nyckelns ålder och rekommenderar när du bör rotera din API-nyckel.
E-postmeddelanden skickas var 180:e dag till superadministratörer och användare som senast skapade eller roterade API-nyckeln om API-nyckeln inte har roterats under den tidsramen.
Även om detta kan skapa driftstopp och kräva ansträngning, lägger det till ett säkerhetslager genom att förhindra att skadliga program får tillgång till din HubSpot-information med din befintliga API-nyckel.
Så här roterar du din HubSpot API-nyckel:
- I ditt HubSpot-konto klickar du på ikonen för inställningar i huvudnavigationsfältet.
- Navigera till Integrationer > API-nyckel i den vänstra sidofältets meny.
- Klicka på rullgardinsmenyn Åtgärder och välj sedan Rotera nyckel.
- Klicka på Rotera och låt den här nyckeln upphöra att gälla nu. Markera kryssrutan reCAPTCHA. Din befintliga nyckel inaktiveras och en ny API-nyckel skapas.
- Klicka på Kopiera och ersätt den inaktiverade API-nyckeln som används av dina program med den nya API-nyckeln.
API-samtal som använder den inaktiverade HubSpot API-nyckeln kommer nu att misslyckas och alla program som använder nyckeln kommer inte längre att kunna få tillgång till din information.
Om du roterar din API-nyckel påverkar inte din anslutning till Salesforce-integrationen. Men om du har en anpassad integration installerad måste du uppdatera din API-nyckel efter att du har roterat den.
Observera: Anslutna appar som installerats via App Marketplace påverkas inte när du roterar din API-nyckel.
Inaktivera din API-nyckel
Om du inaktiverar din API-nyckel skapas ingen ny nyckel. API-samtal som använder den inaktiverade HubSpot API-nyckeln kommer att misslyckas och alla program som använder nyckeln kommer inte längre att kunna få tillgång till din information.
Så här avaktiverar du din API-nyckel:- I ditt HubSpot-konto klickar du på inställningsikonen i det övre navigeringsfältet.}
- Navigera till Integrations > API-nyckel i menyn i vänster sidofält.
- Klicka på rullgardinsmenyn Åtgärder .
- Klicka på Inaktivera nyckel och klicka på Inaktivera den här nyckeln nu. Markera kryssrutan reCAPTCHA.
Visa din API-granskningslogg
Du kan visa en daterad logg över användare som har tittat på, skapat eller inaktiverat ditt kontos API-nyckel i avsnittet Granskningslogg.
- I ditt HubSpot-konto klickar du på inställningsikonen i det övre navigeringsfältet.}
- I menyn i den vänstra sidofältet navigerar du till Integrationer > API-nyckel.
- Klicka på fliken Granskningslogg.
Visa loggen över dina API-nyckelanrop
För att hjälpa dig att felsöka en av dina integrationer eller för att se till att du följer HubSpot:s riktlinjer för användning av API kan du visa en logg över dina API-nyckelsamtal för de senaste sju dagarna.
- I ditt HubSpot-konto klickar du på inställningsikonen i det övre navigeringsfältet.}
- Navigera till Integrationer > API-nyckel i menyn i den vänstra sidofältet.
- På fliken Samtalslogg visar du all aktivitet för de senaste 7 dagarna.
