Méthode de requête 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 a un corps | Elle peut |
|---|---|
| La réponse de succès a un corps | Elle peut |
| Sûre | Non |
| Idempotente | Oui |
| Mis en cache | Non |
| Autorisée dans les formulaires HTML | Non |
Syntaxe
DELETE <request-target>["?"<query>] HTTP/1.1
<request-target>-
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). <query>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 # name-delete |
Compatibilité des navigateurs
Voir aussi
- Codes de statut HTTP :
200,202,204 - Méthodes de requête HTTP
- Codes de statut de réponse HTTP
- En-têtes HTTP