Få tilgang til HubSpot API-nøkkelen din
Sist oppdatert: juni 28, 2023
Gjelder for:
Alle produkter og planer |
Med HubSpot API-nøkkelen kan utviklerne dine lage tilpassede applikasjoner med HubSpots API-er. Hver nøkkel er spesifikk for en HubSpot-konto, ikke en individuell bruker, og bare én nøkkel er tillatt om gangen.
Væroppmerksom på at HubSpot API-nøkler ikke lenger støttes fra og med 30. november 2022. I stedet må du autentisere deg ved hjelp av et privat apptilgangstoken eller OAuth. Finn ut mer om denne endringen og hvordan du migrerer en API-nøkkelintegrasjon til å bruke en privat app i stedet.
Hvis du ser et banner i kontoen din om deaktivering av API-nøkkelen:
- Kontroller at du har migrert alle berørte integrasjoner, og deaktiver deretter API-nøkkelen.
- Hvis du vil sjekke om kontoens API-nøkkel har blitt brukt de siste sju dagene, kan du se anropsloggen for API-nøkkelen. Anropsloggen viser ingen forespørsler som er gjort med nøkkelen for mer enn sju dager siden.
- Apper som er oppført på sidenTilkoblede app er i kontoinnstillingene, trenger ikke å migreres, ettersom de autentiseres med OAuth.
- API-nøkler for utviklere er atskilt fra standard HubSpot API-nøkler, og blir ikke utfaset. API-nøkler for utviklere brukes til å administrere innstillinger knyttet til HubSpot-appene dine, inkludert API-abonnementer for webhooks og API-hendelsestyper for tidslinjehendelser.
Få tilgang til API-nøkkelen din
Du må ha Super Admin-rettigheter for å få tilgang til API-nøkkelen for kontoen din.
- I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
- Gå til Integrasjoner > API-nøkkel i menyen til venstre.
- Hvis det aldri har blitt generert en nøkkel for kontoen din, klikker du på Generer API-nøkkel.
- Hvis du allerede har generert en API-nøkkel, klikker du på Vis for å vise nøkkelen.
- Når nøkkelen vises, klikker du på Kopier for å kopiere nøkkelen. Deretter kan du lime inn nøkkelen for å gi den til utviklerne eller bruke den i applikasjonene dine.
Rotere API-nøkkelen
Hvis du gir API-nøkkelen din til en utvikler, får vedkommende full tilgang til å gjøre endringer i kontoen din via HubSpots API, inkludert å lese loggførte e-poster fra tilkoblede e-postkontoer og andre tredjepartsdata.
For å øke sikkerheten bør du vurdere å bytte HubSpot API-nøkkel hvert halvår. Når du roterer HubSpot API-nøkkelen, deaktiveres den eksisterende API-nøkkelen og en ny genereres. HubSpot vil vise alderen på API-nøkkelen og anbefale når du bør rotere API-nøkkelen.
E-postvarsler sendes hver 180. dag til superadministratorer og brukere som sist opprettet eller roterte API-nøkkelen, hvis API-nøkkelen ikke har blitt rotert i løpet av denne perioden.
Selv om dette kan føre til driftsstans og kreve en del arbeid, øker det sikkerheten ved å forhindre at ondsinnede programmer får tilgang til HubSpot-informasjon med den eksisterende API-nøkkelen.
Slik roterer du HubSpot API-nøkkelen:
- I HubSpot-kontoen din klikker du på innstillingsikonet i hovednavigasjonslinjen.
- I menyen til venstre navigerer du til Integrations > API key.
- Klikk på rullegardinmenyen Handlinger, og velg deretter Roter nøkkel.
- Klikk på Roter og utløp denne nøkkelen nå. Merk av for reCAPTCHA. Den eksisterende nøkkelen deaktiveres, og en ny API-nøkkel opprettes.
- Klikk på Kopier og erstatt den deaktiverte API-nøkkelen som brukes av applikasjonene dine, med den nye API-nøkkelen.
API-anrop som bruker den deaktiverte HubSpot API-nøkkelen, vil nå mislykkes, og applikasjoner som bruker nøkkelen, vil ikke lenger ha tilgang til informasjonen din.
Hvis du bytter API-nøkkel, vil det ikke påvirke tilkoblingen til Salesforce-integrasjonen. Hvis du har installert en tilpasset integrasjon, må du imidlertid oppdatere API-nøkkelen etter at du har rotert den.
Merk: Tilkoblede apper som er installert via App Marketplace, påvirkes ikke når du roterer API-nøkkelen.
Deaktiver API-nøkkelen din
Hvis du deaktiverer API-nøkkelen, opprettes det ikke en ny nøkkel. API-anrop som bruker den deaktiverte HubSpot API-nøkkelen, vil mislykkes, og alle applikasjoner som bruker nøkkelen, vil ikke lenger ha tilgang til informasjonen din.
Slik deaktiverer du API-nøkkelen:- I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
- Naviger til Integrations > API key i menyen til venstre.
- Klikk på rullegardinmenyen Handlinger .
- Klikk på Deaktiver nøkkel, og klikk på Deaktiver denne nøkkelen nå. Merk av for reCAPTCHA.
Se API-revisjonsloggen din
Du kan se en datert logg over brukere som har sett, opprettet eller deaktivert kontoens API-nøkkel i delen Revisjonslogg.
- I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
- Gåtil Integrasjoner > API-nøkkeli menyen til venstre .
- Klikk på fanen Revisjonslogg.
Se anropsloggen for API-nøkkelen
For å hjelpe deg med å feilsøke en av integrasjonene dine eller for å sikre at du overholder HubSpots retningslinjer for API-bruk, kan du se en logg over API-nøkkelanropene dine de siste 7 dagene.
- I HubSpot-kontoen din klikker du på settings innstillinger-ikonet i den øverste navigasjonslinjen.
- I menyen til venstre navigerer du til Integrations > API key.
- I fanen Anropslogg kan du se all aktivitet de siste 7 dagene.