Laatst bijgewerkt: november 30, 2022
Met de HubSpot API-sleutel kunnen uw ontwikkelaars aangepaste toepassingen maken met de API's van HubSpot. 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 worden HubSpot API Keys afgeschaft en niet langer ondersteund. Voortgezet gebruik van HubSpot API Keys is een veiligheidsrisico voor uw account en gegevens. Tijdens deze afbouwfase kan HubSpot uw sleutel op elk moment deactiveren.
In plaats daarvan moet u zich verifiëren met behulp van een privé app toegangstoken of OAuth. Lees meer over deze wijziging en hoe u een API-sleutelintegratie kuntmigreren om in plaats daarvan een privé-app te gebruiken.
Toegang tot uw API-sleutel
Je moet Super Admin rechten hebben om toegang te krijgen tot de API-sleutel van je account.
- Klik in uw HubSpot-account op de instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API-sleutel.
- Als er nooit een sleutel is gegenereerd voor uw account, klikt u op Genereer API sleutel.
- Als u al een API-sleutel hebt gegenereerd, klikt u op Tonen om uw sleutel weer te geven.
- Als de sleutel wordt weergegeven, klikt u 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 toepassingen te gebruiken.
Draai je API-sleutel
Het verstrekken van je API-sleutel aan een ontwikkelaar geeft hen volledige toegang tot het aanbrengen van wijzigingen in je account via de API van HubSpot, inclusief het lezen van gelogde e-mails van gekoppelde e-mailaccounts en andere gegevens van derden.
Voor extra veiligheid kun je overwegen om je HubSpot API-sleutel elke zes maanden te roteren. Door uw HubSpot API-sleutel te roteren, wordt de bestaande API-sleutel gedeactiveerd en een nieuwe gegenereerd. HubSpot toont de leeftijd van de API-sleutel en adviseert wanneer u uw API-sleutel moet roteren.
Er worden elke 180 dagen e-mailmeldingen gestuurd naar superbeheerders en gebruikers die de API-sleutel voor het laatst hebben aangemaakt of geroteerd als de API-sleutel in dat tijdsbestek niet is geroteerd.
Hoewel dit downtime kan creëren en moeite kost, 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:
- Klik in uw HubSpot-account op het instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API-sleutel.
- Klik op het vervolgkeuzemenu Acties en selecteer vervolgens Sleutel roteren.
- Klik op Deze sleutel nu roteren en verlopen. Schakel het selectievakje reCAPTCHA in. Uw bestaande sleutel wordt gedeactiveerd en er wordt een nieuwe API-sleutel aangemaakt.
- Klik op Kopiëren en vervang de gedeactiveerde API-sleutel die door uw applicaties wordt gebruikt door deze nieuwe API-sleutel.
API-aanroepen met 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 gedraaid.
Let op: Verbonden apps die zijn geïnstalleerd via de App Marketplace worden niet beïnvloed wanneer u uw API-sleutel draait.
Uw API-sleutel deactiveren
Het deactiveren van uw API-sleutel maakt geen nieuwe sleutel aan. API-aanroepen die de gedeactiveerde HubSpot API-sleutel gebruiken, zullen mislukken en elke applicatie die de sleutel gebruikt, zal niet langer toegang hebben tot uw gegevens.
Om uw API-sleutel te deactiveren:- Klik in uw HubSpot-account op de instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API-sleutel.
- Klik op het vervolgkeuzemenu Acties .
- Klik op Sleutel deactiveren en klik op Deze sleutel nu deactiveren. Schakel het selectievakje reCAPTCHA in.
Bekijk uw API audit log
U kunt een gedateerd logboek bekijken van gebruikers die de API-sleutel van uw account hebben bekeken, aangemaakt of gedeactiveerd in de sectie Audit log.
- Klik in uw HubSpot-account op de instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API sleutel.
- Klik op het tabblad Audit log.
Bekijk uw API-sleutel oproeplogboek
Om u te helpen bij het debuggen van een van uw integraties of om ervoor te zorgen dat u voldoet aan HubSpot's API gebruiksrichtlijnen, kun je een logboek van je API-sleuteloproepen van de afgelopen 7 dagen bekijken.
- Klik in uw HubSpot-account op de instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API-sleutel.
- Bekijk op het tabblad Call log alle activiteit van de afgelopen 7 dagen.
