204 No Content

Formulation

Description

Ce code d'erreur permet d'indiquer que la page ne contient rien.

Remarques

• Le code d'état 204 No Content indique que le serveur a correctement répondu à la requête et qu'il n'y a pas de contenu supplémentaire à envoyer dans le corps de la charge utile de réponse. Les méta-données dans les champs d'entête de réponse font référence à la ressource cible et à sa représentation sélectionnée après l'application de l'action demandée.
• Par exemple, si un code d'état 204 est reçu en réponse à une requête PUT et que la réponse contient un champ d'entête ETag:, le PUT a réussi et la valeur de champ ETag: contient la balise d'entité pour la nouvelle représentation de cette ressource cible.
• La réponse 204 permet à un serveur d'indiquer que l'action a été appliquée avec succès à la ressource cible, tout en impliquant que l'agent utilisateur n'a pas besoin de s'éloigner de sa vue de document actuelle (le cas échéant). Le serveur suppose que l'agent utilisateur fournira une indication du succès à son utilisateur, conformément à sa propre interface, et appliquera toute méta-donnée nouvelle ou mise à jour en réponse à sa représentation active.
• Par exemple, un code d'état 204 est couramment utilisé avec les interfaces d'édition de document correspondant à une action enregistrer, de sorte que le document en cours d'enregistrement reste disponible pour l'utilisateur pour l'édition. Il est également fréquemment utilisé avec des interfaces prévoyant que les transferts de données automatisés sont répandus, comme dans les systèmes de contrôle de version distribués.
• Une réponse 204 se termine par la première ligne vide après les champs d'entête car elle ne peut pas contenir de corps de message.
• Une réponse 204 peut être mise en cache par défaut; c'est-à-dire, sauf indication contraire par la définition de la méthode ou les contrôles de cache explicites.