Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
Méthodes de requête HTTP
HTTP définit un ensemble demé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éesverbes 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 êtresûre,idempotente oucachable.
GETLa méthode
GETdemande une représentation de la ressource spécifiée.Les requêtes utilisantGETdoivent uniquement récupérer des données et ne doivent pas contenir decontenu de requête.HEADLa méthode
HEADdemande une réponse identique à une requêteGET, mais sans le corps de la réponse.POSTLa méthode
POSTsoumet une entité à la ressource spécifiée, provoquant souvent un changement d'état ou des effets secondaires sur le serveur.PUTLa méthode
PUTremplace toutes les représentations actuelles de la ressource cible par lecontenu de la requête.DELETELa méthode
DELETEsupprime la ressource spécifiée.CONNECTLa méthode
CONNECTétablit un tunnel vers le serveur identifié par la ressource cible.OPTIONSLa méthode
OPTIONSdécrit les options de communication pour la ressource cible.TRACELa méthode
TRACEeffectue un test de boucle de message le long du chemin vers la ressource cible.PATCHLa méthode
PATCHapplique des modifications partielles à une ressource.
Méthodes sûres, idempotentes et cachables
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 | Cachable |
|---|---|---|---|
GET | 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 etPATCH sont cachables lorsque les réponses incluent explicitement des informations defraîcheur et un en-têteContent-Location correspondant.
Spécifications
| Specification |
|---|
| HTTP Semantics # POST |
| HTTP Semantics # OPTIONS |
| HTTP Semantics # GET |
| HTTP Semantics # PUT |
| HTTP Semantics # CONNECT |
| HTTP Semantics # DELETE |
| HTTP Semantics # HEAD |