Заголовок представления HTTP Content-Location указывает альтернативное местоположение возвращаемых данных. В основном он используется для указания URL-адреса ресурса, передаваемого в результате согласования содержимого.

Заголовок Content-Location отличается от заголовка Location. Content-Location указывает прямой URL-адрес для доступа к ресурсу после выполнения согласования содержимого, позволяя клиенту в дальнейшем обходить согласование содержимого для этого ресурса. Location, с другой стороны, указывает либо цель перенаправления 3XX, либо URL-адрес вновь созданного ресурса в ответе 201 Created.

Синтаксис

Content-Location: <url>

Директивы

<url>

URL-адрес, который может быть абсолютным или относительным по отношению к URL-адресу запроса.

Примеры

Запрос данных с сервера в разных форматах

Предположим, API сайта может возвращать данные в форматах JSON, XML или CSV. Если URL-адрес определённого документа — https://example.com/documents/foo, сайт может возвращать разные URL-адреса для Content-Location в зависимости от заголовка Accept запроса:

Эти URL-адреса приведены в качестве примеров — сайт может использовать любые шаблоны URL-адресов для файлов разных типов, например параметр строки запроса: /documents/foo?format=json, /documents/foo?format=xml и так далее.

Затем клиент может запомнить, что версия JSON доступна по этому URL-адресу, и при следующем запросе этого документа пропустить согласование содержимого.

Сервер также может учитывать другие заголовки согласования содержимого, например Accept-Language.

Указание URL-адреса результата транзакции

Предположим, у вас есть <form> для отправки денег другому пользователю сайта.

<form action="/send-payment" method="post">
  <p>
    <label>
      Who do you want to send the money to?
      <input type="text" name="recipient" />
    </label>
  </p>

  <p>
    <label>
      How much?
      <input type="number" name="amount" />
    </label>
  </p>

  <button type="submit">Send Money</button>
</form>

После отправки формы сайт создаёт квитанцию о транзакции. Сервер может использовать Content-Location, чтобы указать URL-адрес этой квитанции для последующего доступа.

HTTP/1.1 200 OK
Content-Type: text/html; charset=utf-8
Content-Location: /my-receipts/38

<!doctype html>
(Lots of HTML…)

<p>You sent $38.00 to ExampleUser.</p>

(Lots more HTML…)

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

Совместимость с браузерами

См. также

• Location