Body HTTP

Definição

O body HTTP é o conteúdo opcional transportado no corpo de uma mensagem. Uma requisição pode carregar os campos de um cadastro e a resposta correspondente pode devolver o registro criado. Quando a operação não precisa enviar conteúdo, a mensagem simplesmente não tem corpo.

O formato depende da operação

O mesmo servidor pode receber JSON em uma rota, conteúdo de formulário em outra e um arquivo em uma terceira. O header Content-Type anuncia qual formato o receptor deve usar para interpretar o corpo, por isso o contrato de cada operação costuma fixar o formato esperado.

POST /clientes HTTP/1.1
Host: api.exemplo.com
Content-Type: application/json

{"nome":"Ana","email":"ana@exemplo.com"}

Nem toda mensagem tem corpo

Uma consulta por GET costuma carregar apenas método e endereço, sem corpo. Uma resposta que informa uma falha pode trazer um corpo curto com a mensagem. Conferir o Content-Type antes de interpretar o corpo evita tratar conteúdo ausente como um erro de leitura.

O que pode falhar e como conferir

A falha mais comum é interpretar o corpo como se tivesse um formato que ele não tem. Se o Content-Type anunciar texto e a aplicação tentar ler JSON, a leitura quebra ou produz valores vazios. Outra falha frequente é tratar a ausência de corpo como erro: em uma resposta 204, a operação terminou sem conteúdo e não há nada para ler. Para conferir, abra a aba Network das ferramentas do navegador, selecione a chamada e compare o Content-Type com o corpo mostrado ao lado. Se o formato bater com o contrato da operação, a interpretação está correta, e se divergir, o problema está na leitura, não no transporte.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, o body HTTP carrega o conteúdo que a interface envia ao backend e o resultado que ela lê de volta.

Conhecer a formação →