Con la chiave API di HubSpot, i vostri sviluppatori possono creare applicazioni personalizzate con le API di HubSpot. Ogni chiave è specifica per un account HubSpot, non per un singolo utente, ed è consentita una sola chiave alla volta.
Attenzione:a partire dal 30 novembre 2022, le chiavi API di HubSpot sono state deprecate e non sono più supportate. Saràinvece necessario autenticarsi con un token di accesso privato all'app o con OAuth. Per saperne di più suquesto cambiamento e su comemigrare un'integrazione con chiave API per utilizzare invece un'app privata.
Se nel vostro account viene visualizzato un banner sulla disattivazione della chiave API:
Per accedere alla chiave API del proprio account è necessario disporre dei permessi di Super Admin.
Fornendo la chiave API a uno sviluppatore, questi avrà pieno accesso alle modifiche del vostro account attraverso l'API di HubSpot, compresa la lettura delle e-mail registrate dagli account e-mail collegati e altri dati di terze parti.
Per una maggiore sicurezza, considerate la possibilità di ruotare la vostra chiave API di HubSpot ogni sei mesi. La rotazione della chiave API di HubSpot disattiva la chiave API esistente e ne genera una nuova. HubSpot visualizzerà l'età della chiave API e consiglierà quando è necessario ruotare la chiave API.
Le notifiche via e-mail vengono inviate ogni 180 giorni ai superamministratori e agli utenti che hanno creato o ruotato la chiave API per ultimi, se la chiave API non è stata ruotata in quell'arco di tempo.
Sebbene questa operazione possa creare tempi di inattività e richiedere uno sforzo, aggiunge un livello di sicurezza impedendo ad applicazioni malintenzionate di accedere alle informazioni di HubSpot con la chiave API esistente.
Per ruotare la chiave API di HubSpot:
Le chiamate API che utilizzano la chiave API di HubSpot disattivata falliranno e qualsiasi applicazione che utilizza la chiave non sarà più in grado di accedere alle informazioni.
La rotazione della chiave API non influisce sulla connessione con l'integrazione Salesforce. Tuttavia, se è stata installata un'integrazione personalizzata, sarà necessario aggiornare la chiave API dopo la rotazione.
Nota bene: le app connesse installate tramite App Marketplace non saranno interessate dalla rotazione della chiave API.
La disattivazione della chiave API non creerà una nuova chiave. Le chiamate API che utilizzano la chiave API di HubSpot disattivata falliranno e qualsiasi applicazione che utilizza la chiave non sarà più in grado di accedere alle vostre informazioni.
Per disattivare la chiave API:È possibile visualizzare un registro datato degli utenti che hanno visualizzato, creato o disattivato la chiave API dell'account nella sezione Registro di controllo.
Per aiutarvi a eseguire il debug di una delle vostre integrazioni o per assicurarvi che stiate rispettando le linee guida di HubSpot sull'utilizzo delle API, potete visualizzare un registro delle chiamate alla chiave API per i 7 giorni precedenti.