Idempotente
Méthode HTTP PUT
Les requêtes PUT remplacent la ressource cible par le contenu de la requête.
Signification
Le client demande au serveur de stocker la représentation fournie à l’URI cible.
Usages courants
Utilisez PUT lorsque le client remplace une ressource connue ou écrit vers une URL connue.
Ce qu’il faut vérifier
Vérifiez que la requête contient la représentation de remplacement complète et que les en-têtes de précondition empêchent les écrasements accidentels au besoin.
Exemple de requête
PUT /articles/123 HTTP/1.1
Host: example.com
Content-Type: application/json
{"title":"Updated article"}Propriétés
- Sûre
- Non. Cette méthode peut modifier l’état du serveur.
- Idempotente
- Oui. Répéter la même requête devrait produire le même effet voulu.
- Cacheable
- Non
- Corps de requête
- Généralement oui
Références
- Registre
- IANA HTTP Method Registry
- Spécification
- RFC 9110 Section 9.3.4
- Guide
- MDN PUT