Status codes são uma linguagem
Aprenda o que o server está dizendo com os códigos de resposta
⏱ Estim. ~5 min
01 · Ler
Toda resposta HTTP começa com um status code (código de status). É a primeira palavra do server — antes de você ler o corpo.
Status codes são agrupados pelo primeiro dígito:- 2xx = Sucesso (tudo certo) - 4xx = Erro do client (você fez algo errado) - 5xx = Erro do server (eles fizeram algo errado)
Sabendo disso, você diagnostica qualquer problema de API em segundos.
Pontos-chave
- 200 = OK — a requisição teve sucesso, o corpo tem os dados
- 401 = Unauthorized — você precisa se autenticar
- 403 = Forbidden — autenticado, mas sem permissão
- 404 = Not Found — esse path não existe
- 429 = Too Many Requests — você atingiu o rate limit
- 500 = Internal Server Error — bug deles, não seu
02 · Prática de terminal
Vamos provocar erros de propósito e ver a resposta. Use -i para ver a linha de status. Comece pedindo um path que não existe.
(Esta seção é interativa — ative o JavaScript para usar.)
03 · Prática de terminal
Agora provoque um 401 — um endpoint protegido que exige autenticação.
(Esta seção é interativa — ative o JavaScript para usar.)
04 · Prática de terminal
Agora um 500 — esse é problema do server, não seu.
(Esta seção é interativa — ative o JavaScript para usar.)
05 · Combinar
Faça o par entre cada status code HTTP e o significado.
(Esta seção é interativa — ative o JavaScript para usar.)
06 · Quiz
Você chamou uma API e recebeu HTTP/2 429. O que você deve fazer?
- Arrumar seu código — você enviou uma requisição malformada
- Checar sua API key — provavelmente expirou
- Esperar e tentar de novo — você atingiu o rate limit
- O server caiu — tente outro endpoint
Outras lições deste capítulo
⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.
※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.