Requête/Réponse, Méthodes, Codes, Headers et Body
Utilisez les flèches, cliquez ou glissez pour naviguer
1. Modèle requête/réponse
Comprendre le cycle HTTP
2. Méthodes HTTP
GET, POST, PUT, DELETE
3. Codes de statut
200, 201, 400, 401, 404, 500
4. Headers et Body
RĂ´le dans la communication
Qu'est-ce que HTTP ?
Analogie du restaurant — tu commandes, on t'apporte
Les 4 méthodes HTTP
GET, POST, PUT, DELETE = CRUD
Les 6 codes de statut essentiels
200, 201, 400, 401, 404, 500
Headers et Body
Content-Type, Authorization, données JSON
🍽️ Tu commandes
Tu regardes le menu, tu choisis, tu appelles le serveur
→ C'est la requête HTTP
👨‍🍳 On t'apporte
Le cuisinier prépare, le serveur t'apporte le plat
→ C'est la réponse HTTP
// RequĂŞte HTTP
GET /menu/plats HTTP/1.1
Host: restaurant.local
---
// Réponse HTTP
HTTP/1.1 200 OK
Content-Type: application/json
{ "plat": "Pizza", "prix": 12 }
C'est TOUJOURS ce schéma pour chaque interaction web
📤
RequĂŞte
Client → Serveur
⚙️
Traitement
Par le serveur
📥
Réponse
Serveur → Client
1 requête → 1 réponse. Toujours. Dans cet ordre.
L'action que l'on veut effectuer
GET · POST · PUT · DELETE
= CRUD (Create, Read, Update, Delete)
Récupérer une ressource sans la modifier
// Récupérer la liste des utilisateurs
GET /api/utilisateurs HTTP/1.1
Host: monapi.local
âś… Utilisations
❌ Pas de body
GET n'envoie jamais de body. Les paramètres passent dans l'URL.
Créer une nouvelle ressource sur le serveur
// Créer un nouvel utilisateur
POST /api/utilisateurs HTTP/1.1
Content-Type: application/json
{
"nom": "Jean Dupont",
"email": "jean@exemple.fr"
}
💡 POST envoie les données dans le body de la requête
Mettre Ă jour une ressource existante
// Modifier l'utilisateur #42
PUT /api/utilisateurs/42 HTTP/1.1
Content-Type: application/json
{
"nom": "Jean Martin",
"email": "jean.martin@exemple.fr"
}
đź’ˇ PUT remplace toute la ressource. On envoie l'objet complet.
Supprimer une ressource existante
// Supprimer l'utilisateur #42
DELETE /api/utilisateurs/42 HTTP/1.1
Host: monapi.local
⚠️ La suppression est permanente (sauf si l'API implémente une corbeille)
Le lien est direct
Create
POST /ressources
Créer une nouvelle entrée
Read
GET /ressources
Lire des données
Update
PUT /ressources/42
Modifier une entrée
Delete
DELETE /ressources/42
Supprimer une entrée
Le serveur répond avec un code à 3 chiffres
2xx
Succès
4xx
Erreur client
5xx
Erreur serveur
200
OK
Tout s'est bien passé
// GET réussi
HTTP/1.1 200 OK
Content-Type: application/json
[{ "id": 1, "nom": "Jean" }]
201
Created
Ressource créée avec succès
// POST réussi
HTTP/1.1 201 Created
Content-Type: application/json
{ "id": 42, "nom": "Jean" }
💡 200 = GET réussi | 201 = POST/PUT réussi (création)
400
Bad Request
La requĂŞte est invalide
// Champ manquant
HTTP/1.1 400 Bad Request
{ "erreur": "email requis" }
401
Unauthorized
Authentification requise
// Token manquant
HTTP/1.1 401 Unauthorized
{ "erreur": "connexion requise" }
404
Not Found
Ressource inexistante
// URL erronée
HTTP/1.1 404 Not Found
{ "erreur": "utilisateur inconnu" }
🎯 À retenir : 400 = requête invalide · 401 = pas connecté · 404 = introuvable
500
Internal Server Error
Quelque chose s'est mal passé côté serveur
// Exemple : le serveur plante
HTTP/1.1 500 Internal Server Error
Content-Type: application/json
{ "erreur": "Erreur interne du serveur" }
⚠️ Les erreurs 5xx sont NOTRE faute (développeurs), pas celle du client
200
OK
Succès
201
Created
Création
400
Bad Request
RequĂŞte invalide
401
Unauthorized
Non connecté
404
Not Found
Introuvable
500
Server Error
Erreur serveur
Les métadonnées de la communication
Des paires Clé: Valeur
Elles donnent des instructions au client ou au serveur
Indique le format des données envoyées
Content-Type: application/json
Le standard pour les APIs modernes
POST
/api/utilisateurs HTTP/1.1
Content-Type: application/json
Authorization: Bearer token123
{
"nom": "Jean"
}
âś… application/json
Données JSON — le choix #1 des APIs
📝 Autres formats
text/html, multipart/form-data, application/xml
Prouver qui l'on est
Authorization: Bearer <token>
Le standard des APIs modernes (JWT)
// RequĂŞte avec authentification
GET /api/profil HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
✅ Sans token → 401
L'accès est refusé
✅ Avec token → 200
Les données sont retournées
📤 Body de la requête
Données envoyées par le client
POST et PUT uniquement
// Création d'un article
{ "titre": "Mon article", "contenu": "..." }
📥 Body de la réponse
Données retournées par le serveur
Toutes les réponses (succès ou erreur)
// Résultat de la création
{ "id": 42, "titre": "Mon article" }
💡 Toujours en JSON pour les APIs modernes — facile à lire, léger, universel
POST
/api/articles HTTP/1.1
--- Ligne de requête (méthode + chemin + version)
Content-Type: application/json
Authorization: Bearer token123
--- Headers (métadonnées)
{
"titre": "Mon article",
"contenu": "Hello World"
}
--- Body (données)
❌ Confusion GET vs POST
GET sert à lire, POST à créer. GET n'a pas de body !
❌ Confusion 400 vs 404
400 = requĂŞte invalide (champ manquant, format incorrect)
404 = ressource inexistante (mauvaise URL)
❌ Les codes 5xx sont des erreurs serveur
500 = notre faute (développeurs), pas celle du client
đź’ˇ Rappel : Content-Type doit correspondre au format du body
Si tu envoies du JSON, mets Content-Type: application/json
HTTP = requête puis réponse. Toujours.
Pour chaque interaction web, c'est ce schéma immuable
GET = Lire
POST = Créer
PUT = Modifier
DELETE = Supprimer
Content-Type: application/json — le standard API
Headers = métadonnées · Body = données (POST/PUT)
GET / POST
Lire / Créer
GET n'a pas de body
PUT / DELETE
Modifier / Supprimer
PUT envoie l'objet complet
200 · 201
OK · Created
400 · 401 · 404 · 500
Les 4 erreurs essentielles
📦 Body = JSON · 📋 Headers = Content-Type & Authorization
1. Identifie la méthode
"Afficher la liste des articles" → GET ou POST ?
2. Quel code de statut ?
L'utilisateur n'est pas connecté → 401, 404 ou 500 ?
3. Complète la requête
Ajoute le bon header pour envoyer du JSON : ___ : ___
4. Choisis la méthode
"Mettre à jour le profil utilisateur" → PUT ou DELETE ?
HTTP est le langage du web
Maîtrisez HTTP, maîtrisez le web !
Requête → Réponse, toujours.