~/VibeHandbook
PDF grátis

Capítulo 03 · 05

Códigos de status: deu certo?

Toda response volta com um código de status de três dígitos — o veredito instantâneo do servidor sobre como a request foi. Eles são agrupados pelo primeiro dígito:

  • 2xx — sucesso. Funcionou. 200 OK é o "aqui está o que você pediu" do dia a dia.
  • 3xx — redirecionamento. "Não está aqui, vá olhar ali." Comum e inofensivo; seu navegador segue automaticamente.
  • 4xx — você (o cliente) errou. O famoso é o 404 Not Found — você pediu um path que não existe. (Também 401/403 — você não está logado, ou não tem permissão.)
  • 5xx — o servidor errou. 500 Internal Server Error significa que o código do próprio servidor quebrou ou travou ao processar sua request.

Vale tatuar a divisão 4xx/5xx no cérebro, porque ela diz onde procurar:

  • Um 404 significa que a request estava errada — geralmente uma ruim ou um path digitado errado. Olhe o que está sendo pedido.
  • Um 500 significa que o servidor caiu. Sua request estava certa; o código de back-end quebrou. Olhe os logs do servidor, não a URL.

Quando algo quebra num app criado com vibe coding, "é um 4xx ou um 5xx?" é uma das perguntas mais rápidas para começar a triagem.

   código de status
        │
        ├── 2xx ──▶ SUCESSO         funcionou (200 OK)
        │
        ├── 3xx ──▶ REDIRECIONAMENTO   "vai olhar ali" (seguido automaticamente)
        │
        ├── 4xx ──▶ erro do CLIENTE   SUA request estava errada  ─▶ confira a URL/path
        │
        └── 5xx ──▶ erro do SERVIDOR  o back-end quebrou         ─▶ confira os logs do servidor

Quer offline?

Baixe o livro inteiro em PDF ou EPUB — grátis.