Le web, c'est une longue conversation de requêtes et de réponses. Apprenons sa langue.
⏱️ Durée : environ 85 minutes · 🎓 Niveau : intermédiaire · 🏅 Badge : Facteur du web
🎬 L'histoire
Kodi ouvre les outils de développement du navigateur et voit défiler des dizaines de lignes : GET, POST, 200, 404, 301. Il demande : « Que se passe-t-il quand je clique sur un lien ? »
« Ton navigateur envoie une demande textuelle à un serveur, qui répond par un autre texte, dit Sam. Ça ressemble à une conversation de bureau : poli, structuré, avec des codes pour dire si ça s'est bien passé. »
Tu apprends à lire, écrire et concevoir des échanges HTTP, et à bâtir une petite API.
🎯 Ta mission
À la fin, je serai capable de :
- décrire la structure d'une requête et d'une réponse HTTP
- utiliser correctement les méthodes (GET, POST, PUT, DELETE) et savoir ce qu'est l'idempotence
- interpréter les familles de codes de statut (2xx, 3xx, 4xx, 5xx)
- construire une petite API JSON avec
http.serveret l'interroger avecurllib - expliquer l'absence d'état de HTTP, les cookies et le cache
🧩 Défi d'échauffement (5 XP)
Tu commandes dans un restaurant par écrit. Tu remets un papier avec : ce que tu veux faire (consulter la carte, commander, annuler), quelle table, et des précisions (sans oignon). Le serveur répond avec un papier : un code (« ok », « plat épuisé », « vous n'avez pas le droit »), des précisions, et le plat. Écris la structure de ces deux papiers.
💡 Le concept
HTTP, le protocole du web
HTTP (HyperText Transfer Protocol) est un protocole d'application de type requête-réponse, au-dessus de TCP (et de TLS pour HTTPS). Le client envoie une requête, le serveur renvoie une réponse.
Une requête
GET /cours/hef-000?langue=fr HTTP/1.1
Host: hashbox.example
Accept: application/json
Authorization: Bearer abc123
- Méthode : ce qu'on veut faire.
- Chemin (et paramètres) : sur quelle ressource.
- En-têtes : informations complémentaires.
- Corps (facultatif) : les données envoyées (pour
POST,PUT).
Une réponse
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 41
{"id": "HEF-000", "titre": "Mentalité"}
- Ligne de statut : version, code, texte.
- En-têtes, ligne vide, puis corps.
Les méthodes
| Méthode | Sens | Sûre ? | Idempotente ? |
|---|---|---|---|
| GET | lire | oui | oui |
| POST | créer / déclencher | non | non |
| PUT | remplacer entièrement | non | oui |
| PATCH | modifier en partie | non | pas forcément |
| DELETE | supprimer | non | oui |
- Sûre : ne modifie rien sur le serveur.
- Idempotente : l'appliquer 1 fois ou 10 fois donne le même résultat. Important quand un client réessaie après une erreur réseau : refaire un
PUTest inoffensif, refaire unPOSTpeut créer un doublon.
Les codes de statut
| Famille | Sens | Exemples |
|---|---|---|
| 1xx | information | 101 Switching Protocols |
| 2xx | succès | 200 OK, 201 Created, 204 No Content |
| 3xx | redirection | 301 Moved Permanently, 304 Not Modified |
| 4xx | erreur du client | 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests |
| 5xx | erreur du serveur | 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable |
Règle : 4xx = « tu as mal demandé », 5xx = « j'ai mal répondu ».
HTTP n'a pas de mémoire
Chaque requête est indépendante : le serveur ne se souvient pas de la précédente (sans état). Pour garder un contexte (utilisateur connecté), on utilise :
- des cookies (le serveur donne un identifiant que le client renvoie) ;
- des jetons (
Authorization: Bearer …).
Le cache
Des en-têtes (Cache-Control, ETag) permettent de réutiliser une réponse sans la redemander. Le code 304 Not Modified signifie « ta copie est toujours valable ».
Les API REST
Une API (Application Programming Interface) permet à un programme d'en utiliser un autre. Le style REST modélise des ressources avec des URL et utilise les méthodes HTTP :
| Action | Requête |
|---|---|
| Lister les cours | GET /cours |
| Lire un cours | GET /cours/HEF-000 |
| Créer un cours | POST /cours |
| Remplacer un cours | PUT /cours/HEF-000 |
| Supprimer un cours | DELETE /cours/HEF-000 |
Les données circulent souvent en JSON.
HTTP/1.1, 2, 3
HTTP/2 et HTTP/3 changent la façon de transporter (multiplexage, QUIC sur UDP) mais gardent la même sémantique : méthodes, codes, en-têtes.
🔍 Exemple pas à pas
Problème : écrire un mini serveur d'API JSON pour des cours, et l'interroger.
import json, threading, urllib.request, urllib.error
from http.server import BaseHTTPRequestHandler, HTTPServer
COURS = {"HEF-000": {"titre": "Mentalité d'ingénieur"}, "HEF-010": {"titre": "Algorithmes"}}
class Gestionnaire(BaseHTTPRequestHandler):
def _repondre(self, code, donnees=None):
corps = json.dumps(donnees).encode() if donnees is not None else b""
self.send_response(code)
self.send_header("Content-Type", "application/json")
self.send_header("Content-Length", str(len(corps)))
self.end_headers()
self.wfile.write(corps)
def do_GET(self):
if self.path == "/cours":
self._repondre(200, sorted(COURS))
elif self.path.startswith("/cours/") and self.path[:] COURS:
._repondre(, COURS[.path[:]])
:
._repondre(, {: })
():
longueur = (.headers.get(, ))
:
donnees = json.loads(.rfile.read(longueur))
COURS[donnees[]] = {: donnees[]}
(ValueError, KeyError):
._repondre(, {: })
._repondre(, {: donnees[]})
():
serveur = HTTPServer((, ), Gestionnaire)
port = serveur.server_address[]
threading.Thread(target=serveur.serve_forever, daemon=).start()
base =
():
corps = json.dumps(donnees).encode() donnees
requete = urllib.request.Request(base + chemin, data=corps, method=methode,
headers={: })
:
urllib.request.urlopen(requete, timeout=) r:
r.status, json.loads(r.read() )
urllib.error.HTTPError e:
e.code, json.loads(e.read() )
(appeler(, ))
(appeler(, ))
(appeler(, ))
(appeler(, , {: , : }))
(appeler(, , {: }))
serveur.shutdown()
Lecture : le serveur choisit le code de statut selon la situation (404 introuvable, 201 créé, 400 requête invalide). Le client lit le code avant le corps : c'est ce qui permet de gérer les erreurs proprement.
✍️ À toi, avec aide (10 XP)
Pour chaque situation, choisis la méthode et le code de statut les plus adaptés :
| Situation | Méthode | Code |
|---|---|---|
| Lire la liste des membres | ? | ? |
| Un membre s'inscrit (création) | ? | ? |
| Un membre demande une page qui n'existe pas | ? | ? |
| Un membre non connecté demande son profil | ? | ? |
| Le serveur de base de données est en panne | ? | ? |
| Un membre envoie un JSON mal formé | ? | ? |
💡 Indice 1
401 = non authentifié ; 403 = authentifié mais pas autorisé.
💡 Indice 2
La création réussie renvoie souvent 201.
💡 Indice 3
Une panne côté serveur est une erreur 5xx.
✅ Réponse
| Situation | Méthode | Code |
|---|---|---|
| Lire la liste des membres | GET | 200 |
| S'inscrire | POST | 201 |
| Page inexistante | GET | 404 |
| Profil sans être connecté | GET | 401 |
| Base de données en panne | (toute) | 500 ou 503 |
| JSON mal formé | POST | 400 |
🚀 À toi, en solo (20 XP)
Idempotence et réessai. Étends le serveur de l'exemple avec PUT /cours/<id> (remplace le cours) et DELETE /cours/<id>.
- Écris un client
appeler_avec_reessai(methode, chemin, donnees, essais=3)qui réessaie en cas d'erreur 503 ou de coupure. - Simule un serveur instable qui renvoie 503 une fois sur deux.
- Montre qu'un
PUTréessayé donne le bon résultat final, alors qu'unPOSTréessayé peut créer des doublons (ajoutePOST /commandesqui génère un numéro). - Propose une clé d'idempotence (en-tête
Idempotency-Key) pour sécuriser lePOST.
✅ Pistes de correction
import json, threading, urllib.request, urllib.error
from http.server import BaseHTTPRequestHandler, HTTPServer
etat = {"cours": {}, "commandes": [], "requetes": 0, "cles": {}}
class H(BaseHTTPRequestHandler):
def _r(self, code, donnees=None):
corps = json.dumps(donnees).encode() if donnees is not None else b""
self.send_response(code); self.send_header("Content-Length", str(len(corps))); self.end_headers()
self.wfile.write(corps)
def _instable(self):
etat["requetes"] += 1
if etat["requetes"] % 2 == 1:
self._r(503, {"erreur": "indisponible"})
return True
return
():
n = (.headers.get(, )); donnees = json.loads(.rfile.read(n))
._instable():
etat[][.path.split()[-]] = donnees
._r(, donnees)
():
n = (.headers.get(, )); .rfile.read(n)
cle = .headers.get()
._instable():
cle cle etat[]:
._r(, etat[][cle])
numero = (etat[]) +
etat[].append(numero)
cle: etat[][cle] = {: numero}
._r(, {: numero})
():
serveur = HTTPServer((, ), H)
port = serveur.server_address[]
threading.Thread(target=serveur.serve_forever, daemon=).start()
():
_ (essais):
req = urllib.request.Request(, data=json.dumps(donnees).encode(),
method=methode, headers=entetes {})
:
urllib.request.urlopen(req, timeout=) r:
r.status
urllib.error.HTTPError e:
e.code != :
e.code
(appeler(, , {: }), etat[])
etat[] =
appeler(, , {}); appeler(, , {})
(, etat[])
etat.update(commandes=[], cles={}, requetes=)
_ ():
appeler(, , {}, {: }, essais=)
(, etat[])
serveur.shutdown()
⚠️ Pièges classiques
| Piège | Pourquoi c'est un problème | Comment l'éviter |
|---|---|---|
POST réessayé aveuglément | Doublons (double paiement) | Clé d'idempotence ou PUT |
| Confondre 401 et 403 | Mauvais message à l'utilisateur | 401 : qui es-tu ? 403 : tu n'as pas le droit |
| Tout renvoyer en 200 | Les clients ne détectent pas les erreurs | Utiliser les codes de statut |
| Mettre des secrets dans l'URL | Journaux et historique les conservent | En-têtes ou corps, jamais l'URL |
🐉 Mini-boss (40 XP)
Mini API de tâches. Conçois et implémente (avec http.server) une API REST pour une liste de tâches :
GET /taches(avec filtre?fait=true),GET /taches/<id>;POST /taches(crée, 201 + en-têteLocation) ;PUT /taches/<id>(remplace),PATCH /taches/<id>(modifie un champ),DELETE /taches/<id>(204).
Exigences : JSON valide, codes de statut corrects (400, 404, 405 pour une méthode non supportée), messages d'erreur clairs. Écris une suite de tests avec urllib qui vérifie chaque route, y compris les cas d'erreur.
✅ Pistes de correction
Un bon travail : un dictionnaire de tâches et un compteur d'identifiants ; un routage par expression régulière sur le chemin ; une fonction _repondre(code, donnees, entetes) ; Location: /taches/<id> sur les créations ; 204 sans corps pour DELETE ; 405 avec en-tête Allow quand la méthode ne convient pas ; 400 quand le JSON est invalide ou qu'un champ obligatoire manque ; 404 pour une tâche inconnue. Les tests couvrent : liste vide, création, lecture, remplacement, modification partielle, suppression, deuxième suppression (404), JSON invalide (400), méthode inconnue (405).
⚡ Quiz éclair (15 XP si 4/5 ou plus)
1. Un code 404 signifie :
- A. la ressource demandée est introuvable
- B. une erreur du serveur
- C. une redirection
2. Une méthode idempotente :
- A. est toujours sûre
- B. donne le même résultat si on la répète
- C. ne renvoie jamais de corps
3. HTTP est dit « sans état » car :
- A. il ne stocke aucun fichier
- B. il n'utilise pas TCP
- C. le serveur ne se souvient pas des requêtes précédentes
4. 🔁 Révision mission 06 : Un enregistrement MX indique :
- A. le serveur de mail d'un domaine
- B. l'adresse IPv6
- C. un alias
5. 🔁 Révision mission 06 : Le TTL d'une réponse DNS détermine :
- A. la vitesse de réponse
- B. combien de temps elle peut être gardée en cache
- C. la taille du paquet
✅ Réponses
- A.
- B.
- C.
- A.
- B.
🪞 Je réfléchis (10 XP)
- Quand tu relances une action (clic sur « payer »), qu'est-ce qui te protège d'un doublon ?
- Pourquoi les codes de statut sont-ils un contrat utile entre client et serveur ?
🎒 À retenir
- Requête : méthode, chemin, en-têtes, corps. Réponse : code, en-têtes, corps.
- GET lit ; POST crée ; PUT remplace ; DELETE supprime.
- 2xx succès, 3xx redirection, 4xx erreur client, 5xx erreur serveur.
- Idempotence : essentielle pour réessayer.
- HTTP est sans état : cookies et jetons portent le contexte.
flowchart LR
T(["HTTP et les API"])
T --> R1["1. Requête : méthode, chemin, en-têtes, corps. Réponse : code, en-têtes,…"]
T --> R2["2. GET lit ; POST crée ; PUT remplace ; DELETE supprime."]
T --> R3["3. 2xx succès, 3xx redirection, 4xx erreur client, 5xx erreur serveur."]
T --> R4["4. Idempotence : essentielle pour réessayer."]
T --> R5["5. HTTP est sans état : cookies et jetons portent le contexte."]
Description du schéma : la mission au centre, reliée aux cinq idées à retenir.
🏅 Récompenses
Total possible : 100 XP · 🏅 Badge Facteur du web
← Mission 06 — DNS : l'annuaire d'internet · Mission 08 — TLS et HTTPS : la confiance →
HEF-060 — Réseaux

