Los status codes son un idioma
Aprende a leer lo que el servidor te dice con los códigos de respuesta
⏱ Estim. ~5 min
01 · Leer
Cada respuesta HTTP empieza con un status code. Es lo primero que dice el servidor — antes de que leas el cuerpo.
Los códigos se agrupan por el primer dígito: - 2xx = éxito (todo bien) - 4xx = error del cliente (te equivocaste) - 5xx = error del servidor (se equivocaron ellos)
Conociendo esto, puedes diagnosticar cualquier problema de API en segundos.
Puntos clave
- 200 = OK — la solicitud tuvo éxito, hay datos en el cuerpo
- 401 = Unauthorized — necesitas autenticarte
- 403 = Forbidden — estás autenticado pero sin permisos
- 404 = Not Found — esa ruta no existe
- 429 = Too Many Requests — te limitaron por tráfico
- 500 = Internal Server Error — bug de ellos, no tuyo
02 · Práctica de terminal
Vamos a provocar errores a propósito y mirar la respuesta. Usa -i para ver la línea de estado. Primero pide una ruta que no existe.
(Esta sección es interactiva — activa JavaScript para usarla.)
03 · Práctica de terminal
Ahora provoca un 401 — un endpoint protegido que requiere autenticación.
(Esta sección es interactiva — activa JavaScript para usarla.)
04 · Práctica de terminal
Ahora un 500 — este es problema del servidor, no tuyo.
(Esta sección es interactiva — activa JavaScript para usarla.)
05 · Emparejar
Empareja cada status code HTTP con su significado.
(Esta sección es interactiva — activa JavaScript para usarla.)
06 · Quiz
Llamas a una API y recibes HTTP/2 429. ¿Qué deberías hacer?
- Arreglar tu código — enviaste una solicitud mal formada
- Revisar tu API key — seguramente venció
- Esperar y volver a intentar — te limitaron por tráfico
- El servidor se cayó — probar otro endpoint
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.