Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Méthodes de requête HTTP

HTTP définit un ensemble de méthodes de requête pour indiquer le but de la requête et ce qui est attendu en cas de succès. Bien qu'elles puissent aussi être des noms, ces méthodes de requête sont parfois appelées verbes HTTP. Chaque méthode possède sa propre sémantique, mais certaines caractéristiques sont partagées entre plusieurs méthodes : les méthodes de requête peuvent être sûre, idempotente ou mise en cache.

GET

La méthode GET demande une représentation de la ressource définie. Les requêtes utilisant GET doivent uniquement récupérer des données et ne doivent pas contenir de contenu de requête.

QUERY

La méthode QUERY initie une requête côté serveur. Elle demande que la ressource cible traite le contenu de la requête de manière sûre et idempotente, en renvoyant le résultat dans la réponse. Elle est similaire à GET, mais permet un contenu de requête avec une sémantique définie.

La méthode HEAD demande une réponse identique à une requête GET, mais sans le corps de la réponse.

POST

La méthode POST envoie une entité à la ressource définie, provoquant souvent un changement d'état ou des effets secondaires sur le serveur.

PUT

La méthode PUT remplace toutes les représentations actuelles de la ressource cible par le contenu de la requête.

DELETE

La méthode DELETE supprime la ressource définie.

CONNECT

La méthode CONNECT établit un tunnel vers le serveur identifié par la ressource cible.

OPTIONS

La méthode OPTIONS décrit les options de communication pour la ressource cible.

TRACE

La méthode TRACE effectue un test de boucle de message le long du chemin vers la ressource cible.

PATCH

La méthode PATCH applique des modifications partielles à une ressource.

Méthodes sûres, idempotentes et mises en cache

Le tableau suivant liste les méthodes de requête HTTP et leur catégorisation en termes de sûreté, de possibilité de mise en cache et d'idempotence.

Méthode Sûre Idempotente Mise en cache
GET Oui Oui Oui
QUERY Oui Oui Oui
HEAD Oui Oui Oui
OPTIONS Oui Oui Non
TRACE Oui Oui Non
PUT Non Oui Non
DELETE Non Oui Non
POST Non Non Conditionnelle*
PATCH Non Non Conditionnelle*
CONNECT Non Non Non

* POST et PATCH sont mises en cache lorsque les réponses incluent explicitement des informations de fraîcheur et un en-tête Content-Location correspondant.

Spécifications

Spécification
HTTP Semantics
# OPTIONS
HTTP Semantics
# HEAD
HTTP Semantics
# CONNECT
HTTP Semantics
# DELETE
HTTP Semantics
# GET
HTTP Semantics
# PUT
HTTP Semantics
# POST

Compatibilité des navigateurs

Voir aussi