Explique ce que signifie la méthode PUT dans REST API et dans quels cas elle est utilisée.

La méthode PUT dans l'API REST est utilisée pour mettre à jour complètement une ressource ou la créer si elle n'existe pas encore. Contrairement à PATCH, qui applique des modifications partielles, PUT remplace toute la ressource par les données envoyées.

Principales caractéristiques de PUT :

• Idempotence : un appel répété avec les mêmes données ne changera pas le résultat.
• Généralement utilisé pour mettre à jour un objet existant via une URI connue.
• Si la ressource n'existe pas, le serveur peut la créer avec l'URI spécifié.

Exemple : si vous avez un utilisateur avec l'ID 123, une requête PUT à /users/123 avec une description complète de l'utilisateur remplacera tous les champs de cet utilisateur par de nouvelles valeurs.

Utilisé lorsque vous souhaitez garantir de remplacer complètement la ressource, plutôt que de la mettre à jour partiellement.