O que é Body HTTP?

Onde fica o conteúdo da mensagem

Body HTTP é o corpo de uma requisição ou resposta, a parte que pode transportar conteúdo como um formulário, uma imagem ou um documento. Os cabeçalhos descrevem aspectos da mensagem, enquanto o corpo contém o material que será interpretado pela aplicação. Nem toda mensagem possui corpo.

Quando você envia um cadastro, o corpo da requisição pode carregar nome e email. A resposta pode trazer outro corpo, com o identificador do contato criado. São conteúdos diferentes, mesmo quando os dois usam o mesmo formato.

Uma consulta também pode receber conteúdo no corpo da resposta sem enviar um corpo na requisição. É o caso de uma chamada GET que solicita uma página pelo endereço. A função de cada mensagem determina o que precisa ser transportado.

O formato precisa corresponder ao conteúdo

O cabeçalho Content-Type declara o tipo do conteúdo, como application/json para um corpo em JSON. Um formulário com arquivos pode usar multipart/form-data para reunir campos e arquivos em partes distintas da mesma mensagem. A escolha precisa corresponder à representação aceita pelo serviço.

Escolher um cabeçalho não transforma o conteúdo automaticamente. Uma mensagem declarada como JSON pode ser recusada quando o corpo não segue essa sintaxe. A API precisa documentar os formatos aceitos e distinguir um formato não aceito de um conteúdo inválido dentro do formato previsto.

{
"nome": "Ana",
"newsletter": true
}

Esse trecho mostra apenas o corpo. O método, o endereço e os cabeçalhos pertencem a outras partes da requisição. Para que o cadastro funcione, o endpoint precisa aceitar os campos apresentados e os tipos de cada valor.

Corpo enviado e corpo recebido

O corpo também pode ser um arquivo binário, como uma fotografia. Por isso, tentar converter qualquer resposta em JSON pode produzir um erro de leitura. Primeiro identifique o conteúdo esperado e o tipo efetivamente recebido.

Quando não há corpo para interpretar

Uma resposta 204 No Content comunica sucesso sem conteúdo adicional. A resposta a HEAD também não entrega o corpo que acompanharia um GET. Essas ausências seguem a semântica HTTP e não indicam uma falha de transporte.

Em requisições GET, o corpo não tem uma semântica geral definida para aplicações. Para filtros de consulta, siga os parâmetros documentados na URL. Acrescentar um corpo sem previsão no contrato pode resultar em rejeição ou em conteúdo ignorado pelo serviço.

Como investigar um corpo inesperado

Na aba Network do navegador, confira o status e o Content-Type junto com o conteúdo recebido. Uma integração que espera JSON pode ter recebido uma página HTML de login ou de erro de um intermediário. Nesse caso, a falha não está necessariamente no parser usado pela aplicação.

Compare também os campos com o contrato e confira limites de tamanho para uploads. Um JSON legível ainda pode estar incompleto para a chamada. O verbete de header HTTP explica os campos que descrevem essa mensagem.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

O corpo HTTP transporta conteúdo nas chamadas entre a interface e a API, conforme o formato previsto no contrato.

Conhecer a formação →