Sommaire
Comment créer une API RESTful avec Express et MongoDB
Dans le monde du développement web, la création d’API (Application Programming Interface) est devenue essentielle pour permettre la communication entre différentes applications. Les API RESTful, en particulier, sont largement utilisées en raison de leur simplicité et de leur efficacité. Dans cet article, nous allons explorer comment créer une API RESTful en utilisant Express, un framework Node.js, et MongoDB, une base de données NoSQL.
Prérequis
Avant de commencer, assurez-vous d’avoir installé Node.js et MongoDB sur votre machine. Vous aurez également besoin de quelques outils comme npm (Node Package Manager) pour gérer les dépendances de votre projet.
Étape 1 : Initialiser le projet
Pour commencer, créez un nouveau dossier pour votre projet et initialisez-le avec npm :
mkdir mon-api
cd mon-api
npm init -y
Cette commande crée un fichier package.json
qui contiendra les informations sur votre projet.
Étape 2 : Installer les dépendances
Installez Express et Mongoose (un ODM pour MongoDB) en exécutant la commande suivante :
npm install express mongoose
Étape 3 : Créer le serveur Express
Créez un fichier server.js
et ajoutez le code suivant :
const express = require('express');
const mongoose = require('mongoose');
const app = express();
app.use(express.json());
mongoose.connect('mongodb://localhost:27017/mon-api', { useNewUrlParser: true, useUnifiedTopology: true })
.then(() => console.log('Connecté à MongoDB'))
.catch(err => console.error('Erreur de connexion à MongoDB', err));
app.listen(3000, () => {
console.log('Serveur en cours d'exécution sur le port 3000');
});
Ce code initialise un serveur Express et se connecte à une base de données MongoDB locale.
Étape 4 : Créer un modèle Mongoose
Pour interagir avec MongoDB, vous devez définir un modèle. Créez un dossier models
et un fichier utilisateur.js
à l’intérieur :
const mongoose = require('mongoose');
const utilisateurSchema = new mongoose.Schema({
nom: { type: String, required: true },
email: { type: String, required: true, unique: true }
});
module.exports = mongoose.model('Utilisateur', utilisateurSchema);
Étape 5 : Créer les routes de l’API
Ajoutez des routes pour gérer les utilisateurs.
. Dans server.js
, ajoutez le code suivant :
const Utilisateur = require('./models/utilisateur');
app.post('/utilisateurs', async (req, res) => {
const utilisateur = new Utilisateur(req.body);
try {
await utilisateur.save();
res.status(201).send(utilisateur);
} catch (error) {
res.status(400).send(error);
}
});
app.get('/utilisateurs', async (req, res) => {
const utilisateurs = await Utilisateur.find();
res.send(utilisateurs);
});
Conclusion
Vous avez maintenant une API RESTful de base fonctionnant avec Express et MongoDB. Bien sûr, il existe de nombreuses autres fonctionnalités que vous pouvez ajouter, comme l’authentification, la validation des données et la gestion des erreurs. Cependant, ce guide vous donne une bonne base pour commencer à développer vos propres applications web. N’hésitez pas à explorer davantage et à enrichir votre API avec des fonctionnalités avancées !