¿Qué es Búsqueda de códigos de estado HTTP?
Los códigos de estado HTTP son los números de tres dígitos que un servidor web devuelve con cada respuesta, indicando al cliente (navegador, app o consumidor de API) si la solicitud tuvo éxito, necesita una redirección o falló — y por qué. Están estandarizados por la IETF y se usan de forma idéntica en todos los servidores web, navegadores y lenguajes de programación, lo que los convierte en una de las referencias de depuración más universales del desarrollo de software.
Esta herramienta de búsqueda cubre los códigos más comunes en las cinco categorías — informativo (1xx), éxito (2xx), redirección (3xx), error del cliente (4xx) y error del servidor (5xx) — con explicaciones en lenguaje sencillo de lo que realmente significa cada uno en la práctica, no solo la definición formal de la RFC.
Cuándo Usar Esta Calculadora
- Depurar una integración de API en la que una solicitud falla y necesitas entender qué significa realmente el código de estado
- Decidir qué código de estado devolver desde tu propia API para una condición de error determinada
- Enseñar o aprender los fundamentos de HTTP en un curso de desarrollo web o bootcamp
- Escribir middleware de manejo de errores que necesita distinguir entre distintos casos 4xx y 5xx
- Investigar por qué una redirección no está funcionando verificando si se devolvió 301 o 302
- Solucionar problemas de CORS donde el navegador muestra un error de red pero el servidor devolvió 200
Pasos:
- Escribe un código de estado (como 404) o una palabra clave (como "forbidden") en el cuadro de búsqueda.
- Filtra por categoría usando los botones 1xx-5xx si quieres explorar un rango específico.
- Lee la descripción en lenguaje sencillo de lo que significa el código y cuándo suele devolverse.
- Úsalo como referencia rápida al depurar respuestas de API o al diseñar el manejo de errores.
Fórmula
1xx: Informativo — solicitud recibida, continuando el proceso
2xx: Éxito — la solicitud se recibió y aceptó correctamente
3xx: Redirección — se necesita una acción adicional para completar la solicitud
4xx: Error del cliente — la solicitud contiene sintaxis incorrecta o no se puede completar
5xx: Error del servidor — el servidor no pudo cumplir una solicitud válida
Casos de uso
- Entender rápidamente un código de estado desconocido devuelto por una API con la que estás integrando
- Decidir qué código de estado devolver desde tu propia API para una condición de error determinada
- Depurar por qué falla una solicitud comprobando lo que realmente implica un código específico
- Enseñar o aprender los fundamentos de HTTP en un curso de desarrollo web
- Escribir lógica de manejo de errores precisa que distinga entre distintos casos 4xx y 5xx
Beneficios Clave
- Cada código de estado de uso común en una referencia buscable
- Explicaciones en lenguaje sencillo, no solo el texto formal de la RFC
- Filtra al instante por categoría (de 1xx a 5xx)
- Gratis, rápido, sin necesidad de registro
Consejos Profesionales
- Reserva los códigos 5xx estrictamente para fallos del lado del servidor — nunca los uses para señalar errores de entrada del cliente
- Usa 429 con un encabezado Retry-After al limitar la tasa, para que los clientes bien diseñados sepan cuándo reintentar
- Prefiere 404 antes que una página de error genérica siempre que un recurso realmente no exista — es mejor tanto para los usuarios como para los motores de búsqueda
- Al diseñar una API, elige códigos 4xx específicos (422, 409, 400) en lugar de dejar todo por defecto en un 400 genérico
Errores Comunes que Debes Evitar
- Devolver 200 OK para una solicitud que en realidad falló, ocultando errores a las herramientas de monitoreo
- Confundir 401 (no autenticado) con 403 (autenticado pero no autorizado)
- Usar 302 para una redirección que debería ser permanente (301), perjudicando el SEO
- Tratar todos los errores 4xx y 5xx por igual en el manejo de errores del lado del cliente en lugar de diferenciar según el código específico
Términos Clave Explicados
- Línea de estado: La primera línea de una respuesta HTTP, que contiene el código de estado y una breve frase explicativa
- Idempotente: Una propiedad de ciertos métodos HTTP donde repetir la misma solicitud tiene el mismo efecto que hacerlo una sola vez
- Cadena de redirección: Una secuencia de múltiples redirecciones que sigue un navegador antes de llegar al recurso final
- Limitación de tasa: Restringir cuántas solicitudes puede hacer un cliente en una ventana de tiempo determinada, a menudo señalada con 429
Conceptos relacionados
- Formateador JSON:
- Validador JSON:
- Probador de regex:
- Codificador/decodificador URL:
- Codificador/decodificador Base64:
Ejemplo
Buscar "429" devuelve "Too Many Requests" — el código que devuelven las API cuando has excedido un límite de tasa, indicándote que reduzcas la velocidad y reintentes tras una espera.
Interpretación de sus resultados
Los códigos de estado HTTP se agrupan en cinco clases según su primer dígito. Los 1xx son informativos y rara vez se ven en el código de las aplicaciones. Los 2xx confirman el éxito: 200 OK es el más común, pero 201 Created y 204 No Content también son frecuentes en las API REST. Los 3xx gestionan la redirección, siendo 301 (permanente) y 302 (temporal) los más importantes.
Los errores 4xx indican que algo anda mal con la solicitud del cliente. Los más comunes son 400 Bad Request (sintaxis incorrecta), 401 Unauthorized (sin autenticar), 403 Forbidden (sin autorización), 404 Not Found (el recurso no existe) y 429 Too Many Requests (límite de peticiones superado). El uso correcto de códigos 4xx específicos hace que su API sea mucho más fácil de depurar que devolver un 400 genérico para todo.
Los errores 5xx significan que falló el servidor. 500 es el error interno general, 502 Bad Gateway indica un problema en un servidor ascendente y 503 Service Unavailable normalmente significa que el servidor está sobrecargado o en mantenimiento. Al depurar errores 5xx, revise los registros del servidor en lugar de la respuesta del cliente, ya que el código de estado rara vez revela la causa raíz.