- 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 > Applications privées.
- Cliquez sur Créer une application privée.
- Dans l'onglet Informations de base, configurez les détails de votre application :
- Saisissez le nom de votre application.
- Passez le curseur de la souris sur le logo de variable et cliquez sur l'icône de téléchargement pour télécharger une image carrée qui servira de logo pour votre application.
- Saisissez une description pour votre application.
- Cliquez sur l'onglet Domaines.
- Sélectionnez la case à cocher Lecture ou Écriture pour chaque domaine auquel vous souhaitez que votre application privée puisse accéder. Vous pouvez également rechercher un périmètre spécifique en utilisant la barre de recherche Trouver un domaine.
- Lorsque vous avez terminé de configurer votre application, cliquez sur Créer une application dans l'angle supérieur droit.
- Dans la boîte de dialogue, vérifiez les informations sur le jeton d'accès de votre application, puis cliquez sur Continuer de créer.
Une fois votre application créée, vous pouvez commencer à passer des appels d'API à l'aide du jeton d'accès de l'application. Si vous devez modifier les informations de votre application ou en modifier les domaines, cliquez sur Modifier les détails.
Pour passer des appels d'API, accédez à la page de détails de votre application.
- Sur la carte Jeton d'accès, cliquez sur Afficher le jeton pour afficher votre jeton d'accès. Cliquez sur Copier pour copier le jeton dans le presse-papiers.
- Vous pouvez ensuite coller le jeton d'accès pour le fournir à vos développeurs ou l'utiliser dans le cadre du développement de votre application. Lorsque vous effectuez un appel vers l'un des points de terminaison de l'API HubSpot, définissez la valeur du champ Autorisation sur Bearer [VOTRE_JETON] Par exemple, si vous effectuez un appel vers l'API Contacts via Node.js et axios, la demande ressemblera à ceci :
Si votre jeton d'accès est perdu ou corrompu, vous pouvez l'actualiser. Un nouveau jeton d'accès sera créé et le jeton d'accès initial expirera.
- Dans votre compte HubSpot, cliquez sur la page Paramètres dans la barre de navigation principale.
- Accédez à Intégrations > Applications privées.
- Cliquez sur le nom de votre application privée.
- À côté de votre jeton d'accès, cliquez sur Actualiser :
- Si votre jeton est corrompu et que vous souhaitez révoquer immédiatement l'accès, cliquez sur Actualiser et expirer maintenant.
- S'il n'y a pas de menace imminente quant à votre jeton, il est toujours recommandé d'assurer la rotation de votre jeton tous les six mois. Si vous souhaitez lancer une rotation régulière de votre jeton, cliquez sur Actualiser et expirer ultérieurement, ce qui déclenchera une expiration du jeton dans 7 jours.
- Si votre application est prête à effectuer une transition plus tôt, vous pouvez cliquer sur Faire expirer maintenant.
- Si vous avez besoin de plus de temps, vous pouvez cliquer sur Annuler la rotation, ce qui annulera l'expiration du jeton initial et révoquera le nouveau jeton d'accès.
HubSpot enverra également des notifications par e-mail aux super administrateurs avec des rappels sur l'état de rotation des jetons d'accès ainsi que d'autres alertes connexes. Les super administrateurs de votre compte HubSpot recevront des notifications pour les événements et rappels suivants :
- Un super administrateur a initié une rotation (soit immédiatement, soit planifiée pour 7 jours à partir de maintenant).
- Un super administrateur a annulé une rotation en attente.
- Un super administrateur a choisi d'expirer immédiatement un jeton d'accès en cliquant sur Expirer maintenant au lieu d'attendre 7 jours pour que le jeton expire.
- Le jeton d'accès de l'application va expirer dans 24 heures.
- Le jeton d'accès de l'application a fait l'objet d'une rotation et a expiré au bout de 7 jours.
- Si vous n'avez pas fait pivoter votre jeton d'accès depuis plus de 180 jours, les super administrateurs recevront également un e-mail de rappel pour faire pivoter le jeton d'accès de votre application.
Pour consulter les appels d'API que votre application a effectués au cours des 30 derniers jours :
- Sur la page de détails de votre application, cliquez sur l'onglet Journaux.
- Analysez et filtrez vos appels d'API pour votre application privée :
- Cliquez sur les menus déroulants Méthode et Réponse pour filtrer vos appels d'API passés par méthode de demande ou par code de réponse.
- Cliquez sur les menus déroulants Date de début ou Date de fin pour filtrer vos journaux d'appels selon une période spécifique.
- Vous pouvez également rechercher des appels spécifiques par URL dans le champ Rechercher par l'URL de demande.
- Pour exporter les journaux d'appels de l'API, cliquez sur Exporter des journaux (CSV). Spécifiez ensuite une plage de dates (jusqu'à 30 jours auparavant) et cliquez sur Exporter.
- Dans la boîte contextuelle, sélectionnez la plage de dates des appels d'API que vous souhaitez exporter et cliquez sur Exporter. Vous recevrez un e-mail contenant un lien de téléchargement lorsque le fichier sera prêt.