10.1. Créer une API REST de base avec NodeJS et ExpressJS : installer NodeJS

Pour commencer à créer une API REST de base avec NodeJS et ExpressJS, la première étape consiste à installer NodeJS. NodeJS est une plateforme de développement logiciel qui permet l'exécution de JavaScript côté serveur. Il est utilisé pour créer des applications Web évolutives et efficaces, ce qui en fait un choix populaire pour les développeurs d'API.

L'installation de NodeJS est assez simple et directe. Tout d'abord, accédez au site Web officiel de NodeJS à l'adresse https://nodejs.org/en/. Vous y trouverez deux versions disponibles en téléchargement : la version LTS (Long Term Support) et la version actuelle. La version LTS est plus stable et recommandée pour la plupart des utilisateurs, tandis que la version actuelle contient les dernières fonctionnalités.

Après le téléchargement, exécutez le programme d'installation. L'assistant d'installation vous guidera tout au long du processus. Assurez-vous que l'option d'installation du « gestionnaire de packages npm » est sélectionnée car elle sera nécessaire pour installer ExpressJS et d'autres packages.

Pour vérifier que NodeJS est correctement installé, ouvrez un terminal ou une invite de commande et tapez node -v. Cela devrait renvoyer la version de NodeJS que vous avez installée.

Installation d'ExpressJS

ExpressJS est un framework pour NodeJS qui simplifie le développement d'applications Web. Il fournit un cadre simple pour le routage, la gestion des demandes et des réponses, ainsi que d'autres fonctionnalités courantes dans les applications Web.

Pour installer ExpressJS, vous utiliserez npm, qui est le gestionnaire de packages de NodeJS. Dans le terminal ou l'invite de commande, accédez au répertoire dans lequel vous souhaitez créer votre projet et tapez npm init -y. Cela créera un nouveau fichier package.json, qui sera utilisé pour gérer les dépendances de votre projet.

Ensuite, installez ExpressJS en tapant npm install express. Cela téléchargera ExpressJS et l'ajoutera aux dépendances de votre projet.

Créer une API de base

Maintenant que NodeJS et ExpressJS sont installés, vous êtes prêt à commencer à créer votre API. Tout d’abord, créez un nouveau fichier appelé app.js dans le répertoire de votre projet. Ce sera le point d'entrée de votre candidature.

Dans le fichier app.js, commencez par importer ExpressJS avec la commande const express = require('express'). Créez ensuite une nouvelle instance d'ExpressJS avec la commande const app = express().

Pour créer un itinéraire simple, vous pouvez utiliser la méthode app.get(). Par exemple, pour créer une route qui répond aux requêtes GET à la racine de votre site, vous pouvez utiliser le code suivant :

app.get('/', (req, res) => {
  res.send('Bonjour le monde !')
})

Ceci définit une fonction qui sera appelée chaque fois que quelqu'un accède à la racine de votre site avec une requête GET. La fonction envoie la réponse « Hello, World ! ».

Enfin, pour démarrer le serveur, utilisez la méthode app.listen(). Par exemple, le code suivant démarre le serveur sur le port 3000 :

app.écouter(3000, () => {
  console.log('Le serveur s'exécute sur le port 3000')
})

Pour démarrer votre application, tapez node app.js dans le terminal ou l'invite de commande. Vous devriez voir le message « Le serveur s'exécute sur le port 3000 » et vous pouvez désormais accéder à votre API à l'adresse http://localhost:3000.

Félicitations ! Vous avez créé votre première API REST de base avec NodeJS et ExpressJS. À partir de là, vous pouvez commencer à ajouter d'autres routes, manipuler les données de requête et de réponse, vous connecter à une base de données et bien plus encore.