Initialiser le serveur Express

Avant de construire une API, vous devez pouvoir démarrer son processus et confirmer qu’il accepte des requêtes. Dans cette leçon, vous créez le socle Express du service de commandes et vérifiez son fonctionnement avec une route de contrôle temporaire.

Créer le projet Node.js

Dans un terminal, créez le dossier du projet puis initialisez npm. Le fichier package.json rassemble les informations nécessaires à l’exécution et aux dépendances du projet ; vous l’utiliserez ici pour déclarer Express et une commande de démarrage.

mkdir api-commandes
cd api-commandes
npm init -y

Installez ensuite Express comme dépendance du projet. npm enregistre cette dépendance dans package.json et permet de la retrouver avec la commande npm install lors d’une installation ultérieure.

npm install express

Configurer le démarrage

Pour commencer sans ajouter de configuration de modules, gardez le mode CommonJS par défaut de Node.js. Complétez le fichier package.json afin que son point d’entrée soit serveur.js et que npm start lance ce fichier ; conservez la dépendance Express ajoutée par npm.

{
  "name": "api-commandes",
  "version": "1.0.0",
  "description": "API du service de commandes",
  "main": "serveur.js",
  "scripts": {
    "start": "node serveur.js"
  },
  "dependencies": {
    "express": "^5.1.0"
  }
}

Créez maintenant serveur.js. L’appel à require importe Express, puis l’application est créée avec express(). Le port vient de la variable d’environnement PORT lorsqu’elle est définie ; sinon, le serveur utilise le port 3000.

const express = require('express');

const app = express();
const port = process.env.PORT || 3000;

app.get('/controle', (req, res) => {
  res.status(200).json({
    message: 'Le serveur Express répond.'
  });
});

app.listen(port, () => {
  console.log(`Serveur démarré sur le port ${port}`);
});

Démarrer et vérifier le serveur

Lancez le serveur depuis le dossier du projet. Le message affiché confirme que Node.js exécute le fichier et qu’Express écoute sur le port choisi. Gardez ce terminal ouvert pendant le test.

npm start

Serveur démarré sur le port 3000

Dans un autre terminal, interrogez la route avec curl. L’option -i affiche également les en-têtes HTTP : vous pouvez ainsi constater que le serveur a répondu avec le statut 200 et un contenu JSON. Le résultat confirme le fonctionnement du serveur, sans nécessiter de navigateur ni de front applicatif.

curl -i http://localhost:3000/controle

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{"message":"Le serveur Express répond."}

Si le port 3000 est déjà utilisé, indiquez-en un autre au démarrage. Par exemple, PORT=4000 npm start fonctionne dans un terminal Unix ; sous Windows, définissez la variable d’environnement avec la commande adaptée à votre terminal. Si aucune réponse n’arrive, vérifiez que le processus est toujours actif et que l’URL utilise bien le même port.

À retenir

• Initialisez le projet avec npm et installez Express comme dépendance.
• Créez l’application avec express() et démarrez-la avec app.listen.
• Choisissez le port depuis PORT, avec une valeur par défaut pour le développement local.
• Vérifiez la réponse du serveur en envoyant une requête HTTP à la route temporaire de contrôle.

Dans la suite, vous définirez les ressources de commandes et de produits ainsi que les requêtes qu’elles acceptent.