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 !