Content-Location

Penggunaan

Header Content-Location menyediakan sebuah URL yang mengidentifikasi representasi tertentu dari suatu sumber daya yang dikirimkan dalam body response. Berbeda dengan header Location yang mengalihkan klien ke sumber daya lain, Content-Location menunjuk ke representasi persis yang dipilih server setelah negosiasi konten.

Ketika server mendukung beberapa representasi dari sumber daya yang sama (bahasa, format, atau encoding yang berbeda), header Content-Location memberi tahu klien varian spesifik mana yang terpilih. Perbedaan ini penting untuk caching dan untuk menandai (bookmark) hasil negosiasi tersebut.

Nilainya berupa URL absolut atau referensi relatif yang diresolusi terhadap URL permintaan. Referensi relatif lebih umum dipakai dalam praktiknya.

Content-Location juga muncul pada response terhadap permintaan PUT dan POST. Setelah POST berhasil membuat sumber daya baru, server menyetel Content-Location ke URL item yang baru dibuat apabila body response merepresentasikan sumber daya tersebut secara langsung.

Contoh

Klien meminta sebuah dokumen di /report dan server memilih varian PDF berbahasa Inggris melalui negosiasi konten. Header Content-Location mengidentifikasi URL spesifik dari representasi yang dipilih.

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

Setelah permintaan POST membuat sumber daya baru, server mengembalikan item yang dibuat tersebut di dalam body response. Header Content-Location menunjuk ke URL kanonis bagi sumber daya baru itu.

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

Catatan

Header Location mengalihkan klien ke sumber daya lain sehingga mengubah target permintaan. Content-Location mengidentifikasi URL spesifik dari representasi yang sudah dikirimkan dalam body response. Location memicu permintaan baru. Content-Location menjelaskan apa yang telah dikembalikan.