OPTIONS

Syntaxe

Paramètres

Description

Cette méthode permet de demander les options de communications disponibles sur le serveur Web.

Remarques

• La méthode OPTIONS demande des informations sur les options de communication disponibles pour la ressource cible, au niveau du serveur d'origine ou d'un intermédiaire intervenant. Cette méthode permet à un client de déterminer les options et/ou les exigences associées à une ressource, ou les capacités d'un serveur, sans impliquer une action de ressource.
• Une requête OPTIONS avec un astérisque («*») comme cible de requête s'applique au serveur en général plutôt qu'à une ressource spécifique. Étant donné que les options de communication d'un serveur dépendent généralement de la ressource, la requête «*» n'est utile que comme méthode de type «ping» ou «no-op»; il ne fait rien d'autre que de permettre au client de tester les capacités du serveur. Par exemple, cette situation peut être utilisé pour tester un proxy pour la conformité HTTP/1.1 (ou son absence).
• Si la ressource n'est pas un astérisque, la requête OPTIONS s'applique aux options disponibles lors de la communication avec la ressource cible.
• Un serveur générant une réponse réussie à OPTIONS devrait envoyer tous les champs d'entête pouvant indiquer des fonctionnalités facultatives mises en oeuvres par le serveur et applicables à la ressource cible (par exemple, Allow), y compris les extensions potentielles non définies par cette spécification. Le cas échéant, la charge utile de réponse peut également décrire les options de communication dans une machine ou une représentation lisible par l'homme. Un format standard pour une telle représentation n'est pas défini par cette spécification, mais pourrait être défini par de futures extensions de HTTP. Un serveur doit générer un champ d'entête Content-Length: avec une valeur de «0» si aucun corps de charge utile ne doit être envoyé dans la réponse.
• Un client peut envoyer un champ d'entête Max-Forwards: dans une requête OPTIONS pour cibler un destinataire spécifique dans la chaîne de requête. Un proxy ne doit pas générer un champ d'entête Max-Forwards: lors de la transmission d'une requête, sauf si cette requête a été reçue avec un champ Max-Forwards:.
• Un client générant une requête OPTIONS contenant un corps de charge utile doit envoyer un champ d'entête Content-Type: valide décrivant le type de support de représentation. Bien que cette spécification ne définisse aucune utilisation pour une telle charge utile, les futures extensions de HTTP pourraient utiliser le corps OPTIONS pour effectuer des requêtes plus détaillées sur la ressource cible.
• Les réponses à la méthode OPTIONS ne peuvent pas être mises en cache.