Les verbes HTTP

Les verbes HTTP (ou méthodes HTTP) indiquent l’action demandée par un client sur une ressource. Bien les comprendre est indispensable pour maîtriser HTTP et construire des APIs REST claires, performantes et sûres.

GET sert à récupérer une ressource sans modifier l’état du serveur. Les paramètres transitent dans l’URL et la méthode est généralement compatible avec le cache, ce qui améliore les performances.

GET /articles/123 HTTP/1.1
Host: www.example.com
Accept: text/html

POST envoie des données dans le corps de la requête pour créer une ressource ou déclencher un traitement. Chaque appel peut produire un effet différent.

POST /api/articles HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "titre": "Nouveau titre",
  "contenu": "Le contenu complet de l'article."
}

PUT remplace une ressource à une URL donnée. Le client envoie généralement une représentation complète. Si la ressource n’existe pas, elle peut être créée.

PUT /api/articles/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "titre": "Titre mis à jour",
  "contenu": "Le contenu complet mis à jour de l'article."
}

PATCH applique une modification partielle sur une ressource. C’est la méthode adaptée lorsque seule une partie des champs doit évoluer.

PATCH /api/articles/123 HTTP/1.1
Host: api.example.com
Content-Type: application/json

{
  "titre": "Titre modifié uniquement"
}

DELETE supprime une ressource. Le serveur renvoie souvent un 204 sans contenu, ou un 200/202 selon le traitement.

DELETE /api/articles/123 HTTP/1.1
Host: api.example.com

• Protéger les méthodes qui modifient l’état du serveur (POST, PUT, PATCH, DELETE).
• Chiffrer les échanges via HTTPS.
• Valider et filtrer toutes les données reçues.
• Désactiver les méthodes inutiles si le contexte l’exige (TRACE, CONNECT).
• Mettre en place des protections anti-CSRF lorsque pertinent.
• Limiter la taille et le débit des requêtes pour réduire les risques d’abus.