O recurso está bloqueado.
Quando usar
WebDAV, ou um registro que está sendo editado por outra pessoa.
Causas comuns e soluções
O 423 vem do WebDAV: um arquivo ou coleção está bloqueado, geralmente porque outro cliente mantém um LOCK sobre ele. Você o encontra com Nextcloud, SharePoint ou documentos do Office abertos a partir de um compartilhamento WebDAV, muitas vezes depois que um cliente travou e deixou um bloqueio para trás. Os bloqueios têm timeout e acabam expirando; no Nextcloud, um admin pode limpar os bloqueios antigos, que ficam no banco de dados ou no Redis.
Fora do WebDAV, algumas APIs usam 423 para um registro sendo editado por outra pessoa, ou para uma conta bloqueada depois de muitas tentativas de login sem sucesso. Clientes genéricos não o conhecem bem, então inclua uma mensagem clara e, se possível, Retry-After com o tempo restante do bloqueio. O 409 é a escolha mais amplamente entendida para conflitos de edição, e 429 ou 403 para bloqueios de login.
Erro do cliente (4xx)
Os códigos 4xx são erros do cliente: a própria requisição está errada, não está autorizada ou aponta para algo que não existe. Repetir a mesma requisição não vai adiantar.
Como fica
HTTP/1.1 423 LockedComo enviar
| Node.js / Express | res.status(423).end() |
|---|---|
| Python / Flask | return '', 423 |
| nginx | return 423; |
Como verificar
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/