Location

Заголовок відповіді Location вказує URL-адресу для перенаправлення сторінки. Він надає лише значення, коли подається відповідь зі статусом 3xx (перенаправлення) або 201 (створений).

У випадках перенаправлення, метод HTTP, який використовується для внесення нового запиту на вибір сторінки, на яку позначається Location, залежить від оригінального методу та виду перенаправлення:

  • Якщо відповіді 303 (Див.також) завжди призводять до використання методу GET, 307 (Тимчасове перенаправлення) та 308  (Постійне перенаправлення) не змінює метод, використаний у вихідному запиті;
  • 301 (Постійне перенаправлення) і 302 (Знайдено) не змінюють метод більшу частину часу, хоча старі користувачі-агенти можуть це робити (так що ви, в основному, не відомо).

Усі відповіді з одним із цих кодів стану надсилають заголовок Location .

У випадках створення ресурсу, сервер вказує URL-адресу новоствореного ресурсу.

Location та Content-Location є різними: Location вказує на ціль перенаправлення (або URL новоствореного ресурсу), тоді як Content-Location вказує на пряму URL-адресу, яка використовується для доступу до ресурсу, коли відбувається узгодження вмісту, без необхідності подальшого узгодження вмісту. Location є заголовком, пов'язаним з відповіддю, тоді як Content-Location асоціюється з повернутим об'єктом.

Header type Response header
Forbidden header name no

Синтаксис

Location: <url>

Директиви

<url>
Відносна (до URL-адреси запиту) або абсолютна URL-адреса.

Приклади

Location: /index.html

Специфікації

Specification Title
RFC 7231, section 7.1.2: Location Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content

Сумісність з браузерами

BCD tables only load in the browser

See also