Documentation de référence pour les API de HubSpot

La plateforme de développement de HubSpot est une partie fondamentale de notre mission consistant à aider les organisations à mieux se développer. Nos API sont conçues pour permettre à toutes les équipes de mettre en place des intégrations solides afin de personnaliser et de tirer le meilleur parti de HubSpot.

Toutes les API de HubSpot sont conçues à l'aide de conventions REST et développées pour avoir une structure d'URL prévisible. Elles utilisent de nombreuses fonctionnalités HTTP standards, notamment des méthodes (POST, GET, PUT, DELETE) et des codes de réponse d'erreur. Tous les appels d'API de HubSpot sont effectués sous https://api.hubapi.com et toutes les réponses renvoient des données JSON standards.

Configuration

Plusieurs méthodes permettent de créer des intégrations avec HubSpot :

• Pour créer une intégration interne pour un compte HubSpot individuel (par exemple, vous souhaitez créer une application qui peut accéder et modifier uniquement les parties pouvant être partagées ou intégrées avec d'autres parties de votre organisation), créez une application privée.
• Si vous souhaitez créer une application publique pouvant être installée sur plusieurs comptes HubSpot, vous devez créer un compte de développeur. Plusieurs raisons expliquent cela : un compte de développeur permet de créer des applications HubSpot, chacune authentifiée avec OAuth et fournie avec un ensemble configurable de fonctionnalités et d'autorisations. Vous pouvez également utiliser votre compte de développeur pour créer des comptes de test, surveiller le statut et les performances des applications ou publier des applications sur le marketplace des applications de HubSpot.

Découvrez-en davantage sur les différents types d'applications et de comptes dans cet article.

Bibliothèques de clients

Les bibliothèques de clients sont conçues pour vous aider à interagir sans encombre avec les API de HubSpot. Elles sont rédigées dans plusieurs langages et permettent de combler les écarts entre vos applications et les API de HubSpot. Ainsi, il est inutile de connaître l'URL exacte et la méthode HTTP à utiliser pour chaque appel d'API, entre autres. Vous pouvez alors vous concentrer pleinement sur la conception de votre application. Découvrez-en davantage sur les bibliothèques de clients ici.

Documentation des API

La documentation des API de HubSpot est divisée en deux sections : les documents de référence et les guides d'intégration.

Documents de référence

Tous les documents de référence sur les API comprennent une vue d'ensemble et une section sur les points de terminaison. La vue d'ensemble d'une API comprend un bref récapitulatif de sa fonctionnalité, des cas d'utilisation et toute autre considération particulière pour la création d'une intégration. La section sur les points de terminaison liste chaque point de terminaison, ses paramètres et des exemples de demandes dans plusieurs langages.

Une fois que vous avez configuré les paramètres d'authentification de votre application dans votre compte de développeur, vous pouvez utiliser Postman ou réaliser des appels de test directement depuis la page de référence d'un point de terminaison. 

Guides d'intégration

Si vous souhaitez découvrir les fondamentaux de la plateforme de HubSpot ou voir un exemple avant d'effectuer votre premier appel d'API, vous pouvez trouver des exemples d'applications et des tutoriels ainsi que des informations détaillées sur les comptes de développeur, l'utilisation d'OAuth, les limites des API et bien plus encore dans la section Guides d'intégration. 

Associé : découvrez-en davantage sur les méthodes d'authentification ou sur OAuth.

Lister une application

Lorsque vous êtes prêt à partager votre application avec le monde entier et à devenir un partenaire d'application, consultez les conditions de listing et de certification. Une fois cette étape terminée, vous pouvez créer et gérer votre listing du marketplace des applications à partir de votre compte de développeur.

Support et ressources de la communauté

Obtenez des réponses, tissez des liens et partagez vos idées en rejoignant les forums de la communauté des développeurs de HubSpot et la communauté Slack. Ces forums sont d'excellents espaces pour faire entendre votre voix. Les retours de la communauté sont extrêmement précieux pour nous et nos efforts continus pour améliorer l'expérience de développeur de HubSpot.

Vous pouvez également rester au fait des nouvelles fonctionnalités, des annonces et des modifications importantes en vous abonnant au changelog.

Tirer parti du CMS

Vous souhaitez créer un site web, un blog, une page de destination, une application légère ou un e-mail ? Consultez notre documentation des développeurs sur le CMS.

Documents associés

Comment utiliser les API de HubSpot