Ultimo aggiornamento: dicembre 23, 2021
Con la chiave API di HubSpot, i tuoi sviluppatori possono creare applicazioni personalizzate con le API di HubSpot
. Ogni chiave è specifica per un account HubSpot, non per un singolo utente, ed è consentita solo una chiave alla volta.Nota: se hai intenzione di creare più app o vuoi un controllo più granulare sugli scopi delle tue app, puoi creare un'app privata invece di usare una singola chiave API per tutte le tue app. Ogni app privata ha il proprio token di accesso, che è implementato sopra OAuth. Scopri di più sulle app private nella documentazione per gli sviluppatori di HubSpot
.Accedi alla tua chiave API
Devi avere i permessi di Super Admin
per accedere alla chiave API del tuo account.- Nel tuo account HubSpot, clicca sull'icona delle impostazioni nella barra di navigazione principale.
- Nel menu laterale sinistro, vai su Integrazioni > Chiave API.
- Se non è mai stata generata una chiave per il tuo account, clicca su Generate API key.
- Se hai già generato una chiave API, clicca su Show per visualizzare la tua chiave.
- Con la chiave visualizzata, fai clic su Copy per copiare la chiave. Puoi quindi incollare la chiave per fornirla ai tuoi sviluppatori o utilizzarla nelle tue applicazioni.
Ruota la tua chiave API
Fornire la tua chiave API a uno sviluppatore gli darà pieno accesso per apportare modifiche al tuo account attraverso l'API di HubSpot, compresa la lettura delle email registrate dagli account email collegati e altri dati di terze parti.
Per una maggiore sicurezza, considera di ruotare la tua chiave API HubSpot ogni sei mesi. La rotazione della tua chiave API di HubSpot disattiverà la chiave API esistente e ne genererà una nuova. HubSpot visualizzerà l'età della chiave API e ti consiglierà quando dovresti ruotare la tua chiave API.
Le notifiche via e-mail vengono inviate ogni 180 giorni ai super amministratori e agli utenti che hanno creato o ruotato la chiave API l'ultima volta che la chiave API non è stata ruotata in quel lasso di tempo.
Anche se questo può creare tempi di inattività e richiedere uno sforzo, aggiunge un livello di sicurezza impedendo alle applicazioni malintenzionate di accedere alle tue informazioni HubSpot con la tua chiave API esistente.
Per ruotare la tua chiave API HubSpot:
- Nel tuo account HubSpot, clicca sull' icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, vai a Integrazioni > Chiave API.
- Fai clic sul menu a discesa Azioni, quindi seleziona Ruota chiave.
- Clicca su Ruota e fai scadere questa chiave ora. Seleziona la casella di controllo reCAPTCHA. La tua chiave esistente verrà disattivata e verrà creata una nuova chiave API.
- Fai clic su Copy e sostituisci la chiave API disattivata usata dalle tue applicazioni con questa nuova chiave API.
Le chiamate API che utilizzano la chiave API HubSpot disattivata falliranno e qualsiasi applicazione che utilizza la chiave non sarà più in grado di accedere alle tue informazioni.
La rotazione della tua chiave API non influenzerà la tua connessione con l'integrazione Salesforce
. Tuttavia, se hai un'integrazione personalizzata installata, dovrai aggiornare la tua chiave API dopo averla ruotata.Nota: le app connesse installate tramite App Marketplace
non saranno interessate dalla rotazione della tua chiave API.Disattiva la tua chiave API
Disattivare la tua chiave API non
creerà una nuova chiave. Le chiamate API che utilizzano la chiave API HubSpot disattivata falliranno e qualsiasi applicazione che utilizza la chiave non sarà più in grado di accedere alle tue informazioni. Per disattivare la tua chiave API:- Nel tuo account HubSpot, clicca sull'icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, vai aIntegrations>API key.
- Fai clic sul menu a discesaActions.
- Fai clic suDisattiva chiave e clicca suDisattiva questa chiave ora. Seleziona la casella di controllo reCAPTCHA.
Visualizza il tuo registro di controllo API
Puoi visualizzare un registro datato degli utenti che hanno visualizzato, creato o disattivato la chiave API del tuo account nella sezione Registro di controllo.
- Nel tuo account HubSpot, clicca sull'icona delle impostazioni nella barra di navigazione principale.
- Nel menu laterale sinistro, vai a Integrazioni > Chiave API.
- Clicca sulla scheda Registro di controllo.
Visualizza il registro delle chiamate della tua chiave API
Per aiutarti a fare il debug di una delle tue integrazioni o per assicurarti che stai rispettando Linee guida per l'utilizzo delle API di HubSpotè possibile visualizzare un registro delle chiamate della tua chiave API per i 7 giorni precedenti.
- Nel tuo account HubSpot, clicca sull'icona delle impostazioni nella barra di navigazione principale.
- Nel menu della barra laterale sinistra, vai a Integrazioni > Chiave API.
- Nella scheda Registro chiamate, visualizza tutte le attività degli ultimi 7 giorni.
