🛠️ Créer une API avec Node.js et Express – Guide simple pour débutants

Créer une API (Application Programming Interface) est devenu une compétence essentielle pour tout développeur web. Une API permet à différentes applications de communiquer entre elles. Dans cet article, tu vas apprendre à créer une API simple avec Node.js et Express.

---

🔍 Qu’est-ce qu’une API ?

Une API est un ensemble de règles permettant à un programme d’accéder aux fonctionnalités ou aux données d’un autre.

Par exemple :

• Une app météo utilise une API pour récupérer la température
• Une app mobile utilise une API pour charger un profil utilisateur

---

🧰 Technologies utilisées

• Node.js
• Express.js
• Postman ou curl (pour tester l’API)

---

🚀 Étapes pour créer une API simple

1. Installer Node.js

Téléchargez Node.js ici 👉 https://nodejs.org

---

2. Créer un nouveau projet

mkdir mon-api
cd mon-api
npm init -y

---

3. Installer Express

npm install express

---

4. Créer le fichier index.js

const express = require('express');
const app = express();
const port = 3000;

app.use(express.json());

// Route racine
app.get('/', (req, res) => {
  res.send('Bienvenue sur mon API !');
});

// Liste des utilisateurs
app.get('/users', (req, res) => {
  res.json([
    { id: 1, nom: 'Alice' },
    { id: 2, nom: 'Bob' }
  ]);
});

// Ajouter un utilisateur
app.post('/users', (req, res) => {
  const nouvelUtilisateur = req.body;
  res.status(201).json({
    message: 'Utilisateur ajouté',
    utilisateur: nouvelUtilisateur
  });
});

// Lancement du serveur
app.listen(port, () => {
  console.log(`API en cours sur http://localhost:${port}`);
});

---

5. Lancer le serveur

node index.js

---

🧪 Tester l’API

Utilise Postman (ou curl en ligne de commande) pour tester les routes :

• GET / → Affiche un message de bienvenue
• GET /users → Renvoie la liste des utilisateurs
• POST /users → Envoie un nouvel utilisateur au format JSON comme ci-dessous :

{
  "id": 3,
  "nom": "Charlie"
}

---

🔁 Les principales méthodes HTTP

Méthode	Description
GET	Lire des données
POST	Créer une nouvelle ressource
PUT	Modifier une ressource
DELETE	Supprimer une ressource

---

✅ Ce que vous avez appris

• Créer un projet Node.js
• Utiliser Express pour créer une API
• Gérer les requêtes GET et POST
• Tester une API avec Postman

---

🚀 Pour aller plus loin

• Connecter l’API à une base de données (MongoDB, PostgreSQL…)
• Ajouter un système d’authentification (ex : JWT)
• Structurer le code avec des routes et des contrôleurs
• Héberger l’API sur Render, Vercel ou Heroku

---

✍️ Conclusion

Créer une API REST avec Node.js et Express est une excellente manière de comprendre les bases du backend web. C’est une compétence incontournable pour les développeurs full-stack.

--