Sidst opdateret: juni 28, 2023
Gælder for:
Alle produkter og abonnementer
|
Med HubSpot API-nøglen kan dine udviklere skabe brugerdefinerede applikationer med HubSpots API'er. Hver nøgle er specifik for en HubSpot-konto, ikke en individuel bruger, og kun én nøgle er tilladt ad gangen.
Bemærk: Fra den 30. november 2022 er HubSpot API Keys ved at blive forældet og understøttes ikke længere. I stedet skal du autentificere dig ved hjælp af et privat app-adgangstoken eller OAuth. Læs mere om denne ændring, og hvordan du migrerer en API-nøgleintegration til at bruge en privat app i stedet.
Hvis du ser et banner på din konto om at deaktivere din API-nøgle:
- Sørg for, at du har migreret alle påvirkede integrationer, og deaktiver derefter API-nøglen.
- For at tjekke, om kontoens API-nøgle er blevet brugt inden for de seneste syv dage, kan du se din API-nøgleopkaldsloghistorik. Opkaldsloggen vil ikke vise nogen anmodninger, der er foretaget med nøglen for mere end syv dage siden.
- Apps, der er angivet på sidenConnected apps i dine kontoindstillinger, behøver ikke at blive migreret, da de autentificerer med OAuth.
- API-nøgler til udviklere er adskilt fra standard HubSpot API-nøgler og bliver ikke forældet. Developer API-nøgler bruges til at administrere indstillinger relateret til dine HubSpot-apps, herunder webhooks API-abonnementer og tidslinjehændelser API-hændelsestyper.
Få adgang til din API-nøgle
Du skal have Super Admin-tilladelser for at få adgang til din kontos API-nøgle.
- På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje.
- I menuen i venstre side skal du navigere til Integrationer > API-nøgle.
- Hvis der aldrig er blevet genereret en nøgle til din konto, skal du klikke på Generer API-nøgle.
- Hvis du allerede har genereret en API-nøgle, skal du klikke på Vis for at få vist din nøgle.
- Når nøglen vises, skal du klikke på Kopier for at kopiere nøglen. Du kan derefter indsætte nøglen for at give den til dine udviklere eller bruge den i dine applikationer.
Drej din API-nøgle
Hvis du giver din API-nøgle til en udvikler, får vedkommende fuld adgang til at foretage ændringer på din konto via HubSpots API, herunder at læse loggede e-mails fra tilsluttede e-mailkonti og andre tredjepartsdata.
For ekstra sikkerhed bør du overveje at udskifte din HubSpot API-nøgle hvert halve år. Når du roterer din HubSpot API-nøgle, deaktiveres den eksisterende API-nøgle, og der genereres en ny. HubSpot vil vise alderen på API-nøglen og anbefale, hvornår du bør rotere din API-nøgle.
E-mailnotifikationer sendes hver 180. dag til superadministratorer og brugere, der sidst oprettede eller roterede API-nøglen, hvis API-nøglen ikke er blevet roteret inden for den tidsramme.
Selvom dette kan skabe nedetid og kræve en indsats, tilføjer det et lag af sikkerhed ved at forhindre ondsindede applikationer i at få adgang til dine HubSpot-oplysninger med din eksisterende API-nøgle.
Sådan roterer du din HubSpot API-nøgle:
- På din HubSpot-konto skal du klikke på ikonet for indstillinger i hovednavigationslinjen.
- I menuen i venstre side skal du navigere til Integrationer > API-nøgle.
- Klik på rullemenuen Handlinger, og vælg derefter Rotér nøgle.
- Klik på Roter og udløb denne nøgle nu. Vælg afkrydsningsfeltet reCAPTCHA. Din eksisterende nøgle vil blive deaktiveret, og der vil blive oprettet en ny API-nøgle.
- Klik på Copy, og erstat den deaktiverede API-nøgle, der bruges af dine applikationer, med denne nye API-nøgle.
API-kald, der bruger den deaktiverede HubSpot API-nøgle, vil nu mislykkes, og ethvert program, der bruger nøglen, vil ikke længere kunne få adgang til dine oplysninger.
Hvis du roterer din API-nøgle, vil det ikke påvirke din forbindelse til Salesforce-integrationen. Men hvis du har installeret en brugerdefineret integration, skal du opdatere din API-nøgle, når du har roteret den.
Bemærk: Forbundne apps, der er installeret via App Marketplace, vil ikke blive påvirket, når du roterer din API-nøgle.
Deaktiver din API-nøgle
Deaktivering af din API-nøgle opretter ikke en ny nøgle. API-kald, der bruger den deaktiverede HubSpot API-nøgle, vil mislykkes, og ethvert program, der bruger nøglen, vil ikke længere kunne få adgang til dine oplysninger.
Sådan deaktiverer du din API-nøgle:- På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje.
- Naviger til Integrationer > API-nøgle i menuen i venstre side.
- Klik på rullemenuen Handlinger .
- Klik på Deaktivér nøgle, og klik på Deaktivér denne nøgle nu. Vælg afkrydsningsfeltet reCAPTCHA.
Se din API-revisionslog
Du kan se en dateret log over brugere, der har set, oprettet eller deaktiveret din kontos API-nøgle i afsnittet Audit log.
- På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje.
- Naviger til Integrationer > API-nøglei menuen i venstre side .
- Klik på fanen Revisionslog.
Se din API-nøgleopkaldslog
For at hjælpe dig med at debugge en af dine integrationer eller for at sikre, at du overholder HubSpots retningslinjer for brug af API, kan du se en log over dine API-nøgleopkald i de foregående 7 dage.
- På din HubSpot-konto skal du klikke på indstillingsikonet på den øverste navigationslinje.
- I menuen i venstre side skal du navigere til Integrationer > API-nøgle.
- På fanen Opkaldslog kan du se al aktivitet for de seneste 7 dage.
