Créer une API REST avec Express 5 et Node.js
API avec Express est un cours de niveau intermédiaire de 5 leçons (environ 3 h 26), avec 15 exercices et 15 questions de quiz. Prérequis : Node.js fondamentaux, HTTP et API REST. Les exercices s'exécutent dans le navigateur, sans installation.
- JavaScript côté serveur
- Intermédiaire
- 5 leçons
- 3 h 26
- 15 exercices
- Exercices exécutés dans le navigateur
Le cours en bref
Ce cours vous apprend à concevoir et coder une API REST professionnelle avec Express 5, le framework web de référence de Node.js. Vous écrirez des routes, comprendrez la chaîne de middlewares, validerez les données entrantes, centraliserez la gestion des erreurs puis structurerez une API CRUD en couches, paginée et testable.
Ce que tu sauras faire
- Créer une application Express 5 et définir des routes lisant params, query et body
- Écrire et ordonner des middlewares d'application, de routeur et de route
- Valider les données entrantes et renvoyer des erreurs de validation exploitables
- Centraliser la gestion des erreurs en tirant parti de la prise en charge des promesses d'Express 5
- Structurer une API REST CRUD en couches, avec pagination et tests
Programme des 5 leçons
- Créer une application Express 5 et définir des routes
- Lire les paramètres de chemin, de requête et le corps d'une requête
- Renvoyer des réponses JSON avec le bon code de statut
- 02
Les middlewares : la chaîne de traitement d'Express
- Expliquer le fonctionnement de la chaîne de middlewares et de next()
- Écrire des middlewares d'application, de routeur et de route
- Ordonner correctement les middlewares (analyse du corps, journalisation, authentification)
- 03
Valider les données entrantes
- Valider le corps, les paramètres et la chaîne de requête d'une requête
- Renvoyer des erreurs de validation claires et exploitables par le client
- Écrire un middleware de validation réutilisable et connaître les bibliothèques de schémas
Validation des entréesErreurs de validationSchémas de données
- 04
Gérer les erreurs avec Express 5
- Centraliser la gestion des erreurs dans un middleware dédié
- Créer des erreurs HTTP métier et les traduire en réponses cohérentes
- Exploiter la prise en charge native des promesses rejetées dans Express 5
- 05
Structurer une API REST CRUD complète
- Concevoir des routes REST cohérentes pour une ressource
- Séparer routes, contrôleurs, services et accès aux données
- Ajouter pagination et filtrage, puis tester l'API
Conception RESTArchitecture en couchesPaginationTests d'API Express
Projet final
API REST de gestion de réservations
Concevez et codez avec Express 5 l'API d'un service de réservation de créneaux (salles de réunion, cours, rendez-vous) : ressources `ressources` et `reservations`, CRUD complet, validation des dates et des chevauchements (409 en cas de conflit), pagination et filtrage par date, authentification par clé API, format d'erreur unique et architecture en couches avec dépôt injectable.
Livrables
- Le code de l'API organisé en app.js, server.js, routes, services et dépôts
- Une documentation des routes (méthodes, paramètres, réponses, codes d'erreur), par exemple en OpenAPI ou dans le README
- Des tests unitaires des middlewares et services, et des tests d'intégration avec supertest
- Une collection de requêtes (curl, HTTPie ou client REST) démontrant chaque cas
Critères d'évaluation
- Les routes respectent les conventions REST et les codes de statut adaptés
- Toutes les entrées sont validées, sans affectation de masse
- Les erreurs suivent un format unique et ne divulguent aucun détail interne
- La logique métier (chevauchements) est isolée dans la couche service et testée
- L'application se teste sans base réelle grâce à l'injection du dépôt
Questions fréquentes
Ce cours utilise-t-il Express 4 ou Express 5 ?
Express 5, la version actuelle installée par défaut. Les différences importantes avec Express 4 sont signalées pour vous aider à maintenir du code existant.
Quels prérequis pour suivre ce cours ?
Les bases de Node.js (cours JS1) et des notions de HTTP et d'API (cours B1) : méthodes, codes de statut et JSON.
Le cours aborde-t-il les bases de données ?
Le cours se concentre sur la couche HTTP et l'architecture. Il utilise un dépôt en mémoire et montre comment le remplacer par un dépôt SQL sans modifier les routes.
Comment tester une API Express ?
En séparant la création de l'application de l'appel à listen, on peut tester les middlewares isolément avec des objets factices et l'API complète avec supertest ou fetch.
Ce cours, raconté pour ton métier
Dis ce que tu veux savoir faire : « API avec Express » prend sa place dans ton parcours, avec des exemples de ton secteur. Les notions restent celles du cours.