Resposta

Definição

Depois de receber uma requisição, o servidor devolve uma resposta. O cliente usa esse retorno para saber o que aconteceu e escolher o próximo estado da interface. A resposta carrega o resultado em três camadas: um status que resume o processamento, cabeçalhos que descrevem o formato e um corpo que pode trazer o conteúdo útil da operação. Você lê essas camadas em conjunto para decidir se a tela mostra sucesso, erro ou uma nova pergunta.

Status, cabeçalhos e corpo

O status oferece um resumo rápido do processamento. Os cabeçalhos descrevem o formato e outras condições da mensagem, como o tipo de conteúdo e a localização do recurso criado. O corpo pode carregar conteúdo JSON, HTML, uma imagem ou nenhum conteúdo, conforme a operação. Um status de sucesso sem o corpo esperado ainda é uma falha de contrato, porque a interface que esperava os campos de um registro não tem o que mostrar.

HTTP/1.1 201 Created
Content-Type: application/json
Location: /contatos/42

{"id":42,"nome":"Ana"}

Como ler uma resposta na interface

O frontend deve tratar sucesso e falha com mensagens claras. Um status de erro não explica sozinho o ajuste necessário, por isso o contrato da API também precisa registrar a estrutura do conteúdo devolvido. Quando o status indica sucesso, a interface confere o corpo para preencher a tela. Quando indica erro, ela usa a mensagem do corpo para orientar a correção, em vez de repetir um texto genérico.

Falha comum e como verificar

A falha mais comum é confiar apenas no status e ignorar o corpo da resposta. Uma operação pode responder com sucesso e devolver um conteúdo vazio, ou responder com erro e trazer no corpo a explicação que a interface não mostra. Para verificar, chame a operação com uma entrada conhecida e confira as três camadas: o status, os cabeçalhos e o conteúdo do corpo. Depois, force um erro de validação e veja se a mensagem devolvida aponta o campo necessário. Quando o frontend trata todo status de erro com o mesmo texto, a resposta está sendo lida pela metade.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, a resposta orienta a interface depois de uma ação como registrar um contato ou consultar uma lista.

Conhecer a formação →