Chapitre 10 : Créer une API REST de base avec NodeJS et ExpressJS
NodeJS, associé à ExpressJS, fournit une plate-forme robuste pour créer des API RESTful. Dans ce chapitre, nous aborderons les étapes requises pour créer une API de base à partir de zéro.
1. Installation de NodeJS et ExpressJS
Pour commencer, nous devons avoir NodeJS installé sur notre système. NodeJS est une plateforme de développement d'applications JavaScript qui permet l'exécution de code JavaScript côté serveur. Pour installer NodeJS, vous pouvez télécharger le programme d'installation depuis le site officiel de NodeJS.
Après avoir installé NodeJS, nous devons installer ExpressJS. Express est un framework d'applications Web Node.js minimal et flexible qui fournit un ensemble robuste de fonctionnalités pour les applications Web et mobiles. Pour installer Express, vous pouvez utiliser npm (Node Package Manager), qui est automatiquement installé avec NodeJS. Pour installer Express, ouvrez le terminal et tapez la commande suivante : npm install express
2. Créer la structure de base du projet
Après avoir installé NodeJS et Express, l'étape suivante consiste à créer la structure de base de notre projet. Commencez par créer un nouveau dossier pour le projet, puis lancez npm pour créer un nouveau fichier package.json. Le fichier package.json contient toutes les informations sur le projet, y compris les dépendances du projet.
Pour initialiser npm, ouvrez le terminal, accédez au dossier du projet et tapez la commande suivante : npm init. Suivez les instructions à l'écran pour créer le fichier package.json.
3. Création du serveur
Une fois la structure de base du projet en place, nous pouvons maintenant créer notre serveur. Pour cela, nous devons créer un nouveau fichier appelé server.js à la racine de notre projet. Dans ce fichier, nous allons importer Express et créer une nouvelle instance d'Express.
Ensuite, définissons le port sur lequel notre serveur écoutera. Pour cela, nous pouvons utiliser la méthode d'écoute d'Express. Enfin, ajoutons un middleware pour gérer les requêtes HTTP. Le middleware est une fonction qui a accès à l'objet de requête (req), à l'objet de réponse (res) et au middleware suivant dans la pile d'application.
4. Créer les itinéraires
Une fois le serveur créé, l'étape suivante consiste à créer les routes pour notre API. Les routes définissent nos points de terminaison API, c'est-à-dire les points d'accès que nos clients API peuvent utiliser pour interagir avec notre API.
Pour créer les routes, nous utiliserons la méthode Router d'Express. Router est un middleware qui vous permet de définir plusieurs routes en un seul endroit. Pour chaque route, nous pouvons définir la méthode HTTP à laquelle elle répondra (GET, POST, PUT, DELETE, etc.) et la fonction qui sera exécutée lors de l'accès à la route.
5. Tester l'API
Après avoir créé les routes, nous pouvons tester notre API. Pour cela, on peut utiliser des outils comme Postman ou Curl. Ces outils vous permettent d'envoyer des requêtes HTTP à notre API et de voir la réponse qu'elle renvoie.
Pour tester l'API, démarrez simplement le serveur (à l'aide de la commande node server.js dans le terminal) puis envoyez une requête à la route que vous souhaitez tester. Si tout fonctionne correctement, vous devriez voir la réponse de votre API dans l'outil que vous utilisez pour tester.
En résumé, créer une API REST de base avec NodeJS et ExpressJS implique d'installer NodeJS et Express, de créer la structure de base du projet, de créer le serveur, de définir les routes et de tester l'API. Bien qu'il s'agisse d'un processus basique, il constitue une base solide pour créer des API plus complexes et plus puissantes.
