501 Not Implemented ("не реализовано")

https://httpcat.ru/501

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 501 Not Implemented означает, что сервер не распознаёт или не поддерживает запрошенный HTTP-метод и не может его обработать. Это не ошибка клиента, а ограничение возможностей сервера.

Основные характеристики:

Возвращается, если сервер **не реализует запрошенный метод** (например, PATCH, CONNECT)
В отличие от 405 Method Not Allowed, здесь метод вообще не распознан — даже для других ресурсов
Может также означать, что требуемая функциональность (например, WebDAV или расширения HTTP) недоступна

Типичное использование:

PATCH /users/42 HTTP/1.1
Host: example.com

HTTP/1.1 501 Not Implemented
Content-Type: application/json

{
    "error": "The PATCH method is not supported by this server"
}

Особенности заголовков:

Content-Type — может содержать пояснение о неподдерживаемом методе
Allow — не обязателен, в отличие от 405

Когда использовать:

Если сервер не реализует запрошенный метод HTTP (например, PATCH, OPTIONS)
При запросе к прокси или шлюзу, который не поддерживает передачу определённого типа запросов
В API, если конкретная операция пока не реализована (но тогда лучше использовать 501 с явным пояснением)

Дополнительно:

Отличие от 405 Method Not Allowed: 405 означает, что метод поддерживается, но **запрещён для ресурса**; 501 — метод вообще **не реализован**
Сервер может поддерживать только базовые методы (GET, POST) и отклонять всё остальное через 501
Если сервер планирует реализовать метод в будущем, стоит указать это в теле ответа

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/501