Laatst bijgewerkt: juni 23, 2022
Met de HubSpot API-sleutel kunnen uw ontwikkelaars aangepaste toepassingen maken met HubSpot's API
's. Elke sleutel is specifiek voor een HubSpot account, niet voor een individuele gebruiker, en er is slechts één sleutel per keer toegestaan.Let op:vanaf 30 november 2022 kunnen HubSpot API-sleutels niet langer worden gebruikt als authenticatiemethode voor toegang tot HubSpot API's. Bovendien, vanaf 15 juli 2022, zullen accounts zonder een reeds gegenereerde HubSpot API sleutel niet langer in staat zijn om er een aan te maken.
In plaats daarvan zult u een privé app-toegangstoken of OAuth moeten gebruiken om API-oproepen te verifiëren. Lees meer overdeze wijzigingen hoe ueen API-sleutelintegratiekuntmigrerenom in plaats daarvan een privé-app te gebruiken.
Toegang tot uw API sleutel
U moet Super Admin-rechten
hebben om toegang te krijgen tot de API-sleutel van uw account.- { local.navSettings }}
- Navigeer in het menu aan de linkerzijde naar Integraties > API-sleutel.
- Als er nooit een sleutel is gegenereerd voor uw account, klikt u op API-sleutel genereren sleutel.
- Als u al een API sleutel heeft gegenereerd, klik op Tonen om uw sleutel te tonen.
- Met de sleutel weergegeven, klik op Kopiëren om de sleutel te kopiëren. U kunt de sleutel vervolgens plakken om deze aan uw ontwikkelaars te verstrekken of in uw applicaties te gebruiken.
Uw API sleutel roteren
Het verstrekken van uw API-sleutel aan een ontwikkelaar geeft hen volledige toegang om wijzigingen aan te brengen in uw account via HubSpot's API, inclusief het lezen van gelogde e-mails van gekoppelde e-mailaccounts en andere gegevens van derden.
Overweeg voor extra veiligheid om uw HubSpot API-sleutel elke zes maanden te roteren. Het roteren van uw HubSpot API-sleutel zal de bestaande API-sleutel deactiveren en een nieuwe genereren. HubSpot zal de leeftijd van de API-sleutel weergeven en aanbevelen wanneer u uw API-sleutel moet roteren.
Elke 180 dagen worden er e-mailmeldingen verzonden naar superbeheerders en gebruikers die de API-sleutel het laatst hebben aangemaakt of geroteerd als de API-sleutel in dat tijdsbestek niet is geroteerd.
Hoewel dit downtime kan veroorzaken en inspanning vergt, voegt het een beveiligingslaag toe door te voorkomen dat kwaadwillende applicaties toegang krijgen tot uw HubSpot informatie met uw bestaande API sleutel.
Om uw HubSpot API sleutel te roteren:
- In uw HubSpot account, klik op het instellingen icoon in de hoofd navigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API sleutel.
- Klik op het vervolgkeuzemenu Acties en selecteer vervolgens Sleutel roteren.
- Klik op Rotate and expire this key now. Vink het vakje reCAPTCHA aan. Uw bestaande sleutel zal worden gedeactiveerd en een nieuwe API sleutel zal worden aangemaakt.
- Klik op Kopiëren en vervang de gedeactiveerde API sleutel die door uw applicaties wordt gebruikt door deze nieuwe API sleutel.
API-calls die gebruikmaken van de gedeactiveerde HubSpot API-sleutel zullen nu mislukken en elke applicatie die de sleutel gebruikt zal niet langer toegang hebben tot uw informatie.
Het roteren van uw API-sleutel heeft geen invloed op uw verbinding met de Salesforce-integratie
. Als u echter een aangepaste integratie hebt geïnstalleerd, moet u uw API-sleutel bijwerken nadat u deze hebt geroteerd.Let op: Verbonden apps die via de App Marketplace
zijn geïnstalleerd, worden niet beïnvloed wanneer u uw API-sleutel roteert.Deactiveer uw API sleutel
Als u uw API sleutel deactiveert, wordt
er geen nieuwe sleutel aangemaakt. API-oproepen die gebruikmaken van de gedeactiveerde HubSpot API-sleutel zullen mislukken en elke applicatie die gebruikmaakt van de sleutel zal niet langer toegang hebben tot uw informatie. Om uw API sleutel te deactiveren:- { local.navSettings }}
- In het linker zijbalk menu, navigeer naarIntegraties>API sleutel.
- Klik op hetActionsdropdown menu.
- Klik opDeactiveer sleutel en klik opDeactiveer deze sleutel nu. Vink de reCAPTCHA checkbox aan.
Bekijk uw API audit log
U kunt een gedateerde log bekijken van gebruikers die de API sleutel van uw account hebben bekeken, aangemaakt, of gedeactiveerd in de Audit log sectie.
- { local.navSettings }}
- In het linker zijbalk menu, navigeer naar Integraties > API sleutel.
- Klik op het tabblad Audit log.
Bekijk uw API key call log
Om u te helpen bij het debuggen van een van uw integraties of om ervoor te zorgen dat u voldoet aan HubSpot's API gebruiksrichtlijnenkunt u een log bekijken van uw API key calls van de afgelopen 7 dagen.
- { local.navSettings }}
- Navigeer in het menu aan de linkerzijde naar Integrations > API key.
- Bekijk in het tabblad Oproeplog alle activiteit van de afgelopen 7 dagen.
