HTTP 204 No Content (Sem conteúdo)
A requisição deu certo e não há conteúdo para devolver.
Ficha rápida
| Código | 204 |
|---|---|
| Nome oficial (em inglês) | No Content |
| Nome em português | Sem conteúdo |
| Grupo | Sucesso (2xx) |
| Definido em | RFC 9110, Section 15.3.5 |
| Quem costuma gerar | O servidor, quando a requisição dá certo. |
O que significa
Indica sucesso sem conteúdo para devolver. A resposta não pode ter corpo. É comum depois de apagar ou atualizar algo, quando o cliente não precisa de dados de volta.
Quando o servidor devolve esse código
- DELETE que apagou o recurso.
- PUT ou PATCH que atualizou e não devolve o recurso.
Problemas comuns
- Tentar ler o corpo de um 204 e dar erro de JSON vazio.
- Confundir 204 com falha por não haver conteúdo.
Como resolver
- No cliente, não faça parse de corpo quando o status for 204.
- Se o cliente precisa do recurso atualizado, devolva 200 com o corpo.
- Em fluxos de automação, trate 204 como sucesso.
Em automações e integrações
Em um fluxo, não tente ler o corpo de uma resposta 204, porque ele não existe. Se o próximo passo analisa JSON, coloque uma condição antes para o caso sem conteúdo.
Não confunda com outros códigos
Não confunda com um 200 sem corpo: o 204 é o jeito correto de dizer que deu certo e que não há nada a devolver.
Exemplo de resposta
HTTP/1.1 204 No Content
O exemplo é ilustrativo: o corpo e os cabeçalhos reais mudam de servidor para servidor. O código e o nome seguem o padrão HTTP.
Perguntas frequentes
Posso mandar corpo em um 204?
Não. Por definição, a resposta 204 termina nos cabeçalhos.
204 é erro?
Não. É um código de sucesso.
Qual método costuma devolver 204?
O DELETE, que apaga o recurso, e o PUT ou o PATCH quando a API não devolve o recurso atualizado. O GET quase nunca devolve 204, porque pede dados.