Location: |
Emplacement |
---|---|
HTTP | Entêtes |
Syntaxe
Location: url |
Paramètres
Nom | Description |
---|---|
url | Ce paramètre permet d'indiquer l'URL. |
Description
Ce champ d'entête permet d'indiquer l'URL vers laquelle rediriger une page. Il ne fournit un sens que lorsqu'il est servi avec une réponse d'état 3xx (redirection) ou 201 (créé).
Remarques
- Certains destinataires tentent de récupérer à partir de champs d'emplacement n'étant pas des références d'URI valides. Cette spécification n'impose ni ne définit un tel traitement, mais le permet par souci de robustesse.
- En cas de redirection, la méthode HTTP utilisée pour effectuer la nouvelle requête de récupération de la page pointée par Location: dépend de la méthode d'origine et du type de redirection : si les réponses est 303 See Other conduisent toujours à l'utilisation d'une méthode GET, 307 Temporary Redirect et 308 Permanent Redirect ne modifient pas la méthode utilisée dans la requête d'origine; 301 Permanent Redirect et 302 Found ne change pas la méthode la plupart du temps, bien que les agents utilisateurs plus anciens puissent le faire. Toutes les réponses avec l'un de ces codes d'état envoient un entête d'emplacement.
- En cas de création de ressource, il indique l'URL de la ressource nouvellement créée.
- Location: vs Content-Location: : Location: indique la cible d'une redirection (ou l'URL d'une ressource nouvellement créée), tandis que l'emplacement de contenu indique l'URL directe à utiliser pour accéder à la ressource lorsque la négociation de contenu a eu lieu, sans qu'il soit nécessaire de poursuivre la négociation de contenu. Le champ d'entête Location: est un entête associé à la réponse, tandis que Content-Location: est associé à l'entité renvoyée.
- Le champ d'entête Content-Location: diffère de Location: en ce que Content-Location: fait référence à la ressource la plus spécifique correspondant à la représentation jointe. Il est donc possible qu'une réponse contienne à la fois les champs d'entête Location: et Content-Location:.
Exemple
L'exemple suivant permet d'indiquer le nom de domaine www.gladir.com :
Location: https://www.gladir.com/
Dernière mise à jour : Vendredi, le 10 janvier 2020