Logótipo Loona AutomationLoona Ferramentas de Programação
Início › Referência

Referência de Códigos de Estado HTTP

Em resumo: todos os códigos de estado que importam no desenvolvimento diário — o que cada um significa, quando é utilizado, e as armadilhas (401 vs 403, 302 vs 307) — filtrável enquanto escreve.
🔒 Privado por conceção: tudo funciona no seu navegador neste dispositivo. A sua entrada nunca é carregada para um servidor.
CódigoNomeSignificado
100ContinuarO cliente deve continuar com o corpo do pedido
101Mudança de ProtocolosAtualização de protocolo aceite (por ex., para WebSocket)
200OKO pedido teve sucesso — a resposta de sucesso predefinida
201CriadoFoi criado um novo recurso (sucesso típico de POST)
202AceiteEm fila para processamento assíncrono, ainda não concluído
204Sem ConteúdoSucesso com um corpo intencionalmente vazio
301Movido PermanentementeO recurso tem um novo URL permanente — atualize as ligações; o valor SEO transfere
302EncontradoRedirecionamento temporário (historicamente mal utilizado; ver 303/307)
303Ver OutroRedirecionar para um GET noutro URL (post/redirect/get)
304Não ModificadoA cópia em cache ainda é válida — revalidar via ETag/Last-Modified
307Redirecionamento TemporárioRedirecionamento temporário preservando método e corpo
308Redirecionamento PermanenteRedirecionamento permanente preservando método e corpo
400Pedido InválidoO servidor não consegue analisar/compreender o pedido
401Não AutorizadoAutenticação necessária ou falhou (apesar do nome, significa não autenticado)
403ProibidoAutenticado ou não, o acesso é recusado
404Não EncontradoNenhum recurso neste URL
405Método Não PermitidoO método HTTP não é suportado para este recurso
406Não AceitávelNenhuma representação corresponde aos cabeçalhos Accept
408Tempo de Espera do Pedido ExcedidoO cliente demorou demasiado a enviar o pedido
409ConflitoConflito de estado, por ex., colisão de edição ou criação duplicada
410Removido PermanentementeRemovido permanentemente (mais forte do que 404 — utilizado deliberadamente)
411Comprimento ObrigatórioO cabeçalho Content-Length é obrigatório
413Conteúdo Demasiado GrandeO corpo do pedido excede os limites do servidor
414URI Demasiado LongoO URL excede os limites do servidor
415Tipo de Media Não SuportadoO Content-Type do pedido não é suportado
418Sou um BuleCódigo de piada RFC 2324, ocasionalmente utilizado para recusar fazer café
422Conteúdo Não ProcessávelA sintaxe está bem mas a semântica falha a validação (as APIs adoram esta)
425Demasiado CedoServidor não disposto a processar um pedido possivelmente repetido
429Demasiados PedidosLimite de taxa atingido — recue, respeite o Retry-After
500Erro Interno do ServidorFalha genérica do lado do servidor
501Não ImplementadoO servidor não suporta a funcionalidade
502Gateway InválidoUm proxy/gateway recebeu uma resposta inválida do upstream
503Serviço IndisponívelSobrecarregado ou em baixo para manutenção — frequentemente temporário, pode trazer Retry-After
504Tempo de Espera do Gateway ExcedidoUm proxy/gateway excedeu o tempo de espera pelo upstream
505Versão HTTP Não SuportadaA versão HTTP no pedido não é suportada

Sobre

Os códigos de estado são o resumo de um número do servidor de cada resposta, agrupados por classe: 1xx informativo, 2xx sucesso, 3xx redirecionamento, 4xx o cliente errou, 5xx o servidor errou. A tabela dá os códigos que os programadores em atividade realmente encontram, com as nuances que importam na prática — 401 significa não autenticado apesar do seu nome, 403 é uma recusa independentemente do início de sessão, 422 é a falha de validação da API, 429 exige recuo. Códigos não listados (a cauda longa de 1xx e códigos experimentais) são raros o suficiente para que só a classe lhe diga como tratá-los.

Perguntas Frequentes

Qual é a diferença entre 401 e 403?

401: não sabemos quem é (autentique-se). 403: sabemos, e mesmo assim não pode.

302 ou 307 para um redirecionamento temporário?

O 307 preserva o método e o corpo; o 302 historicamente permitia aos clientes mudar POST para GET. Trabalho novo deve utilizar 307 (ou 308 para permanente).

Ferramentas de Programador Relacionadas

Incorpore esta ferramenta no seu site — grátis

Adicione esta ferramenta ao seu próprio site ou blogue — é completamente gratuita, não precisa de registo e mostra sempre a versão mais recente. Copie o código abaixo e cole-o na sua página onde quer que a ferramenta apareça. Manter a pequena linha de crédito “Powered by Loona Automation” sob a incorporação ajuda a manter esta ferramenta gratuita — mas é livre de a estilizar ou remover; a ferramenta funciona de qualquer forma.