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.

À partir du code source qui alimente l'application HubSpot, HubSpot génère des documents qui décrivent nos API en utilisant le format API ouverte. Ces documents sont introduits dans le générateur de code d'API ouverte. Ces fichiers générés finissent dans les bibliothèques, mais ce n'est pas tout. Une équipe de développeurs de HubSpot récupère les résultats de cette génération de code et y ajoutent de la valeur en intégrant des fonctions d'utilité, notamment concernant les limites, ainsi que des exemples d'applications afin d'expliquer comment utiliser les bibliothèques en pratique. Ces exemples couvrent un large éventail de cas d'utilisation. Veillez donc à en tirer parti.

Utilisez le point de terminaison ci-dessous pour accéder aux spécifications d'API ouverte disponibles.

GET: https://api.hubspot.com/api-catalog-public/v1/apis

 

          Langue

Lien du package

githubCode source

iconfinder_nodejs-512_339733Node.js

npm install @hubspot/api-client

hubspot-api-nodejs

new-php-logo

PHP

composer require hubspot/api-client

hubspot-api-php

ruby

Ruby

gem install hubspot-api-clientlan

hubspot-api-ruby

iconfinder_267_Python_logo_4375050

Python

pip install hubspot-api-client

hubspot-api-python

Premiers pas

Pour commencer à utiliser ces bibliothèques de clients, vous aurez besoin d'un compte HubSpot, soit un compte standard, soit un compte développeur d'applications.  Cela vous permettra de créer une application privée afin que vous puissiez utiliser le jeton de l'application privée pour authentifier vos appels. Vous pouvez également créer un compte de développeur HubSpot et utiliser OAuth pour authentifier vos appels.

Une fois que vous disposez d'un compte HubSpot et d'un jeton d'accès d'application privée ou OAuth, vous pouvez installer la bibliothèque. Découvrez ci-dessous un exemple d'installation du client Node.js, d'instanciation du client et d'utilisation générale.

Installer 

npm install @hubspot/api-client

Instancier le client

//Authenticate via private app access token stored as a secret const hubspot = require('@hubspot/api-client') const hubspotClient = new hubspot.Client({ accessToken: process.env.secretName }) //Or via OAuth const hubspotClient = new hubspot.Client({ accessToken: YOUR_ACCESS_TOKEN })

Utilisation

//Example call hubspotClient.crm.contacts.basicApi .getPage(limit, after, properties, associations, archived) .then((results) => { console.log(results.body) }) .catch((err) => { console.error(err) })

Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.