10.3. Création d'une API REST de base avec NodeJS et ExpressJS : configuration initiale du projet
Pour commencer à créer une API REST de base avec NodeJS et ExpressJS, vous devez d'abord comprendre ce qu'est une API REST. L'API REST (Representational State Transfer) est un style d'architecture logicielle qui définit la mise en œuvre d'un service Web. Ils permettent l'interaction entre des applications indépendantes via des requêtes HTTP, renvoyant des données qui peuvent être manipulées et utilisées pour développer et exploiter différents types d'applications.
NodeJS est une plate-forme basée sur le moteur JavaScript de Google Chrome permettant de créer facilement des applications Web rapides et évolutives. ExpressJS, quant à lui, est un framework d'application Web exprimé par NodeJS qui fournit un ensemble robuste de fonctionnalités pour les applications Web et mobiles.
Configuration initiale du projet
Pour commencer, vous devez installer NodeJS et NPM (Node Package Manager) sur votre machine. Après l'installation, vous pouvez vérifier la version de NodeJS et NPM à l'aide des commandes : node -v et npm -v respectivement dans le terminal.
Après avoir installé NodeJS et NPM, créez un nouveau dossier pour votre projet et accédez-y à l'aide du terminal. Dans le dossier du projet, exécutez la commande npm init pour créer un nouveau fichier package.json. Ce fichier contiendra des informations sur votre projet et les dépendances qui seront installées ultérieurement.
Ensuite, vous devez installer ExpressJS. Pour cela, utilisez la commande : npm install express --save. Le paramètre --save ajoutera ExpressJS comme dépendance dans votre fichier package.json.
Après avoir installé ExpressJS, créez un nouveau fichier appelé server.js. Ce sera le point d’entrée de votre candidature. Dans server.js, vous devez importer express et configurer le serveur pour écouter sur un port spécifique.
const express = require('express');
const app = express();
port const = 3000 ;
app.écouter(port, () => {
console.log(`Le serveur s'exécute sur le port ${port}`);
});
Maintenant, si vous exécutez la commande node server.js, vous verrez le message « Le serveur s'exécute sur le port 3000 » dans la console. Cela signifie que votre serveur est configuré et écoute sur le port 3000.
Créer des itinéraires
L'étape suivante consiste à créer des itinéraires pour votre application. Les routes sont définies à l'aide des méthodes de l'objet express, où chaque méthode correspond à une méthode HTTP (get, post, put, delete, etc.).
app.get('/', (req, res) => {
res.send('Bonjour tout le monde !');
});
app.post('/', (req, res) => {
res.send('J'ai reçu une requête POST');
});
app.put('/', (req, res) => {
res.send('J'ai reçu une requête PUT');
});
app.delete('/', (req, res) => {
res.send('J'ai reçu une demande DELETE');
});
Les routes ci-dessus répondront aux requêtes GET, POST, PUT et DELETE à la racine de votre site.
Avec cela, vous disposez déjà d'une API REST de base configurée avec NodeJS et ExpressJS. Dans le chapitre suivant, nous explorerons comment connecter votre API à une base de données et comment gérer les données reçues des demandes des clients.