Comment choisir entre les méthodes PUT, POST et PATCH lors de la conception d'une API REST ?

Le choix entre PUT, POST et PATCH dépend de la nature de l’opération sur la ressource :

• POST — utilisé pour créer une nouvelle ressource. La requête est généralement envoyée à la collection, et le serveur crée un nouvel élément.

• PUT — utilisé pour la mise à jour complète de la ressource. Le client envoie une représentation complète de la ressource, et le serveur remplace l’objet existant par cette nouvelle version.

• PATCH — pour la mise à jour partielle de la ressource. Le client envoie uniquement les champs modifiés, et le serveur les met à jour sans remplacer l’ensemble de l’objet.

Exemple :

• Créer un utilisateur — POST /users
• Mettre à jour tout le profil de l’utilisateur — PUT /users/{id}
• Modifier uniquement l’email de l’utilisateur — PATCH /users/{id}