O que é Resposta?

O que a resposta HTTP informa

Resposta HTTP é a mensagem que um servidor envia em retorno a uma requisição. Ela pode entregar uma página, confirmar a criação de um registro, indicar um redirecionamento ou comunicar uma falha. Ao interpretar o retorno, o cliente considera também o método utilizado e o contrato do serviço acessado.

Imagine que você envia um formulário de contato. Receber uma resposta significa que algum servidor devolveu uma mensagem, mas ainda é preciso ler seu significado. O retorno pode confirmar o cadastro ou informar que o email foi recusado.

Em uma aplicação com intermediários, a resposta também pode vir de um proxy ou de um serviço de cache. Se a aplicação estiver indisponível, por exemplo, o proxy pode devolver um erro sem que o código de cadastro tenha sido executado. Essa diferença importa ao investigar a origem do problema.

Como ler status, cabeçalhos e corpo

O código de status resume o significado da resposta. 201 Created informa a criação de um recurso, enquanto 404 Not Found indica que o servidor não encontrou uma representação atual do recurso ou não deseja informar sua existência. A explicação específica da aplicação pode aparecer no corpo.

Os cabeçalhos complementam essa leitura. Content-Type informa o formato do conteúdo, e Location pode indicar o endereço do recurso criado. Outros cabeçalhos controlam cache ou transportam instruções de sessão, conforme o serviço.

O corpo pode conter JSON, HTML, uma imagem ou outro formato. Algumas respostas não têm corpo por definição, como 204 No Content. Se uma atualização retorna esse status conforme o contrato, a interface deve confirmar o resultado sem tentar ler um objeto JSON inexistente.

Uma resposta de criação

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

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

O exemplo representa uma API fictícia e omite detalhes de transporte. O código informa a criação, o cabeçalho Location aponta o recurso e o corpo traz os campos que esse contrato escolheu devolver. Outra API pode retornar uma estrutura diferente para a mesma finalidade.

Sucesso HTTP e processamento posterior

O código 202 Accepted informa que a requisição foi aceita para processamento. Ele não confirma a conclusão do trabalho. Em uma importação de contatos, a resposta inicial pode chegar enquanto os registros ainda aguardam processamento.

Você precisa acompanhar a tarefa pelo mecanismo documentado, como uma consulta de status ou uma notificação posterior. A interface pode mostrar “importação recebida” nesse primeiro momento e reservar a confirmação final para quando o resultado estiver disponível.

Como tratar falhas sem perder a informação útil

Uma resposta de erro pode identificar um campo que precisa de correção. A interface deve apresentar uma orientação adequada à situação, preservando as informações úteis do contrato. Detalhes internos, como consultas do banco e caminhos de arquivos, não devem ser exibidos automaticamente para visitantes.

Teste um cadastro válido e um cadastro recusado no ambiente de desenvolvimento. Confira o status, o formato e o conteúdo recebido, além da mensagem apresentada na tela. Se a comunicação terminar sem uma resposta, trate a ausência de confirmação separadamente de uma recusa explícita.

A API define quais retornos você pode esperar e como cada um deve ser interpretado pela integração.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

A resposta HTTP orienta o que a interface apresenta depois de consultar uma lista ou enviar um cadastro.

Conhecer a formação →