Content-Location

Uso

La cabecera Content-Location proporciona una URL que identifica la representación concreta de un recurso entregada en el cuerpo de la respuesta. A diferencia de la cabecera Location, que redirige al cliente a un recurso distinto, Content-Location señala la representación exacta que el servidor eligió tras la negociación de contenido.

Cuando un servidor admite varias representaciones del mismo recurso (distintos idiomas, formatos o codificaciones), la cabecera Content-Location indica al cliente qué variante concreta se ha seleccionado. Esta distinción resulta importante para el almacenamiento en caché y para guardar como marcador el resultado negociado.

El valor es una URL absoluta o una referencia relativa que se resuelve respecto a la URL de la solicitud. En la práctica, la referencia relativa es más habitual.

Content-Location también aparece en las respuestas a solicitudes PUT y POST. Después de que un POST cree correctamente un recurso nuevo, el servidor establece Content-Location con la URL del elemento recién creado cuando el cuerpo de la respuesta representa directamente dicho recurso.

Ejemplo

Un cliente solicita un documento en /report y el servidor selecciona la variante PDF en inglés mediante la negociación de contenido. La cabecera Content-Location identifica la URL concreta de la representación elegida.

GET /report HTTP/1.1
Host: example.re
Accept: application/pdf
Accept-Language: en

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Language: en
Content-Location: /report/en.pdf

Después de que una solicitud POST cree un recurso nuevo, el servidor devuelve el elemento creado en el cuerpo de la respuesta. La cabecera Content-Location apunta a la URL canónica del nuevo recurso.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Location: /orders/12345

Nota

La cabecera Location redirige al cliente a un recurso distinto y cambia el destino de la solicitud. Content-Location identifica la URL concreta de la representación ya entregada en el cuerpo de la respuesta. Location desencadena una nueva solicitud; Content-Location describe lo que se ha devuelto.