Informatique · Web et réseaux

HTTP et REST

Ouvrir une page, lancer une appli : ton appareil envoie un petit texte, le serveur répond. Ces règles s'appellent HTTP.

Déjà à l'aise ? Aller au quiz

Le principe

Quand tu ouvres une page, ton navigateur écrit un message au serveur. Celui-ci répond avec un autre message, qui contient la page.

client navigateur serveur site ou API GET /fiches/42 HTTP/1.1 HTTP/1.1 200 OK

Les API REST s'en servent pour que des programmes se parlent.

Après cette fiche, tu sais

  • lire et écrire une requête et une réponse HTTP, ligne par ligne ;
  • choisir la bonne méthode (GET, POST, PUT, PATCH, DELETE) et dire si elle est sûre ou idempotente ;
  • interpréter un code d'état grâce à son premier chiffre, et reconnaître les codes les plus courants ;
  • concevoir les adresses d'une API REST et démonter une URL ;
  • expliquer ce que fait CORS, et ce qu'il ne fait pas.
Une question pour toi : combien de lignes ton navigateur écrit-il dans son message ?

Une seule, peut-être ? Ou plusieurs ?

Garde ta réponse en tête : on la vérifie dans la notion 2, avec un vrai message.

Une question, une réponse

Notion 1 · Le dialogue client-serveur

Une requête, une réponse

HTTP (HyperText Transfer Protocol) fixe la forme et le sens de deux messages : la requête, envoyée par un client, et la réponse, renvoyée par un serveur.

client navigateur, appli serveur site ou API programme, Postman un service requête réponse

Le client peut être un navigateur, une appli mobile, un programme ou Postman ; le serveur, un site web ou une API, un service fait pour être appelé par des programmes.

Sans état : chaque requête HTTP se comprend toute seule, sans dépendre des précédentes.

Requête 1 POST /connexion 200 OK Set-Cookie: session=abc le navigateur garde le cookie et le renvoie Requête 2 GET /profil Cookie: session=abc 200 OK « Bonjour, Zoé »

Pour se souvenir de toi d'une page à l'autre (panier, connexion), un site ajoute un état avec des cookies ou des jetons, envoyés à chaque requête.

HTTP ne transporte rien lui-même : il s'appuie sur TCP (ou sur QUIC pour HTTP/3), et TLS chiffre les échanges en HTTPS. La fiche Réseaux détaille ces couches ; ici, on s'intéresse aux messages.

HTTPS (HTTP/1.1 ou 2) HTTP/3 HTTP : les messages TLS : le chiffrement TCP : connexion fiable HTTP : les messages QUIC : le transport UDP : sans connexion HTTPS : HTTP chiffré par TLS HTTP/3 : au-dessus de QUIC

L'aller-retour

Fais défiler : cinq requêtes partent l'une après l'autre, et chaque réponse revient avec son code d'état. Tu peux aussi toucher une requête pour la revoir.

Scène 1 · L'aller-retour

Chaque requête reçoit une réponse

client navigateur, appli serveur site ou API requête réponse GET 200 GET /users HTTP/1.1 …

requête GET /usersréponse …

Tu as vu ? Le serveur répond toujours, même quand ça rate.

Même quand la page n'existe pas ?

Oui : le 404 est une vraie réponse, avec un code qui dit ce qui s'est passé.

Tout tient dans du texte

Notion 2 · Anatomie d'un message

Quelques lignes de texte

En HTTP/1.1, requête et réponse sont de simples lignes de texte, avec la même structure : une ligne de départ, des en-têtes (une paire Nom: valeur par ligne), une ligne vide, puis un corps facultatif.3

1 · ligne de départ GET /users HTTP/1.1 2 · en-têtes Host: api.example.com Accept: application/json 3 · ligne vide 4 · corps, facultatif absent pour un GET

Les en-têtes décrivent le message : qui le reçoit, dans quel format, de quelle taille.

Le même sens, dans toutes les versions.

HTTP/2 et HTTP/3 emballent ces messages en binaire pour aller plus vite, mais leur sens reste le même : ce que tu lis ici vaut pour toutes les versions.

Une requête, éclatée

Fais défiler : une vraie requête s'éclate en morceaux, puis sa réponse.

REQUÊTE GET /api/fiches/42 HTTP/1.1 méthode cible version Host: api.example.com le site visé, obligatoire en HTTP/1.1 Accept: application/json les formats que le client sait lire ligne vide RÉPONSE (la réponse arrive plus bas) HTTP/1.1 200 OK version code raison Content-Type: application/json le format du corps Content-Length: 32 la taille du corps, en octets {"id":42,"titre":"HTTP et REST"} le corps : la fiche 42, en JSON
Étape 1 sur 7

Voici une vraie requête : trois lignes de texte, puis une ligne vide. Ton navigateur en écrit une à chaque clic.

Étape 2 sur 7 · la ligne de requête

La méthode (GET : lire), la cible (la ressource voulue) et la version du protocole.

Étape 3 sur 7 · les en-têtes

Un par ligne. Host nomme le site visé ; Accept annonce les formats que le client sait lire.

Étape 4 sur 7 · la ligne vide

Elle termine les en-têtes. Un GET n'envoie pas de corps : la requête s'arrête là.

Étape 5 sur 7 · la ligne d'état

La réponse commence par la version, le code d'état (200) et sa raison (OK) : réussite.

Étape 6 sur 7 · les en-têtes de réponse

Ils décrivent le corps : son format (Content-Type) et sa taille en octets (Content-Length : 32).

Étape 7 sur 7 · le corps

Après la ligne vide : la fiche 42 en JSON. C'est une représentation de la ressource, pas la ressource elle-même.

Réponse à ma question : trois lignes et une ligne vide suffisent.

Et les autres en-têtes, alors ?

Un vrai navigateur en ajoute (langue, cookies…), mais la structure ne change jamais.

Attention aux octets

Octets, pas caractères

Content-Length compte des octets. En UTF-8, les lettres accentuées en prennent deux : le corps {"ville":"Genève"} fait 18 caractères, mais 19 octets.

18 caractères { " v i l l e " : " G e n è v e " } 19 octets { " v i l l e " : " G e n è v e " } 2 octets è prend 2 octets en UTF-8.
Exercice · à toi

Remets la requête dans l'ordre

Ton appli veut créer Zoé. Les six lignes de sa requête ont été mélangées : touche une ligne, puis celle avec laquelle l'échanger.

Que demande le client ?

Notion 3 · Les méthodes

Lire, créer, remplacer, modifier, supprimer

La méthode dit ce que le client demande de faire à la ressource. Les cinq qu'on utilise tous les jours correspondent aux opérations CRUD : Create (POST), Read (GET), Update (PUT ou PATCH), Delete (DELETE).

Create créer POST Read lire GET Update modifier PUT PATCH Delete supprimer DELETE CRUD : Create, Read, Update, Delete

Méthode sûre : elle ne demande aucune modification sur le serveur, lecture seule. GET, HEAD et OPTIONS sont sûres.

Méthode idempotente : envoyer la même requête deux, trois ou dix fois a le même effet sur le serveur qu'un seul envoi. PUT, DELETE et toutes les méthodes sûres le sont.

Méthode Sûre Idempotente GET oui oui HEAD oui oui OPTIONS oui oui PUT non oui DELETE non oui POST non non PATCH non non

Pourquoi c'est utile

Si la connexion coupe avant l'arrivée de la réponse, un client peut renvoyer une requête idempotente sans risque. Un POST renvoyé, lui, peut créer une deuxième commande. PATCH n'est pas garanti idempotent : « ajoute 1 au compteur » change l'état à chaque envoi.12

PUT /commandes/7 2 envois 1 commande POST /commandes 2 envois 2 commandes PUT : un seul état. POST : deux commandes.

Trois fois la même requête

Fais défiler : POST, puis PUT, puis DELETE sont envoyés une, deux, trois fois de suite. Surveille la table du serveur, pas seulement les codes.

Scène 2 · Idempotence

Répéter, est-ce recommencer ?

REQUÊTE POST /users {"nom":"Zoé", "role":"élève"} ENVOIS ET CODES n° 1· n° 2· n° 3· SERVEUR · /users id nom rôle 2 utilisateurs

méthode POSTenvois 0utilisateurs 2

Retiens le DELETE.

Le deuxième envoi répond 404, et pourtant DELETE est idempotent. L'idempotence parle de l'effet sur le serveur, pas du code reçu.

Exercice · à toi

Range les sept méthodes

Touche une méthode, puis la case qui lui correspond. Une méthode sûre est toujours aussi idempotente.

Le premier chiffre parle

Notion 4 · Les codes d'état

Trois chiffres, le premier d'abord

Chaque réponse commence par un code à trois chiffres. Le premier chiffre donne la famille : même face à un code inconnu, tu sais déjà de quel côté est le problème.1

1er chiffre 404 les 2e et 3e chiffres précisent le cas 4xx : erreur du client

Les cinq familles

1xx Information 2xx Réussite 3xx Redirection 4xx Erreur du client 5xx Erreur du serveur

1xx : la requête est reçue, le traitement continue.

2xx : réussite. La requête a été reçue, comprise et acceptée.

2xx · réussite 200 OK le résultat 201 Created une ressource créée 204 No Content rien à renvoyer
  • 200 OK : le résultat, par exemple la ressource lue.
  • 201 Created : une ressource a été créée ; son adresse est en général dans l'en-tête Location.
  • 204 No Content : rien à renvoyer, fréquent après un DELETE.

3xx : redirection. Le client doit faire autre chose, par exemple aller à une autre adresse.

3xx · redirection 301 Moved Permanently nouvelle adresse 304 Not Modified cache déjà à jour
  • 301 Moved Permanently : la ressource a une nouvelle adresse définitive.
  • 304 Not Modified : le client a déjà la version à jour dans son cache, inutile de la renvoyer.

4xx : erreur du client. La requête est mal formée, non autorisée ou vise une ressource absente.

4xx · erreur du client 400 Bad Request JSON invalide 404 Not Found aucune ressource 405 Method Not Allowed méthode refusée
  • 400 Bad Request : requête incorrecte, JSON invalide ou champ obligatoire manquant.
  • 404 Not Found : aucune ressource à cette adresse.
  • 405 Method Not Allowed : méthode non permise sur cette ressource ; l'en-tête Allow liste les méthodes permises.

4xx · suite

Conflit et trop de requêtes

4xx · erreur du client 409 Conflict conflit d'état 429 Too Many Requests trop de requêtes
  • 409 Conflict : conflit avec l'état de la ressource, par exemple deux modifications concurrentes.
  • 429 Too Many Requests : trop de requêtes en peu de temps, la limite de débit est dépassée.8

Piège

401 ou 403 ?

Le nom anglais de 401, « Unauthorized », trompe : il s'agit d'authentification (qui es-tu ?). 403 concerne l'autorisation (as-tu le droit ?) : le serveur sait qui tu es, et dit non.

401 Unauthorized Qui es-tu ? identifiants absents ou non valables 403 Forbidden As-tu le droit ? le serveur sait qui tu es, et dit non

5xx : erreur du serveur. La requête semblait correcte, mais le serveur n'a pas pu la traiter.

5xx · erreur du serveur 500 Internal Server Error erreur inattendue 503 Service Unavailable maintenance
  • 500 Internal Server Error : erreur inattendue du serveur, une exception non prévue par exemple.
  • 503 Service Unavailable : service momentanément indisponible, par surcharge ou maintenance.
Exercice · à toi

Quel code d'état ?

Huit situations d'une appli de classe. Choisis le code que le serveur devrait renvoyer.

Des noms, pas des verbes

Notion 5 · REST

Des ressources, des adresses, des méthodes

REST (Representational State Transfer) est un style d'architecture décrit par Roy Fielding dans sa thèse de doctorat, en 2000.5 Ce n'est ni un protocole ni une bibliothèque : ce sont des contraintes. Une API qui les respecte est dite RESTful.

Une ressource est identifiée par une adresse, comme /users/42. On la manipule à travers des représentations, le plus souvent du JSON.

ressource /users/42 l'utilisateur 42 représentation {"id":42, "nom":"Zoé"} client une copie le serveur garde la ressource, le client reçoit une copie

1. Des ressources

Chaque ressource a une adresse : /users pour la collection, /users/42 pour un élément.

2. Des représentations

On manipule une représentation de la ressource, le plus souvent du JSON.

3. Une interface uniforme

Les méthodes HTTP gardent leur sens standard, les codes aussi.

4. Sans état

Chaque requête contient tout ce qu'il faut pour la comprendre, jeton d'authentification compris.

5. Du cache et des couches

Une réponse indique si on peut la garder en cache. Le client ne sait pas s'il parle au serveur final ou à un intermédiaire.

En pratique

Une requête par action

La méthode dit quoi faire, l'adresse dit à quoi.

Requête Action Réponse typique GET /users lister 200 et la liste GET /users/42 lire un élément 200, ou 404 POST /users créer 201 et Location PUT /users/42 remplacer 200 ou 204 PATCH /users/42 modifier une partie 200 ou 204 DELETE /users/42 supprimer 204

Des adresses bien construites

Des noms, pas des verbes : la méthode dit déjà l'action. DELETE /users/42, et non GET /supprimerUser?id=42.

bon DELETE /users/42 un nom : la méthode dit l'action à éviter GET /supprimerUser?id=42 un verbe dans l'adresse

Des collections au pluriel et une hiérarchie quand elle a du sens : /users/42/commandes. Les filtres, le tri et la pagination vont dans la partie requête : /users?role=admin&page=2.

/users /42 /commandes la collection un élément ses commandes /users/42/commandes : les commandes de l'utilisateur 42 /users + ?role=admin + &page=2 le chemin le filtre la page filtres, tri et pagination : dans la partie requête

Une URL démontée

Fais défiler : chaque morceau de l'adresse s'allume, avec ce qu'il devient dans la requête envoyée. Tu peux aussi toucher un morceau.

Scène 3 · Anatomie d'une URL

Le chemin

https:// api.example.com :443 /users/42 ?role=admin #bio schémahôteport cheminrequête (query)fragment CE QUE LE NAVIGATEUR ENVOIE GET /users/42?role=admin HTTP/1.1 Host: api.example.com #bio non envoyé

Jeu · pilote une API

Six missions sur une petite API

Une API de démonstration tourne dans ta page : rien ne part sur Internet. Choisis la méthode, écris le chemin et, si besoin, le corps JSON, puis envoie. La réponse s'affiche comme un vrai message HTTP.

Mission 1 sur 6

Lire la liste

Affiche la liste de tous les utilisateurs.

Requête
Réponse du serveur
(aucune requête envoyée)
Données du serveur
[]

0 mission réussie sur 6

Qui a le droit de lire ?

Notion 6 · En-têtes et CORS

Ce que disent les en-têtes

Les noms d'en-têtes ne tiennent pas compte des majuscules : content-type et Content-Type désignent le même champ.

Six en-têtes à connaître

Content-Type

Le format du corps envoyé : application/json, text/html…

Accept

Les formats que le client sait lire.

Authorization

Les identifiants du client, par exemple Bearer suivi d'un jeton.

Cache-Control

Les règles de mise en cache : max-age=60, no-store.

Location

L'adresse de la ressource créée (201) ou de la redirection (3xx).

Set-Cookie / Cookie

Le serveur dépose un cookie, le navigateur le renvoie ensuite.

Une origine, c'est le trio schéma, hôte et port : https://app.example et https://api.example sont deux origines différentes.

schéma hôte port https app.example 443 https api.example 443 hôte différent même schéma, même port : deux origines

Envoyer n'est pas lire.

Le navigateur applique la politique de même origine : le script d'une page peut envoyer des requêtes vers une autre origine, mais il ne peut pas lire leurs réponses.7

CORS (Cross-Origin Resource Sharing) : un mécanisme fondé sur des en-têtes HTTP, qui permet à un serveur d'indiquer quelles autres origines le navigateur doit autoriser.4

serveur de l'API Access-Control-Allow-Origin: https://app.example il autorise cette origine navigateur le script peut lire la réponse

L'en-tête clé est Access-Control-Allow-Origin.

Une requête est dite « simple » si sa méthode est GET, HEAD ou POST, sans en-tête personnalisé, et avec un Content-Type parmi application/x-www-form-urlencoded, multipart/form-data et text/plain. Pour toutes les autres, le navigateur demande d'abord la permission.

requête simple GET, HEAD, POST envoyée tout de suite requête non simple PUT en JSON 1. OPTIONS : la permission 2. PUT : la vraie requête

CORS pas à pas

Fais défiler : le navigateur demande d'abord la permission pour le PUT, puis le GET simple part sans question.

Navigateur https://app.example Serveur de l'API https://api.example OPTIONS /notes/7 204 No Content PUT /notes/7 200 OK PUT non envoyé lecture bloquée Le script de la page veut :
Étape 1 sur 6

Le script d'une page de https://app.example veut modifier une note sur https://api.example. Autre origine : le navigateur applique CORS.

Étape 2 sur 6 · la question

Un PUT avec du JSON n'est pas une requête simple. Le navigateur envoie d'abord, tout seul, une requête OPTIONS pour demander la permission.

Étape 3 sur 6 · la permission

Le serveur accepte : il nomme l'origine autorisée, les méthodes et les en-têtes permis.

Étape 4 sur 6 · la vraie requête

Le navigateur envoie alors le PUT. La réponse porte encore Access-Control-Allow-Origin : le script peut la lire.

Étape 5 sur 6 · si le serveur se tait

Sans ces en-têtes, le PUT ne part pas. Le script reçoit une erreur sans détail : l'explication n'est que dans la console.

Étape 6 sur 6 · une requête simple

Un GET simple part sans question : le serveur le reçoit et le traite. Sans le bon en-tête, seule la lecture de la réponse est bloquée.

CORS protège la personne, pas le serveur.

curl ou Postman ne l'appliquent pas. Une API doit donc toujours vérifier elle-même qui l'appelle et avec quels droits.

Versions et HTTPS

HTTPS, c'est HTTP dans une connexion chiffrée par TLS : personne sur le trajet ne peut lire ni modifier les messages, et un certificat prouve l'identité du serveur. Port par défaut : 443 (80 pour HTTP).

HTTP/1.1 envoie du texte HTTP/2 trames binaires : plusieurs échanges en même temps sur une seule connexion HTTP/3 même principe, au-dessus de QUIC (qui utilise UDP)

HTTP/3, normalisé en 20226. Méthodes, en-têtes et codes restent identiques d'une version à l'autre.

Six pièges à éviter

Attention

Les pièges classiques

Six erreurs qu'on voit partout, une par carte.

PUT n'est pas PATCH

PUT remplace toute la ressource. Envoyer {"role":"admin"} en PUT peut effacer le nom et les autres champs ; pour ne changer qu'un champ, c'est PATCH.

Un GET qui modifie

Un lien « supprimer » en GET est dangereux : un robot ou un outil de préchargement qui suit les liens déclencherait la suppression. GET doit rester en lecture seule.

200 avec une erreur dans le corps

Répondre 200 OK avec {"erreur":"introuvable"} trompe les clients, les caches et les outils de surveillance : le code doit dire la vérité (ici 404).

Le double clic sur « Payer »

POST n'est pas idempotent : deux clics, deux commandes. On désactive le bouton après le premier clic, et le serveur refuse une commande déjà reçue grâce à un identifiant unique.

Croire que CORS protège l'API

CORS est appliqué par le navigateur. Un attaquant qui envoie ses requêtes avec curl n'en tient pas compte : l'API doit vérifier l'authentification et les droits.

Chercher le fragment côté serveur

Dans /fiche#quiz, le serveur ne reçoit jamais #quiz : le fragment reste dans le navigateur.

Entraîne-toi

Exercices corrigés

Cherche d'abord, puis ouvre le corrigé.

1Écris la requête complète qui lit la fiche 42 en JSON sur api.example.com.Voir le corrigé
GET /fiches/42 HTTP/1.1
Host: api.example.com
Accept: application/json

La ligne de requête (méthode, cible, version), l'en-tête Host obligatoire, Accept pour demander du JSON, puis la ligne vide. Pas de corps pour un GET.

2Quelle valeur faut-il mettre dans Content-Length pour le corps {"ville":"Genève"} ?Voir le corrigé

19. Le corps compte 18 caractères, mais è prend 2 octets en UTF-8, et Content-Length compte des octets.

3La connexion coupe avant la réponse. Lesquelles de ces requêtes l'appli peut-elle renvoyer toute seule sans risque : GET /notes, PUT /notes/3, POST /paiements, DELETE /notes/3 ?Voir le corrigé

GET, PUT et DELETE, qui sont idempotentes : les renvoyer donne le même état qu'un seul envoi. Pas le POST : le paiement pourrait être enregistré deux fois.

4Conçois les requêtes REST d'une bibliothèque de classe : lister les livres, lire le livre 12, en ajouter un, modifier son titre, le supprimer, lister ses emprunts.Voir le corrigé

GET /livres · GET /livres/12 · POST /livres (réponse 201 avec Location: /livres/13) · PATCH /livres/12 avec {"titre":"…"} · DELETE /livres/12 (204) · GET /livres/12/emprunts. Des noms au pluriel, aucun verbe dans les adresses.

Retiens l'essentiel

À retenir

La fiche en huit lignes

Le dialogue

HTTP : un client envoie une requête, un serveur renvoie une réponse. Chaque requête se comprend seule (sans état). Un message : ligne de départ, en-têtes, ligne vide, corps facultatif.

Les méthodes

GET lit, POST crée, PUT remplace, PATCH modifie une partie, DELETE supprime.

Sûre, idempotente

GET, HEAD, OPTIONS sont sûres ; PUT et DELETE sont idempotentes ; POST et PATCH ni l'un ni l'autre.

Les codes

2xx réussite, 3xx redirection, 4xx erreur du client, 5xx erreur du serveur ; 401 authentification, 403 droits.

REST et URL

REST : des ressources nommées au pluriel, des méthodes standard, des représentations JSON, sans état. URL : schéma, hôte, port, chemin, requête ; le fragment reste dans le navigateur.

CORS

Le navigateur ne laisse un script lire une réponse d'une autre origine que si le serveur l'autorise ; question OPTIONS pour les requêtes non simples.

Douze questions pour finir

Dernière étape, le quiz. Si tu te trompes, lis bien l'explication : c'est là qu'on retient le plus.
Quiz final

Teste-toi

Sources

  1. IETF, R. Fielding, M. Nottingham, J. Reschke (éd.), RFC 9110 : HTTP Semantics, 2022 (sans état §3.3, en-tête Host §7.2, méthodes sûres et idempotentes §9.2, codes d'état §15), consulté le 8 octobre 2026. rfc-editor.org
  2. IETF, L. Dusseault, J. Snell, RFC 5789 : PATCH Method for HTTP, 2010 (« PATCH is neither safe nor idempotent »), consulté le 8 octobre 2026. rfc-editor.org
  3. MDN Web Docs, Messages HTTP (structure d'un message : ligne de départ, en-têtes, ligne vide, corps ; même sémantique en HTTP/2), consulté le 8 octobre 2026. developer.mozilla.org
  4. MDN Web Docs, Cross-Origin Resource Sharing (CORS) (requêtes simples, requête préliminaire OPTIONS, en-têtes Access-Control-*), consulté le 8 octobre 2026. developer.mozilla.org
  5. R. T. Fielding, Architectural Styles and the Design of Network-based Software Architectures, chapitre 5 « Representational State Transfer (REST) », thèse, Université de Californie à Irvine, 2000, consulté le 8 octobre 2026. ics.uci.edu
  6. IETF, M. Bishop (éd.), RFC 9114 : HTTP/3, juin 2022 (la sémantique HTTP transportée par QUIC), consulté le 8 octobre 2026. rfc-editor.org
  7. PortSwigger Web Security Academy, Cross-origin resource sharing (CORS) (mécanisme appliqué par le navigateur ; la politique de même origine laisse envoyer des requêtes mais pas lire les réponses ; CORS ne protège pas contre les attaques CSRF), consulté le 8 octobre 2026. portswigger.net
  8. IETF, M. Nottingham, R. Fielding, RFC 6585 : Additional HTTP Status Codes, avril 2012 (429 Too Many Requests, limitation de débit), consulté le 8 octobre 2026. rfc-editor.org

Fiche relue et sourcée en septembre 2026, refaite en récit en octobre 2026.

Glisser pour continuer vers Postman et API