Referência para desenvolvedores

Códigos de status HTTPcom pistas de diagnóstico

Busque um número ou termo, filtre pela classe e confira um exemplo com sua fonte.

códigos de status HTTP

Número ou termo

Resultados

1xx Informação
2xx Sucesso
3xx Redirecionamento
4xx Erro do cliente
5xx Erro do servidor

Resposta selecionada

502 Bad Gateway

5xx Erro do servidor

Significado: Gateway ou proxy recebeu resposta inválida do servidor anterior.

Situação comum: A conexão ou resposta do serviço anterior falhou.

Verifique primeiro: Confira logs do proxy e saúde do serviço; diferencie de 504.

Resposta HTTP ilustrativa

Exemplo HTTP/1.1 fictício; cabeçalhos e corpo reais podem variar.

HTTP/1.1 502 Bad Gateway
Content-Type: application/problem+json

{"title":"Bad Gateway","status":502}

A busca filtra dados incluídos no navegador. Só um clique voluntário em um link abre uma fonte externa.

Classe da resposta

28 de 28 códigos selecionados · exibindo 502

Registro IANA atualizado em 15 set 2025Seleção conferida em 23 set 2026

Um número no log da API não mostra sozinho se a falha começou na requisição, no gateway ou no servidor de origem. Esta referência de códigos de status HTTP reúne o sentido do protocolo, uma resposta ilustrativa e o primeiro ponto a verificar.

Use os códigos de status HTTP para escolher por onde investigar e depois confira cabeçalhos, corpo e logs reais. A seleção não testa sites em tempo real nem substitui o registro completo da IANA.

Por que consultar estes códigos de status HTTP?

O número indica um caminho, mas a camada envolvida define a primeira checagem.

Resposta inválida ou espera esgotada

Entre os códigos de status HTTP, 502 significa resposta inválida do servidor anterior recebida pelo gateway; 504 significa falta de resposta no prazo. Cada situação pede uma investigação diferente.

Dois caminhos pelo gateway: um recebe uma resposta quebrada e outro espera até o relógio expirar

Da busca à evidência

A ficha 429 mostra Retry-After e o que conferir primeiro. Cada código selecionado também aponta para o RFC de definição e o registro da IANA.

Uma busca reduz várias fichas a uma resposta com relógio de nova tentativa e lista de conferência

Entenda o sinal antes de agir

01

Ache o número ou significado

A busca vazia mostra os 28 itens. Pesquise número, nome em inglês ou significado em português; as cinco classes filtram o resultado já enviado.

02

Compare respostas parecidas

502 e 504 separam resposta inválida de tempo esgotado. O exemplo 429 traz Retry-After; 302 e 307 diferem no tratamento do método.

03

Confirme na troca real

Os trechos HTTP/1.1 são inventados. Confira RFC, cabeçalhos e logs reais; um código não encontrado pode estar apenas fora da seleção.

O que cada item reúne

Cinco classes pesquisáveis localmente

A lista de códigos HTTP reúne 28 entradas escolhidas de 1xx a 5xx. Número, nome e significado são pesquisados sem solicitação de rede.

Formato de resposta e cabeçalhos

204 e 304 não têm corpo nos exemplos; 401, 405 e 429 exibem cabeçalhos de autenticação, métodos permitidos ou nova tentativa.

Acesso à definição original

Links para RFC e IANA ajudam a separar códigos de resposta HTTP de falhas internas da aplicação.

Alcance e limites da interpretação

Seleção, não registro inteiro
São 28 entradas. Um número específico de fornecedor que não apareça não é necessariamente inválido. Consulte a IANA para o registro completo; não há página separada por código.
Sem diagnóstico ao vivo
A busca por erros HTTP não consulta URLs nem lê logs. O status 502 sozinho não revela se a falha está na CDN, no gateway ou no servidor de origem.
Exemplos são fictícios
Os trechos mostram texto HTTP/1.1 criado para ilustração. HTTP/2, HTTP/3 e os corpos reais podem ter outro formato.
Repetir depende do contexto
429 e 503 podem trazer Retry-After, mas repetir uma gravação exige conferir idempotência e política do serviço.

Dúvidas sobre códigos de status HTTP

Quais são as classes dos códigos de status HTTP?

1xx informa, 2xx indica sucesso, 3xx redireciona, 4xx trata de erro do cliente e 5xx de erro do servidor. Esta referência de códigos de status HTTP seleciona 28 casos e leva ao registro completo.

Qual é a diferença entre 401 e 403?

401 indica ausência de autenticação válida e deve apresentar um desafio WWW-Authenticate. Em 403, o servidor entende a requisição, mas a recusa mesmo que conheça a identidade.

Quando usar 410 em vez de 404?

404 informa que não há representação atual, sem dizer se a ausência é permanente. 410 é mais específico quando se sabe que o recurso foi removido definitivamente.

O que fazer ao receber 429?

Leia Retry-After, se houver, e as regras de limite do serviço. Antes de repetir uma gravação, verifique se a operação aceita nova tentativa com segurança.

Qual é a diferença entre 502 e 504?

502 significa que o gateway recebeu resposta inválida do servidor anterior; 504 indica que não recebeu resposta a tempo. Confira logs do proxy e da origem para achar a causa.

Faltou um código ou uma verificação?

Consultar códigos de status HTTP

Ache o número, compare o exemplo com os cabeçalhos reais e leia a definição antes de alterar cliente ou servidor.