DELETE
La méthode HTTP DELETE
demande au serveur de supprimer une ressource donnée.
La méthode DELETE
n'a pas de sémantique définie pour le corps du message, qui devrait donc être vide.
La requête possède un corps | Elle peut |
---|---|
En cas de réussite, la réponse contient un corps | Elle peut |
La méthode est sûre | Non |
La méthode est idempotente | Oui |
La requête peut être mise en cache | Non |
La méthode est autorisée pour les formulaires HTML | Non |
Syntaxe
DELETE <cible-requête>["?"<fragment-requête>] HTTP/1.1
<cible-requête>
-
Identifie la ressource cible de la requête lorsqu'elle est combinée avec l'information fournie par l'en-tête
Host
. Il s'agit d'un chemin absolu (par exemple/chemin/vers/fichier.html
) pour les requêtes vers un serveur originel et d'une URL absolue pour les requêtes vers les serveurs mandataires (proxies) (par exemplehttp://www.example.com/chemin/vers/fichier.html
). <fragment-requête>
Facultatif-
Un fragment de requête optionnel précédé d'un point d'interrogation
?
. Utilisé généralement pour fournir de l'information sous la forme de pairesclé=valeur
.
Exemples
Suppression d'une ressource
La requête suivante demande au serveur la suppression de la ressource fichier.html
:
DELETE /fichier.html HTTP/1.1
Host: example.com
Si la requête réussit, plusieurs codes de statut de réponses peuvent être renvoyés.
Une réponse 204 No Content
indique que la requête a réussi et qu'aucune information supplémentaire ne doit être fournie au client en retour :
HTTP/1.1 204 No Content
Date: Wed, 04 Sep 2024 10:16:04 GMT
Une réponse 200 OK
indique que la requête réussit et que le corps de la réponse inclut une représentation décrivant le résultat :
HTTP/1.1 200 OK
Content-Type: text/html; charset=UTF-8
Date: Fri, 21 Jun 2024 14:18:33 GMT
Content-Length: 1234
<html>
<body>
<h1>Fichier "fichier.html" supprimé.</h1>
</body>
</html>
Une réponse 202 Accepted
indique que la requête a été acceptée et qu'elle réussira probablement, mais que la ressource n'a pas encore été supprimée du serveur.
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Content-Type: text/html; charset=UTF-8
Content-Length: 1234
<html>
<body>
<h1>Suppression acceptée pour "fichier.html".</h1>
<p>Voir <a href="http://example.com/tasks/123/status">la console de statut</a> pour plus de détails.</p>
</body>
</html>
Spécifications
Specification |
---|
HTTP Semantics # DELETE |
Compatibilité des navigateurs
BCD tables only load in the browser