Heroku - 23 API REST Exercice

Bienvenue dans ce cours d'introduction à Heroku. Dans cet exercice pratique, nous allons créer le code nécessaire pour insérer un nouveau compte (Account) dans Salesforce via une API REST. Notre démarche se déroule en trois étapes : déployer le code sur Heroku, envoyer une requête vers Salesforce via l'API REST pour créer le compte, puis valider que celui-ci a bien été créé dans Salesforce. L'objectif est de comprendre comment construire des requêtes vers Salesforce en utilisant la librairie Node.js JSforce pour manipuler des données depuis une application Heroku.

Analyse du code Express et JSforce

Examinons d'abord le code. Il s'agit d'un serveur Express qui, en recevant une requête, en émettra une autre vers Salesforce pour créer un compte. Les premières lignes créent un nouveau serveur Express, puis nous importons JSforce, la librairie utilisée pour se connecter à Salesforce et envoyer des requêtes via l'API REST. Nous créons ensuite un endpoint /account. Lorsque l'on reçoit la requête, la fonction se connecte à Salesforce avec les identifiants fournis. Si la connexion réussit, on accède à l'objet Account et l'on déclenche l'action create. On définit ensuite les champs à créer : Name, Phone et Website. Vous pouvez bien sûr choisir les champs qui vous intéressent. La dernière partie gère les erreurs potentielles ; s'il n'y en a pas, on retourne l'identifiant de l'objet créé.

Pour déployer le code, j'ouvre mon invite de commandes et je le pousse vers Heroku :

git add .
git commit -m "message"
git push heroku master

Une fois le code déployé, il faut faire une requête POST. J'aurai besoin de Postman pour cela. Je récupère d'abord l'endpoint en ouvrant l'application sur le dashboard Heroku, puis je configure dans Postman une requête POST sur l'URL de l'application suivie de /account. Après l'envoi, je retourne sur Salesforce : le compte a bien été créé, avec le numéro de téléphone et le site web renseignés (par exemple www.google.com). C'est à peu près tout pour l'API REST. Voilà ce qui clôt cette vidéo et ce cours sur Heroku. À bientôt pour un prochain cours !

En résumé

Ce cours enseigne comment créer une API REST avec Express et Heroku qui s'intègre à Salesforce pour créer des Accounts. En utilisant la librairie jsforce, l'exercice consiste à construire un serveur Express déployé sur Heroku, configurer un endpoint POST, et tester la création d'un Account via Postman en validant les résultats dans Salesforce.

Points clés

  • Utiliser Express et jsforce pour construire une API REST connectée à Salesforce
  • Déployer l'application sur Heroku via git pour la rendre accessible
  • Créer un endpoint POST /account qui reçoit une requête et crée un Account Salesforce avec des champs (name, phone, website)
  • Tester l'API avec Postman en envoyant une requête POST vers l'endpoint Heroku
  • Valider que l'Account a été correctement créé dans Salesforce via l'interface
  • Comprendre comment les requêtes HTTP transitent entre Express et Salesforce via l'API REST

Questions fréquentes

Qu'est-ce que jsforce et pourquoi l'utiliser ?

jsforce est une librairie Node.js qui permet de se connecter à Salesforce et de faire des requêtes via l'API REST pour manipuler les données comme créer, lire ou modifier des Accounts.

Comment déployer le code sur Heroku ?

En utilisant git, il faut faire un git commit avec les modifications, puis un git push vers Heroku. Le code est automatiquement déployé et devient accessible via une URL Heroku.

Pourquoi utiliser Postman dans cet exercice ?

Postman permet de tester l'API en envoyant des requêtes POST vers l'endpoint /account de l'application Heroku et de vérifier que les données sont correctement envoyées à Salesforce.