API REST et son interaction avec un frontend

Description du schéma

1. Client (Frontend):

   • Représenté par un navigateur web ou une application mobile.
   • Envoie des requêtes HTTP à l'API REST.

2. Requêtes HTTP:

   • Les flèches indiquent les requêtes envoyées par le client au serveur.
   • Les méthodes HTTP (GET, POST, PUT, DELETE) sont utilisées pour interagir avec les ressources.

3. Serveur (API REST):

   • Reçoit les requêtes du client et traite les données.
   • Contient les ressources (par exemple, utilisateurs, produits) et les endpoints pour accéder à ces ressources.

4. Base de données:

   • Le serveur interagit avec une base de données pour stocker et récupérer les données.
   • Les opérations CRUD (Create, Read, Update, Delete) sont effectuées sur la base de données.

5. Réponses HTTP:

   • Les flèches indiquent les réponses envoyées par le serveur au client.
   • Les réponses contiennent généralement des données au format JSON ou XML.

6. Interaction:

   • Le client envoie une requête au serveur pour accéder ou modifier une ressource.
   • Le serveur traite la requête, interagit avec la base de données si nécessaire, et envoie une réponse au client.
   • Le client utilise les données de la réponse pour mettre à jour l'interface utilisateur.

Le client envoie une requête HTTP (GET, POST, PUT, DELETE) à une URL d’API (comme https://api.example.com/resource).

Le serveur traite cette requête et renvoie une réponse au format JSON, contenant des données structurées (par exemple : {"name": "archana", "age": "40"}).

Cela permet aux applications de communiquer facilement entre elles via le web.

Le client envoie une requête HTTP (GET, POST, PUT, DELETE) vers une URL spécifique (ex. /surveys/123) pour accéder à une ressource sur le serveur.
Le serveur traite cette requête et renvoie une réponse au format JSON, contenant les données demandées (ex. un score de sondage).

👉 C’est une méthode simple pour faire communiquer des applications via le web.

Cette image explique le concept de CRUD, qui représente les 4 opérations principales qu'on peut effectuer sur des données via une API :

• C – Create : créer une nouvelle donnée → méthode POST

• R – Read : lire ou récupérer une donnée → méthode GET

• U – Update : modifier une donnée existante → méthode PUT

• D – Delete : supprimer une donnée → méthode DELETE

👉 Ces actions utilisent les méthodes HTTP pour interagir avec un serveur web de manière standardisée. Le CRUD est au cœur de toute API REST.

Méthodes de Requête HTTP

1. GET :

   • Description : Utilisée pour récupérer des données d'une ressource spécifique sur le serveur.
   • Utilisation : Lorsque vous souhaitez obtenir des informations, par exemple, récupérer les détails d'un utilisateur ou d'un produit.

2. POST :

   • Description : Utilisée pour envoyer des données au serveur afin de créer une nouvelle ressource.
   • Utilisation : Lorsque vous souhaitez créer une nouvelle entrée, par exemple, ajouter un nouvel utilisateur ou un nouvel article.

3. PUT :

   • Description : Utilisée pour mettre à jour une ressource existante sur le serveur.
   • Utilisation : Lorsque vous souhaitez mettre à jour des informations existantes, par exemple, modifier les détails d'un utilisateur.

4. DELETE :

   • Description : Utilisée pour supprimer une ressource spécifique sur le serveur.
   • Utilisation : Lorsque vous souhaitez supprimer des informations, par exemple, supprimer un utilisateur ou un article.

Codes de Statut de Réponse HTTP

1. 200 OK :

   • Description : La requête a réussi. La réponse dépend de la méthode HTTP utilisée.
   • Utilisation : Indique que tout s'est bien passé et que la réponse contient les données demandées.

2. 201 Created :

   • Description : La requête a réussi et une nouvelle ressource a été créée.
   • Utilisation : Utilisé principalement après un POST réussi pour indiquer que la ressource a été créée avec succès.

3. 302 Found :

   • Description : La ressource demandée a été trouvée à une URI différente. Utilisé pour la redirection.
   • Utilisation : Indique que la ressource a été temporairement déplacée à une autre URL.

4. 400 Bad Request :

   • Description : La requête envoyée par le client est malformée ou incorrecte.
   • Utilisation : Indique que le serveur ne peut pas traiter la requête en raison d'une erreur client.

5. 404 Not Found :

   • Description : La ressource demandée n'a pas été trouvée sur le serveur.
   • Utilisation : Indique que la ressource spécifiée n'existe pas ou n'est pas disponible.

6. 500 Internal Server Error :

   • Description : Une erreur générique indiquant que le serveur a rencontré une condition inattendue qui l'a empêché de répondre à la requête.
   • Utilisation : Indique une erreur côté serveur, souvent utilisée lorsque le serveur ne peut pas traiter la requête pour une raison inconnue.

Interaction

• Requêtes : Les méthodes HTTP (GET, POST, PUT, DELETE) sont utilisées par le client pour interagir avec le serveur.
• Réponses : Le serveur répond avec des codes de statut HTTP pour indiquer le résultat de la requête.

Ce schéma est utile pour comprendre comment les différentes méthodes de requête HTTP sont utilisées pour interagir avec une API REST et comment les codes de statut HTTP sont utilisés pour indiquer le résultat de ces requêtes.