PUT
La méthode HTTP PUT crée une nouvelle ressource ou remplace une représentation de la ressource ciblée par le contenu de la requête.
La différence entre PUT
et POST
tient au fait que PUT
est une méthode idempotente. Une requête PUT, envoyée une ou plusieurs fois avec succès, aura toujours le même effet (il n'y a pas d'effet de bord). À l'inverse, des requêtes POST successives et identiques peuvent avoir des effets additionnels, ce qui peut revenir par exemple à passer plusieurs fois une commande.
La requête a un corps | Oui |
---|---|
Une réponse de succès a un corps | Non |
Sûre | Non |
Idempotente | Oui |
Peut être mise en cache | Non |
Autorisée dans les formulaires HTML | Non |
Syntaxe
PUT /new.html HTTP/1.1
Exemple
Requête
PUT /new.html HTTP/1.1 Host: example.com Content-type: text/html Content-length: 16 <p>Nouveau fichier</p>
Réponses
Si la ressource ciblée ne possède pas de représentation courante et que la requête PUT
en crée une avec succès, alors le serveur d'origine doit informer l'agent utilisateur en envoyant une réponse 201
(Created
).
HTTP/1.1 201 Created Content-Location: /new.html
Si la ressource ciblée a déjà une représentation et que cette représentation est modifiée avec succès, conformément à l'état de la représentation jointe, alors le serveur d'origine doit envoyer une réponse, que ce soit 200
(OK
) ou 204
(No Content
), pour indiquer la réussite de la requête.
HTTP/1.1 204 No Content Content-Location: /existing.html
Spécifications
Specification |
---|
HTTP Semantics # PUT |
Compatibilité des navigateurs
BCD tables only load in the browser