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: juin 23, 2022

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.

Remarque : à partir du 30 novembre 2022, les clés API HubSpot ne pourront plus être utilisées comme méthode d'authentification pour accéder aux API HubSpot. En outre, à compter du 15 juillet 2022, les comptes sans clé API HubSpot déjà générés ne pourront plus en créer un.

Au lieu de cela, vous devrez utiliser un jeton d'accès d'application privée ou OAuth pour authentifier les appels d'API. Découvrez-en plus sur cette modification et sur la façon de migrer une intégration de clé API pour utiliser une application privée.

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 à settings l'icône Paramètres 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.

Des notifications par e-mail sont envoyées tous les 180. 

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 à settings l'icône Paramètres 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 à settings l'icône Paramètres 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 consulter un journal des appels de votre clé d'API au cours des 7 derniers jours. 

  • Depuis votre compte HubSpot, accédez à settings l'icône Paramètres 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

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.