Laatst bijgewerkt: februari 27, 2023
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 niet meer ondersteund. In plaats daarvan moet je je authenticeren met behulp van een privé app toegangstoken of OAuth. Lees meer overdeze verandering en hoe jeeen API-sleutel integratie kunt migreren om in plaats daarvan een privé app te gebruiken.
Als u een banner in uw account ziet over het deactiveren van uw API-sleutel:
- Zorg ervoor dat u alle getroffen integraties hebt gemigreerd endeactiveer vervolgensde API-sleutel.
- Om te controleren of de API-sleutel van uw account in de afgelopen zeven dagen is gebruikt, kunt ude oproeploggeschiedenis van uw API-sleutel bekijken. Het gesprekslogboek zal geen verzoeken tonen die meer dan zeven dagen geleden met de sleutel zijn gedaan.
- Apps die op depaginaAangesloten appsvan uw accountinstellingen staan, hoeven niet te worden gemigreerd, omdat zij authenticeren met OAuth.
- Developer API keys staan los van standaard HubSpot API keys, en worden niet afgeschreven. Developer API keys worden gebruikt voor het beheren van instellingen met betrekking tot uw HubSpot apps, waaronderwebhooks API subscriptions entimeline events API event types.
Toegang tot uw API sleutel
U moet Super Admin rechten hebben om toegang te krijgen tot de API-sleutel van uw 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, klik dan 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.
Uw API-sleutel draaien
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 toepassingen wordt gebruikt door deze nieuwe API-sleutel.
API-aanroepen 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 draaien 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 met de gedeactiveerde HubSpot API-sleutel 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, gemaakt of gedeactiveerd in het gedeelte Auditlogboek.
- Klik in uw HubSpot-account op de instellingenpictogram in de hoofdnavigatiebalk.
- Navigeer in het linker zijbalkmenu naar Integraties > API sleutel.
- Klik op het tabblad Auditlog.
Bekijk uw API-sleutel oproeplogboek
Om je te helpen bij het debuggen van een van je integraties of om ervoor te zorgen dat je voldoet aan de HubSpot API gebruiksrichtlijnen, kun je een logboek bekijken van je API key calls van de afgelopen 7 dagen.
- 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.
