En-tête Location
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'en-tête de réponse HTTP Location indique l'URL vers laquelle rediriger une page.
Il n'a de signification que lorsqu'il est envoyé avec une réponse de redirection 3XX ou une réponse de statut 201 Created.
Lors des redirections, la méthode HTTP utilisée pour effectuer la requête redirigée afin d'obtenir la page pointée par Location dépend de la méthode d'origine et du type de redirection :
- Les réponses
303 See Otherentraînent toujours une requêteGETlors de la redirection. 307 Temporary Redirectet308 Permanent Redirectutilisent la même méthode que la requête initiale.301 Moved Permanentlyet302 Founddevraient utiliser la même méthode de requête que la requête initiale, bien que cela ne soit pas garanti pour les anciens agents utilisateur.
Toutes les réponses avec l'un des codes de statut ci-dessus incluent un en-tête Location.
En cas de création de ressource, il indique l'URL de la ressource nouvellement créée afin qu'un·e client·e puisse la demander immédiatement.
Location et Content-Location sont différents.
Content-Location indique l'URL à utiliser pour accéder directement à la ressource à l'avenir lorsque la négociation de contenu a eu lieu.
Location est associé à la réponse, tandis que Content-Location est associé à la représentation qui a été retournée.
| Type d'en-tête | En-tête de réponse |
|---|
Syntaxe
Location: <url>
Directives
<url>-
Peut être relative à l'URL de la requête ou une URL absolue.
Exemples
Location: /index.html
Spécifications
| Specification |
|---|
| HTTP Semantics> # field.location> |