Comprendre les requêtes HTTP et les codes de réponse
Découvrons les types de requêtes HTTP et les réponses.
Lorsque vous naviguez sur un site web ou que vous développez une application, les échanges entre le client (navigateur, appli, etc.) et le serveur passent par le protocole HTTP (HyperText Transfer Protocol). Ces échanges sont constitués de requêtes envoyées par le client, et de réponses fournies par le serveur.
Dans cet article, nous allons voir :
- Les différents types de requêtes HTTP
- Les codes de réponse HTTP les plus courants
🔁 Les principaux types de requêtes HTTP
Chaque requête HTTP est associée à une méthode qui indique l'action à effectuer. Voici les plus utilisées :
🔹 GET
- Objectif : Récupérer des données à partir du serveur
- Utilisation courante : Affichage d’une page, récupération d’une ressource (image, JSON…)
- Caractéristique : Les données sont visibles dans l’URL (via les paramètres
?key=value) - 🟢 Exemple :
GET /articles/25
🔹 POST
- Objectif : Envoyer des données vers le serveur
- Utilisation courante : Formulaires d’inscription, commentaires, création de ressources
- Caractéristique : Les données sont envoyées dans le corps de la requête
- 🟢 Exemple :
POST /articles - 📦 Corps :
{ "titre": "Nouveau post", "contenu": "..." }
🔹 PUT
- Objectif : Mettre à jour une ressource existante
- Utilisation courante : Mise à jour complète d’un objet (article, profil, etc.)
- Caractéristique : Remplace entièrement la ressource
- 🟢 Exemple :
PUT /articles/25 - 📦 Corps :
{ "titre": "Titre mis à jour", "contenu": "..." }
🔹 PATCH
- Objectif : Modifier partiellement une ressource
- Utilisation courante : Mise à jour d’un seul champ (par exemple, le titre)
- Caractéristique : Plus léger que PUT
- 🟢 Exemple :
PATCH /articles/25 - 📦 Corps :
{ "titre": "Nouveau titre" }
🔹 DELETE
- Objectif : Supprimer une ressource
- Utilisation courante : Suppression d’un compte, d’un article, etc.
- 🟢 Exemple :
DELETE /articles/25
📊 Les codes de réponse HTTP
Lorsque le serveur reçoit une requête, il renvoie un code de statut HTTP pour indiquer le résultat de l’opération. Ces codes sont regroupés par catégories :
✅ 2xx – Succès
| Code | Signification | Description |
|---|---|---|
| 200 | OK | Requête réussie |
| 201 | Created | Ressource créée avec succès (POST) |
| 204 | No Content | Requête réussie, mais pas de contenu retourné (souvent avec DELETE ou PUT) |
⚠️ 4xx – Erreur côté client
| Code | Signification | Description |
|---|---|---|
| 400 | Bad Request | Requête mal formulée |
| 401 | Unauthorized | Authentification requise ou échouée |
| 403 | Forbidden | Accès refusé malgré une authentification valide |
| 404 | Not Found | Ressource inexistante |
| 422 | Unprocessable Entity | Données envoyées incorrectes ou invalides |
❌ 5xx – Erreur côté serveur
| Code | Signification | Description |
|---|---|---|
| 500 | Internal Server Error | Erreur générale côté serveur |
| 502 | Bad Gateway | Mauvaise réponse d’un autre serveur en amont |
| 503 | Service Unavailable | Serveur momentanément indisponible |
🔍 En résumé
| Méthode | Action | Exemple |
|---|---|---|
| GET | Lire | /articles |
| POST | Créer | /articles |
| PUT | Remplacer | /articles/1 |
| PATCH | Modifier | /articles/1 |
| DELETE | Supprimer | /articles/1 |
Et n’oubliez pas, un code 2xx indique que tout s’est bien passé, 4xx qu’il y a une erreur côté client, et 5xx une erreur côté serveur.
💡 Astuce développeur
Utilisez des outils comme Postman, cURL ou les outils de développement de votre navigateur pour tester et visualiser les requêtes HTTP.
