Que signifie la méthode ?
La méthode indique l’action souhaitée. GET récupère une représentation, HEAD seulement ses métadonnées. POST soumet des données au traitement, PUT remplace une ressource et DELETE demande sa suppression. Une ressource peut refuser une méthode avec le code 405.
Sûr et idempotent
Une méthode sûre est destinée à la lecture. Une méthode idempotente doit produire le même effet attendu sur le serveur si elle est répétée. GET et HEAD ont les deux propriétés. PUT et DELETE sont idempotentes par définition, même si les réponses diffèrent. POST ne l’est généralement pas.
Pourquoi est-ce utile ?
Un délai dépassé ne prouve pas que le serveur n’a rien traité. Répéter un POST peut créer deux commandes. Pour répéter une écriture, utilisez une clé d’idempotence prévue par l’API ou vérifiez d’abord l’état de la ressource. Le nom de la méthode ne garantit pas une bonne implémentation.