DELETE

Si la ressource cible a une ou plusieurs représentations actuelles, elles peuvent ou non être détruites par le serveur d'origine, et le stockage associé peut ou non être récupéré, ce qui dépend entièrement de la nature de la ressource et de sa mise en œuvre par le serveur d'origine (qui dépassent la portée de la présente spécification). De même, d'autres aspects de la mise en œuvre d'une ressource peuvent devoir être désactivés ou archivés à la suite d'un DELETE, comme les connexions à la base de données ou à la passerelle. En général, on suppose que le serveur d'origine n'autorisera la méthode DELETE que pour les ressources pour lesquelles il dispose d'un mécanisme prescrit pour effectuer la suppression.

Relativement peu de ressources autorisent la méthode DELETE - son utilisation principale est pour les environnements de création à distance, où l'utilisateur dispose d'une certaine direction concernant son effet. Par exemple, une ressource qui a été précédemment créée à l'aide d'une requête PUT, ou identifiée via le champ d'en-tête Location après une réponse 201 (Created) à une requête POST, peut permettre à une requête DELETE correspondante d'annuler ces actions. De même, les implémentations d'agents utilisateurs personnalisés qui mettent en œuvre une fonction de création, tels que les clients de contrôle de révision utilisant HTTP pour les opérations à distance, pourraient utiliser DELETE en supposant que l'espace URI du serveur a été conçu pour correspondre à un référentiel de versions.

Si une méthode DELETE est appliquée avec succès, le serveur d'origine DEVRAIT envoyer un code d'état 202 (Accepté) si l'action est susceptible de réussir mais n'a pas encore été exécutée, un code d'état 204 (Pas de contenu) si l'action a été exécutée et qu'aucune autre information ne doit être fournie, ou un code d'état 200 (OK) si l'action a été exécutée et que le message de réponse comprend une représentation décrivant l'état.

Une charge utile dans un message de demande DELETE n'a pas de sémantique définie ; l'envoi d'un corps de charge utile dans une demande DELETE peut entraîner le rejet de la demande par certaines implémentations existantes.

Les réponses à la méthode DELETE ne peuvent pas être mises en cache. Si une requête DELETE passe par un cache qui a une ou plusieurs réponses stockées pour l'URI de la requête effective, ces réponses stockées seront invalidées (voir la section 4.4 de [RFC7234]).

Les réponses à la méthode DELETE ne peuvent pas être mises en cache.