Règles d'utilisation des API

HubSpot suit attentivement l'utilisation de nos API publiques pour assurer une expérience de qualité pour chaque utilisateur. Tous les développeurs d'applications et d'intégrations doivent respecter la Politique d'utilisation acceptable de HubSpot et les Conditions générales relatives aux API. Bien que HubSpot se réserve le droit de modifier ou de désapprouver les API au fil du temps, les mises à jour seront toujours fournies à l'avance via le changelog des développeurs.

Authentification et sécurité

Pour une sécurité optimale, toutes les applications doivent utiliser directement le protocole OAuth de HubSpot ou le jeton d'accès de votre application si vous créez une application privée. Les applications sont chargées de stocker des données time-to-live (TTL) et d'actualiser les jetons d'accès des utilisateurs conformément à ce protocole. Lorsqu'un jeton d'accès est généré, il inclura un paramètre expires_in indiquant la durée durant laquelle il peut être utilisé pour effectuer des appels d'API avant l'actualisation. Les requêtes Unauthorized (401) ne sont pas un indicateur valide qu'un nouveau jeton d'accès doit être récupéré.

Applications privées

Pour afficher l'utilisation de l'API pour une application privée :

• 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 le nom de l'application privée.
• Sur la page de détails de l'application, cliquez sur l'onglet Journaux.
• Passez en revue les appels d'API répertoriés dans le tableau. Vous pouvez également utiliser la barre de recherche, les filtres et les sélecteurs de dates pour affiner davantage les appels d'API affichés.

Découvrez-en davantage sur la vérification de l'utilisation de l'API dans les applications privées.

Applications publiques utilisant OAuth

Pour afficher l'utilisation de l'API pour une application publique utilisant OAuth :

• Dans votre compte de développeur, accédez à Apps dans la barre de navigation principale.
• Cliquez sur le nom de l'application.
• Dans le menu latéral de gauche, accédez à Suivi.
• Utilisez les onglets pour afficher les différents types de demandes effectuées vers ou à partir de l'application. Lors de l'affichage de ces journaux, vous pouvez cliquer sur une demande pour afficher plus d'informations à son sujet.

Découvrez-en davantage sur le suivi de l'utilisation de l'API pour les applications publiques.

Applications utilisant OAuth

Pour les applications OAuth, chaque compte HubSpot qui installe votre application est limité à 100 requêtes toutes les 10 secondes. Cela exclut l'API de recherche, comme indiqué dans la section Autres limites ci-dessous. Les limites liées au module complémentaire d'API ne s'appliquent pas.

Applications privées

Chaque application privée est soumise aux directives sur l'utilisation des API HubSpot. Le nombre d'appels que votre application privée peut effectuer dépend de l'abonnement de votre compte et de l'achat du module complémentaire API :

• Vous pouvez créer jusqu'à 100 applications par compte de développeur.
• Vous pouvez créer jusqu'à 20 applications privées par compte HubSpot.
• Vous pouvez créer jusqu'à 1 000 abonnements de webhook par application.
• Vous pouvez créer jusqu'à 25 paramètres d'extension de CRM par application.
• Vous pouvez créer jusqu'à 750 types d'événements chronologiques par application.
• Vous pouvez créer jusqu'à 500 propriétés par type d'événement chronologique.
• Les point de terminaison de l'API de recherche sont limités à quatre demandes par seconde par jeton d'authentification.

Découvrez-en davantage sur les limites de service et les tarifs ici.

Toute application ou intégration dépassant ses limites de taux recevra une réponse d'erreur 429 pour tous les appels d'API ultérieurs. Les demandes résultant d'une réponse d'erreur ne doivent pas dépasser 5 % de vos demandes quotidiennes. Si vous prévoyez de répertorier votre application dans le marketplace des applications de HubSpot, celle-ci doit rester sous cette limite de 5 % pour être certifiée. 

La réponse 429 sera au format suivant : 

message et policyNameindiqueront la limite que vous avez atteinte (quotidienne ou par seconde).

La limite quotidienne se réinitialise à minuit selon votre fuseau horaire.

Le tableau suivant détaille les en-têtes de limite de débit inclus dans la réponse de chaque appel d'API formulé à HubSpot, sous réserve des exceptions répertoriées sous le tableau.

Vous pouvez également vérifier le nombre d'appels utilisés le jour en cours à l'aide de ce point de terminaison.

Si vous atteignez la limite TEN_SECONDLY_ROLLING, vous devez maintenir les demandes de votre application sous cette limite. Par ailleurs, si vous atteignez la limite quotidienne, consultez les suggestions ci-dessous.

Si vous atteignez toujours les limites d'appel après avoir suivi ces suggestions, veuillez publier sur nos forums des développeurs. Fournissez autant de détails que possible quant aux API utilisées, à leur utilisation et à la limite atteinte.

Si votre site ou votre application utilise des données de HubSpot sur chaque chargement de page, ces données doivent être mises en cache et chargées à partir de ce cache au lieu d'être demandées à chaque fois à partir des API de HubSpot. Si vous effectuez des appels répétés pour obtenir des paramètres depuis votre compte pour un traitement par lot (comme l'obtention de propriétés d'objet, de propriétaires ou de paramètres pour un formulaire), ces paramètres doivent également être mis en cache, le cas échéant.

Si vous disposez d'un abonnement HubSpot Marketing Entreprise, vous pouvez utiliser des actions de webhook dans les workflows pour obtenir des données pour les fiches d'informations de contact envoyées à votre système. Les webhooks peuvent être déclenchés en tant qu'action dans n'importe quel workflow, afin que vous puissiez utiliser les conditions initiales de workflow comme critères pour l'envoi des données de contact à votre système. Pour en savoir plus sur l'utilisation des webhooks, consultez cet article et des exemples de données de webhooks ici. Les appels de webhook effectués via des workflows ne sont pas comptabilisés dans la limite de l'API.