Allow

Применение

Серверы включают Allow, чтобы сообщить, какие методы запроса поддерживает ресурс. Этот заголовок обязателен в ответах 405 Method Not Allowed, где сервер информирует клиента о допустимых методах для запрошенного URI.

Заголовок также появляется в ответах на запросы OPTIONS. Запрос OPTIONS просит сервер описать доступные для ресурса параметры взаимодействия, и Allow предоставляет в ответе список разрешённых методов.

Значение представляет собой список стандартных имён HTTP-методов, разделённых запятыми. Список отражает методы, которые ресурс принимает на момент ответа. Пустой заголовок Allow означает, что в данный момент не принимается ни один метод; так бывает, когда сервер временно ограничивает доступ к ресурсу.

Заголовок Allow описывает целевой ресурс, а не сервер в целом. Разные ресурсы на одном сервере часто поддерживают разные наборы методов. Конечная точка-коллекция может принимать GET и POST, тогда как отдельный ресурс поддерживает GET, PUT и DELETE.

method-list

Список имён HTTP-методов, разделённых запятыми. Распространённые значения:

Allow: GET, HEAD, POST

Пример

Клиент отправляет запрос DELETE к ресурсу, который поддерживает только GET и POST. Сервер отвечает 405 и включает заголовок Allow со списком допустимых методов.

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

Ответ на запрос OPTIONS показывает все методы, которые принимает ресурс. Метод HEAD доступен неявно, когда поддерживается GET.

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

Ответ 201 Created после POST включает Allow, чтобы указать методы, доступные для вновь созданного ресурса.

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