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

http
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 exemple http://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 paires clé=valeur.

Exemples

Suppression d'une ressource

La requête suivante demande au serveur la suppression de la ressource fichier.html :

http
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
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
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
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

Voir aussi