Le Protocole HTTP

Requête/Réponse, Méthodes, Codes, Headers et Body

Utilisez les flèches, cliquez ou glissez pour naviguer

Objectifs de la leçon

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

Plan du cours

1

Qu'est-ce que HTTP ?

Analogie du restaurant — tu commandes, on t'apporte

2

Les 4 méthodes HTTP

GET, POST, PUT, DELETE = CRUD

3

Les 6 codes de statut essentiels

200, 201, 400, 401, 404, 500

4

Headers et Body

Content-Type, Authorization, données JSON

HTTP : l'analogie du restaurant

🍽️ 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 }

Le cycle Requête → Réponse

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.

Les 4 Méthodes HTTP

L'action que l'on veut effectuer

GET · POST · PUT · DELETE

= CRUD (Create, Read, Update, Delete)

GET — Lire des données

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

  • Charger une page web
  • Lister des articles
  • Rechercher

❌ Pas de body

GET n'envoie jamais de body. Les paramètres passent dans l'URL.

POST — Créer des données

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

PUT — Modifier des données

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.

DELETE — Supprimer des données

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)

CRUD ↔ Méthodes HTTP

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

Les Codes de Statut HTTP

Le serveur répond avec un code à 3 chiffres

2xx

Succès

4xx

Erreur client

5xx

Erreur serveur

Codes de succès : 200 et 201

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)

Codes d'erreur client : 400, 401, 404

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

Code d'erreur serveur : 500

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

Les 6 codes à connaître par ❤️

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 Headers HTTP

Les métadonnées de la communication

Des paires Clé: Valeur

Elles donnent des instructions au client ou au serveur

Header : Content-Type

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

Header : Authorization

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

Le Body : les donné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

Anatomie d'une requête HTTP complète

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)

Pièges courants à éviter

❌ 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

Points clés à retenir

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)

Récapitulatif

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

Exercices pratiques

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 ?

Questions ?

HTTP est le langage du web

Maîtrisez HTTP, maîtrisez le web !

Requête → Réponse, toujours.