POST:

Syntaxe

Paramètres

Description

Cette méthode permet d'indiquer que l'envoi s'effectue dans le corps de la requête.

Remarques

• La méthode POST demande que la ressource cible traite la représentation incluse dans la requête selon la sémantique spécifique de la ressource. Par exemple, POST est utilisé pour les fonctions suivantes (entre autres) : pour fournir un bloc de données, comme les champs saisis dans un formulaire HTML, à un processus de traitement des données; pour publier un message sur un babillard, un groupe de discussion, une liste de diffusion, un blog ou un groupe d'articles similaires;     pour création d'une nouvelle ressource n'ayant pas encore été identifiée par le serveur d'origine; et pour ajouter des données aux représentations existantes d'une ressource.
• Un serveur d'origine indique la sémantique des réponses en choisissant un code d'état approprié en fonction du résultat du traitement de la requête POST; presque tous les codes d'état définis par cette spécification peuvent être reçus en réponse à POST (les exceptions étant 206 Partial Content, 304 Not Modified et 416 Range Not Satisfiable).
• Si une ou plusieurs ressources ont été créées sur le serveur d'origine à la suite du traitement réussi d'une requête POST, le serveur d'origine devrait envoyer une réponse 201 Created contenant un champ d'entête Location: fournissant un identifiant pour la ressource principale créée et une représentation décrivant l'état de la requête tout en faisant référence aux nouvelles ressources.
• Les réponses aux requêtes POST ne peuvent être mises en cache que lorsqu'elles contiennent des informations de fraîcheur explicites. Cependant, la mise en cache POST n'est pas largement mise en oeuvre. Dans les cas où un serveur d'origine souhaite que le client puisse mettre en cache le résultat d'un POST d'une manière pouvant être réutilisée par un GET ultérieur, le serveur d'origine peut envoyer une réponse 200 OK contenant le résultat et un champ d'entête Content-Location: ayant la même valeur que l'URI de requête effective du POST.
• Si le résultat du traitement d'un POST équivaut à une représentation d'une ressource existante, un serveur d'origine peut rediriger l'agent utilisateur vers cette ressource en envoyant une réponse 303 See Other avec l'identifiant de la ressource existante dans le champ Location:. Cette situation présente l'avantage de fournir à l'agent utilisateur un identifiant de ressource et de transférer la représentation via une méthode plus adaptée à la mise en cache partagée, mais au prix d'une requête supplémentaire si l'agent utilisateur n'a pas déjà la représentation mise en cache.

Voir également

Langage de programmation - ASP 3.0 - «POST» manuellement des données d'un formulaire dans un service Web