Allow

Penggunaan

Server menyertakan Allow untuk menyampaikan Metode permintaan mana saja yang didukung oleh suatu sumber daya. Header ini wajib ada pada respons 405 Method Not Allowed, tempat server memberi tahu klien tentang metode yang valid untuk URI yang diminta.

Header ini juga muncul pada respons terhadap permintaan OPTIONS. Permintaan OPTIONS meminta server menjelaskan opsi komunikasi yang tersedia untuk suatu sumber daya, dan Allow menyediakan daftar metode yang diizinkan di dalam respons tersebut.

Nilainya berupa daftar nama metode HTTP standar yang dipisahkan koma. Daftar itu mencerminkan metode yang diterima sumber daya pada saat respons dikirim. Header Allow yang kosong menandakan tidak ada metode yang diterima saat ini, yang terjadi ketika server membatasi akses ke suatu sumber daya untuk sementara.

Header Allow menggambarkan sumber daya target, bukan server secara keseluruhan. Sumber daya yang berbeda pada server yang sama sering kali mendukung kumpulan metode yang berbeda pula. Sebuah endpoint koleksi mungkin menerima GET dan POST, sementara sumber daya individual mendukung GET, PUT, dan DELETE.

method-list

Daftar nama metode HTTP yang dipisahkan koma. Nilai yang umum mencakup:

Allow: GET, HEAD, POST

Contoh

Klien mengirim permintaan DELETE ke sumber daya yang hanya mendukung GET dan POST. Server merespons dengan 405 dan menyertakan header Allow yang mendaftar metode yang valid.

HTTP/1.1 405 Method Not Allowed
Allow: GET, POST
Content-Type: application/json

Respons terhadap permintaan OPTIONS menunjukkan semua metode yang diterima sumber daya tersebut. Metode HEAD tersedia secara implisit ketika GET didukung.

HTTP/1.1 200 OK
Allow: GET, HEAD, PUT, DELETE
Content-Length: 0

Respons 201 Created setelah sebuah POST menyertakan Allow untuk menunjukkan metode yang tersedia pada sumber daya yang baru dibuat.

HTTP/1.1 201 Created
Location: /items/42
Allow: GET, PUT, DELETE