Header HTTP

Definição

Um header HTTP é um campo de metadados de uma requisição ou resposta. Ele descreve a mensagem sem ser o conteúdo dela: formato, codificação, autenticação e instruções de transporte aparecem nos headers, enquanto o corpo carrega o conteúdo.

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

{"nome":"Ana"}

HTTP/1.1 201 Created
Content-Type: application/json
Location: /clientes/7

Papéis comuns dos headers

O Content-Type anuncia o formato do corpo, o Accept informa o formato aceito na resposta e o Authorization carrega a credencial da chamada. Cada um desses campos dá ao servidor uma instrução específica sobre como tratar a mensagem.

Header não é cabeçalho visual

O header HTTP não é o cabeçalho visual da página nem o próprio corpo. Ele é a camada de metadados que viaja junto da mensagem, invisível a você e indispensável para o servidor processar a troca.

O que pode falhar nos headers

A falha mais comum é um header ausente mudar a interpretação da mensagem. Sem o Content-Type, o servidor não sabe se o corpo é JSON ou formulário, e sem o Authorization a resposta pode chegar como 401 mesmo com a operação correta. Para conferir, abra a aba Network das ferramentas do navegador, selecione a chamada e abra a seção de headers. Compare cada campo com o que a documentação da API exige, e observe que o cabeçalho de autorização aparece como valor de metadado, nunca como parte do conteúdo.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, os headers descrevem a troca entre a interface e a API antes do conteúdo ser interpretado.

Conhecer a formação →