Les Méthodes HTTP
Les Méthodes HTTP
Section titled “Les Méthodes HTTP”Les méthodes HTTP définissent les actions possibles sur les ressources. Chaque méthode a un rôle précis et il est important de les utiliser correctement.
GET : Récupérer des données
Section titled “GET : Récupérer des données”Usage : Lire une ressource sans la modifier
Exemple :
curl https://jsonplaceholder.typicode.com/posts/1Récupère le post avec l’ID 1.
Caractéristiques :
- Pas de corps de requête
- Peut être mis en cache
- Idempotent (plusieurs appels donnent le même résultat)
POST : Créer une ressource
Section titled “POST : Créer une ressource”Usage : Envoyer des données pour créer quelque chose de nouveau
Exemple :
curl -X POST https://jsonplaceholder.typicode.com/posts \ -H "Content-Type: application/json" \ -d '{"title":"Nouveau post","body":"Contenu","userId":1}'Crée un nouveau post.
Caractéristiques :
- Contient un corps avec les données
- Retourne généralement un code 201 (Created)
- Non idempotent (chaque appel crée une nouvelle ressource)
PUT : Remplacer complètement
Section titled “PUT : Remplacer complètement”Usage : Remplacer entièrement une ressource existante
Exemple :
curl -X PUT https://jsonplaceholder.typicode.com/posts/1 \ -H "Content-Type: application/json" \ -d '{"id":1,"title":"Mis à jour","body":"Nouveau contenu","userId":1}'Remplace complètement le post 1.
Important : Tous les champs doivent être fournis, sinon les autres seront perdus.
PATCH : Modifier partiellement
Section titled “PATCH : Modifier partiellement”Usage : Mettre à jour seulement certains champs
Exemple :
curl -X PATCH https://jsonplaceholder.typicode.com/posts/1 \ -H "Content-Type: application/json" \ -d '{"title":"Titre modifié"}'Modifie uniquement le titre du post 1.
Différence avec PUT : PATCH ne modifie que ce qui est envoyé, PUT remplace tout.
DELETE : Supprimer
Section titled “DELETE : Supprimer”Usage : Effacer une ressource
Exemple :
curl -X DELETE https://jsonplaceholder.typicode.com/posts/1Supprime le post 1.
Caractéristiques :
- Généralement pas de corps de requête
- Retourne souvent un code 204 (No Content)
- Idempotent (supprimer plusieurs fois a le même effet)
Récapitulatif
Section titled “Récapitulatif”| Méthode | Action | Exemple d’URL | Idempotent |
|---|---|---|---|
| GET | Lire | /users/1 | Oui |
| POST | Créer | /users | Non |
| PUT | Remplacer | /users/1 | Oui |
| PATCH | Modifier | /users/1 | Oui |
| DELETE | Supprimer | /users/1 | Oui |
Erreurs courantes à éviter
Section titled “Erreurs courantes à éviter”❌ Mauvais : GET /deleteUser?id=1
✅ Bon : DELETE /users/1
❌ Mauvais : POST /getUsers
✅ Bon : GET /users
Les actions doivent être portées par les méthodes HTTP, pas par l’URL.
Codes de statut HTTP
Section titled “Codes de statut HTTP”Chaque réponse contient un code indiquant le résultat :
- 200 OK : Succès
- 201 Created : Ressource créée
- 204 No Content : Succès sans retour de données
- 400 Bad Request : Requête invalide
- 404 Not Found : Ressource introuvable
- 500 Internal Server Error : Erreur serveur
Respecter ces conventions rend vos API prévisibles et faciles à utiliser.
📢 Partagez cet article
Section titled “📢 Partagez cet article”Dernière mise à jour : 25 Décembre 2025