Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.
Integrations

Obtenir une clé d'API HubSpot

Dernière mise à jour: juillet 23, 2021

Disponible avec :

Tous les produits et les abonnements

Grâce à la clé d'API HubSpot, vos développeurs peuvent créer des applications personnalisées avec les API de HubSpot. Chaque clé est spécifique à un compte HubSpot et non à un utilisateur individuel, et une seule clé est autorisée à la fois.

Accéder à votre clé d'API

Vous devez disposer d'autorisations Super administrateur pour accéder à la clé d'API de votre compte. 

  • Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans l'angle supérieur droit.
  • Dans le menu latéral de gauche, accédez à Intégrations > Clé d'API.
    • Si une clé n'a jamais été créée pour votre compte, cliquez sur Générer une clé d'API.
    • Si vous avez déjà généré une clé d'API, cliquez sur Afficher pour afficher votre clé.

show-API-key

  • Quand la clé s'affiche, cliquez sur Copier pour la copier. Vous pouvez ensuite coller la clé pour la fournir à vos développeurs ou l'utiliser dans vos applications.

Faire tourner votre clé d'API

La fourniture de votre clé d'API à un développeur lui permettra d'apporter des modifications à votre compte via l'API de HubSpot, mais également de lire les e-mails consignés dans les comptes de messagerie connectés ainsi que d'autres données tierces.

Pour plus de sécurité, envisagez la rotation de votre clé d'API HubSpot tous les six mois. Le fait de tourner votre clé d'API HubSpot désactive la clé d'API existante et en génère une nouvelle. HubSpot affiche l'ancienneté de la clé d'API et vous indique quand la tourner.

Rappelez-vous que la clé d'API sera envoyée aux super administrateurs et aux utilisateurs qui ont récemment créé ou tourné la clé d'API dans les fréquences et les types de notification suivants :

  • Des notifications via e-mail sont envoyées lorsque la clé d'API atteint cinq mois.
  • Des notifications via la barre latérale sont envoyées lorsque la clé d'API atteint six mois.
  • Des notifications via e-mail et la barre latérale sont envoyées lorsque la clé d'API n'a pas été tournée pendant six mois.

Même si cela peut créer une interruption et nécessite un effort, cela ajoute un calque de sécurité supplémentaire en empêchant les applications malveillantes d'accéder à vos informations HubSpot avec votre clé d'API existante.

Pour tourner votre clé d'API HubSpot :

  • Dans votre compte HubSpot, cliquez sur l'icône Paramètres dans la barre de navigation principale.
  • Dans le menu latéral de gauche, accédez à Intégrations > Clé d'API.
  • Cliquez sur le menu déroulant Actions, puis sélectionnez Faire tourner la clé.
  •  Cliquez sur Faire tourner et expirer cette clé maintenant. Sélectionnez la case à cocher du reCAPTCHA. Votre clé existante sera désactivée et une nouvelle clé d'API sera créée.
  •  Cliquez sur Copier et remplacez la clé d'API désactivée utilisée par vos applications par cette nouvelle clé d'API.

À partir de ce moment, tous les appels d'API utilisant la clé d'API HubSpot désactivée échoueront et toutes les applications utilisant cette clé ne pourront plus accéder à vos informations. 

La rotation de votre clé d'API n'affectera pas votre connexion avec l'intégration Salesforce. Toutefois, si vous avez installé une intégration personnalisée, vous devrez mettre à jour votre clé d'API après la rotation.

Remarque : Les applications connectées installées via le marketplace des applications ne seront pas affectées lorsque vous ferez tourner votre clé d'API.

Désactiver votre clé d'API

La désactivation de votre clé d'API ne créera pas de nouvelle clé. Tous les appels d'API utilisant la clé d'API HubSpot désactivée échoueront et toutes les applications utilisant cette clé ne pourront plus accéder à vos informations.

Pour désactiver votre clé d'API :
  • Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans l'angle supérieur droit.
  • Dans le menu latéral de gauche, accédez à Intégrations Clé d'API.
  • Cliquez sur le menu déroulant Actions.
  • Cliquez sur Désactiver la clé et sur Désactiver cette clé maintenant. Sélectionnez la case à cocher du reCAPTCHA. 

Afficher votre journal d'audit d'API

Accédez à la section Journal d'audit pour afficher un historique des utilisateurs qui ont consulté, créé ou désactivé la clé d'API de votre compte. 

  • Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans l'angle supérieur droit.
  • Dans le menu latéral de gauche, accédez à Intégrations > Clé d'API.
  • Cliquez sur l'onglet Journal d'audit.
  • api-audit-log

Afficher le journal d'appel de votre clé d'API

Pour vous aider à dépanner l'une de vos intégrations ou garantir que vous respectez les directives sur l'utilisation des API HubSpot, vous pouvez afficher consulter un journal des appels de votre clé d'API au cours des 7 derniers jours. 

  • Depuis votre compte HubSpot, accédez à l'icône Paramètres settings dans l'angle supérieur droit.
  • Dans le menu latéral de gauche, accédez à Intégrations > Clé d'API.
  • Dans l'onglet Journal des appels, consultez toutes les activités au cours des 7 derniers jours.
call-log-api