O que é Status code HTTP?

O significado do código da resposta

Status code HTTP é um código de três algarismos que comunica o resultado ou o andamento de uma requisição. O primeiro algarismo identifica a família, e o código completo informa uma situação mais específica. Ele deve ser interpretado junto com o método, os cabeçalhos e o contrato do serviço.

Ao abrir um contato, você pode receber 200 OK com o registro solicitado. Se o recurso não estiver disponível, pode receber 404 Not Found. Os dois são respostas HTTP, embora levem a comportamentos diferentes na interface.

Uma falha de conexão pode ocorrer sem qualquer código HTTP. Nesse caso, não houve uma resposta acessível ao cliente para classificar. Tratar esse cenário como se fosse automaticamente um 500 esconde uma diferença útil para a investigação.

As cinco famílias

A família 1xx relata informações sobre o andamento da comunicação. A família 2xx indica sucesso conforme o significado específico de cada código.

A família 3xx reúne situações que exigem uma ação adicional para concluir a requisição ou utilizar a representação. Ela inclui redirecionamentos e também 304 Not Modified, que permite reutilizar conteúdo armazenado. Portanto, nem todo 3xx significa uma nova página para abrir.

A família 4xx indica que o servidor percebeu um problema na requisição ou no acesso solicitado. A família 5xx indica falha do servidor ao atender uma requisição aparentemente válida. Essas categorias orientam a análise, mas não identificam automaticamente o componente responsável pela causa original.

Códigos parecidos exigem tratamentos diferentes

201 Created informa a criação de um recurso. 202 Accepted informa aceitação para processamento, que pode continuar depois da resposta. 204 No Content indica sucesso sem conteúdo no corpo, dispensando uma tentativa de leitura de JSON.

401 Unauthorized indica ausência de credenciais válidas para o recurso. 403 Forbidden informa que o servidor entendeu a requisição, mas recusa seu atendimento. Repetir o login não resolve necessariamente um 403, pois o perfil autenticado pode não ter a permissão exigida.

404 pode indicar que o recurso não foi encontrado ou que o servidor não deseja revelar sua existência. 405 indica método não permitido para o recurso. Já 429 informa excesso de requisições e pode vir acompanhado de orientação sobre quando tentar novamente.

201 → contato criado
202 → importação aceita, ainda sem conclusão
204 → operação concluída sem corpo
401 → credencial ausente ou inválida
403 → operação recusada
429 → limite de requisições excedido

Ler o código junto com o contrato

Um 200 sozinho não comprova que o conteúdo veio no formato esperado. Um proxy ou uma página de login pode entregar HTML quando a integração esperava JSON. Confira o cabeçalho de tipo e o corpo antes de atribuir sucesso à função do produto.

Como usar o código na investigação

Na aba Network, selecione a chamada e compare o status com o método e o endereço. Leia os detalhes úteis da resposta e relacione o horário aos logs disponíveis. Um código 502, por exemplo, pode ser produzido por um intermediário ao receber uma resposta inválida de outro servidor.

Para definir novas tentativas, considere o efeito da chamada e as instruções da API. Repetir toda resposta 5xx sem proteção contra duplicação pode executar novamente uma ação já aplicada. O verbete de resposta HTTP reúne as outras partes desse retorno.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Os códigos HTTP orientam o tratamento dos resultados e das falhas das chamadas feitas pela interface.

Conhecer a formação →