O servidor não oferece suporte a essa funcionalidade.
Quando usar
Um método HTTP que o servidor não reconhece de forma alguma.
Causas comuns e soluções
O 501 significa que o servidor não reconhece nem suporta o método da requisição, em nenhuma URL: um método WebDAV como PROPFIND enviado a um servidor sem WebDAV, ou PATCH enviado a um servidor antigo. Compare com o 405, em que o método existe, mas não é permitido naquela URL. Algumas APIs também retornam 501 para endpoints documentados, mas ainda não implementados.
Proxies e CDNs podem gerá-lo: alguns rejeitam métodos incomuns, e um servidor deve responder 501 a um Transfer-Encoding que não suporta. Se ele aparecer inesperadamente, envie o mesmo método direto para a origem com curl -X para ver qual camada o recusa. Um 501 é cacheável por padrão, então adicione Cache-Control: no-store se o endpoint vai começar a funcionar em breve.
Erro do servidor (5xx)
Os códigos 5xx são erros do servidor: a requisição pode estar certa, mas o servidor ou algo por trás dele falhou. Vale a pena configurar alertas para eles.
Como fica
HTTP/1.1 501 Not ImplementedComo enviar
| Node.js / Express | res.status(501).end() |
|---|---|
| Python / Flask | return '', 501 |
| nginx | return 501; |
Como verificar
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/