10.2. Création d'une API REST de base avec NodeJS et ExpressJS : installation d'ExpressJS

La création d'une API REST de base avec NodeJS et ExpressJS est un processus simple et direct qui peut être effectué par toute personne possédant des connaissances de base en programmation. Dans ce chapitre, nous verrons comment installer ExpressJS et comment l'utiliser pour créer une API REST de base.

Installation d'ExpressJS

Avant de commencer à créer votre API, vous devrez installer ExpressJS. ExpressJS est un framework pour NodeJS qui simplifie le développement d'applications Web et d'API. Il fournit un moyen simple de définir des routes et de gérer les requêtes HTTP.

Pour installer ExpressJS, vous devez d'abord avoir NodeJS et npm (le gestionnaire de packages de Node) installés sur votre ordinateur. Si vous ne les avez pas encore installés, vous pouvez les télécharger depuis le site officiel de NodeJS.

Une fois NodeJS et npm installés, vous pouvez installer ExpressJS à l'aide de la commande npm. Ouvrez un terminal ou une invite de commande et tapez la commande suivante :

npm install express

Cette commande téléchargera et installera ExpressJS dans votre projet. Vous êtes maintenant prêt à commencer à créer votre API REST.

Créer une API REST de base avec NodeJS et ExpressJS

Maintenant qu'ExpressJS est installé, vous pouvez commencer à créer votre API. Une API REST est une interface qui permet l'interaction entre différentes parties d'une application via des requêtes HTTP. Les requêtes peuvent consister à créer, lire, mettre à jour ou supprimer des données (appelées opérations CRUD).

Commençons par créer un nouveau fichier appelé "app.js". Ce sera le point d’entrée de notre application. En haut du fichier, importez ExpressJS à l'aide de la commande require :

const express = require('express');

Ensuite, créez une nouvelle instance ExpressJS :

const app = express();

Vous pouvez maintenant commencer à définir les routes pour votre API. Un itinéraire est un chemin dans votre application qui correspond à une certaine action. Par exemple, vous pouvez avoir une route pour créer un nouvel utilisateur, une autre pour obtenir des informations sur un utilisateur, et ainsi de suite.

Commençons par définir une route simple qui renvoie un message de bienvenue. Pour ce faire, utilisez la méthode get de l'objet app. Le premier argument est le chemin de la route, et le second est une fonction qui sera appelée lors de l'accès à la route :

app.get('/', (req, res) => {
  res.send('Bienvenue dans notre API REST de base !');
});

Enfin, vous devez dire à ExpressJS de commencer à écouter les requêtes HTTP. Pour ce faire, utilisez la méthode d'écoute de l'objet app :

app.listen(3000, () => {
  console.log('L'API s'exécute sur le port 3000');
});

Maintenant, si vous exécutez votre application (à l'aide de la commande "node app.js" dans le terminal), vous verrez le message "L'API est en cours d'exécution sur le port 3000". Si vous allez sur "http://localhost:3000" dans votre navigateur, vous verrez le message de bienvenue que vous avez défini.

Félicitations, vous venez de créer votre première API REST de base avec NodeJS et ExpressJS ! Dans le chapitre suivant, nous développerons cette API pour inclure les opérations CRUD et la connexion à une base de données.