204 No Content: Código de Status HTTP que Indica Nenhum Conteúdo Retornado

Sobre o 204 No Content

Visão Geral do 204 No Content

Resposta Bem-sucedida sem Conteúdocom um Código de Status HTTP

204 No Content Visão Geral O código de status 204 No Content é usado quando uma solicitação foi processada com sucesso, mas não há conteúdo para ser retornado no corpo da resposta. Este código é adequado para situações em que nenhum dado adicional precisa ser enviado ao cliente.

Significado A solicitação do cliente foi processada com sucesso, mas nenhum conteúdo é retornado no corpo da resposta.

Quando o 204 No Content é retornado?

• Quando uma solicitação é bem-sucedida, mas não há dados a serem retornados
• Quando o servidor aceita a solicitação, mas o estado do recurso permanece inalterado
• Quando um processo assíncrono é disparado e não é necessário um retorno imediato

Exemplos de 204 No Content

Solicitação de atualização de um recurso

PUT /api/resource/123 HTTP/1.1  
Host: example.com  
Content-Type: application/json  

{ "name": "Updated Resource", "status": "active" }  

Exemplo de resposta:

HTTP/1.1 204 No Content  

Explicação: Neste exemplo, o cliente envia uma solicitação PUT para atualizar um recurso. A solicitação é processada com sucesso e o servidor retorna o código 204 sem um corpo de resposta, indicando sucesso sem dados adicionais.

Solicitação para deletar um recurso

DELETE /api/resource/123 HTTP/1.1  
Host: example.com  

Exemplo de resposta:

HTTP/1.1 204 No Content  

Explicação: Uma solicitação DELETE remove um recurso e o servidor responde com o código 204. Isso notifica o cliente que a operação foi concluída sem a necessidade de informações adicionais no corpo da resposta.

Pontos a considerar

Ao usar o código de status 204 No Content, considere os seguintes pontos:

• Não incluir corpo de resposta
  Um 204 No Content não deve incluir um corpo na resposta, pois isso pode confundir os clientes.
• Configurar os cabeçalhos corretamente
  Evite ou configure corretamente os cabeçalhos relacionados ao conteúdo, como Content-Type e Content-Length.

Comparação com outros códigos de status HTTP relacionados

Explicação dos códigos relacionados ao 204 No Content:

• 200 OK: Usado quando a solicitação é bem-sucedida e os dados estão incluídos no corpo da resposta.
• 202 Accepted: Usado quando a solicitação foi aceita, mas o processamento ainda não foi concluído.

Compreender essas diferenças ajuda a usar o código de status 204 corretamente.