Définition simple
La méthode HTTP PUT crée ou remplace l'état de la ressource ciblée par la représentation fournie ; elle possède une sémantique idempotente.
Objectif et usage
PUT demande la création ou le remplacement de l’état d’une ressource cible à partir de la représentation fournie.
Comment ça fonctionne ?
La méthode est idempotente : plusieurs requêtes identiques visent le même effet final, même si les réponses ou les journaux produits diffèrent.
Exemple et vérification
Lors d’une mise à jour concurrente, vérifier les préconditions acceptées par l’API, par exemple un ETag associé à If-Match.
Points d’attention
Une requête PUT ne signifie pas automatiquement modification partielle. Omettre un champ peut avoir des conséquences différentes selon le contrat de l’API.
En résumé
Utiliser PUT exige de connaître la représentation attendue et le comportement de remplacement défini par le serveur.