Plongeons plus profondément dans ce qu'est une API REST et comment elle fonctionne, puisque nous sommes sur le point de la construire. Comprendre ces concepts fondamentaux posera une base solide pour le reste de notre projet.

Plan

• 🤔 Qu'est-ce qu'une API REST ?
• 🔍 Principes clés de REST ;
• 🤷‍♂️ Comment fonctionnent les API REST.

🤔 Qu'est-ce qu'une API REST ?

REST, ou Representational State Transfer, est un style architectural pour concevoir des applications en réseau. Les API REST sont un ensemble de règles pour créer et interagir avec des services web, facilitant l'échange de données et les opérations fluides entre les systèmes logiciels.

🔍 Principes Clés de REST

Pour saisir l'essence des API REST, il est essentiel de se rappeler ces principes fondamentaux :

• Sans état : Dans REST, chaque interaction client-serveur est autonome. Toutes les informations nécessaires doivent être incluses dans la requête elle-même ;
• Centré sur les ressources : REST traite tout comme une ressource, identifiant chaque ressource de manière unique par un URI (Identifiant Uniforme de Ressource). Ces ressources interagissent via des méthodes HTTP standard comme GET, POST, PUT et DELETE ;
• Représentation : Les ressources dans REST peuvent avoir plusieurs représentations, telles que JSON ou XML. Cette flexibilité permet aux clients de choisir leur format préféré pour l'échange de données.

🤷‍♂️ Comment Fonctionnent les API REST

Examinons maintenant de plus près comment fonctionnent les API REST. Le processus implique plusieurs étapes clés :

1. Requête : Les clients initient des requêtes en fournissant tous les détails nécessaires dans chaque requête. Cela inclut la méthode HTTP, l'URI et les paramètres ou données requis ;
2. Ressource : L'API traite la requête en fonction de l'URI unique de la ressource. Cet URI sert d'adresse pour la ressource demandée ;
3. Méthodes HTTP : Les méthodes HTTP standard déterminent le type d'opération à effectuer. Par exemple, GET est utilisé pour la récupération, POST pour la création, PUT pour la mise à jour et DELETE pour la suppression ;
4. Réponse : Après le traitement de la requête, le serveur envoie une réponse dans le format de représentation choisi, généralement JSON ou XML. Cette réponse contient les données demandées ou la confirmation de l'action effectuée ;
5. Sans état : Les interactions REST sont conçues pour être sans état, ce qui signifie qu'aucune donnée de session n'est stockée entre les requêtes. Chaque requête est indépendante et autonome.