Cada desarrollador mantiene una lista mental corta de códigos de estado HTTP. El mío solía ser 200, 404 y 500, y durante mucho tiempo eso fue suficiente para falsificar competencias. Luego pasé una semana construyendo una integración de pagos donde la API devolvía 402 por una tarjeta rechazada, 409 cuando volví a probar un cargo que ya había pasado y 429 cuando mis pruebas lo superaron demasiado rápido. De repente, la diferencia entre códigos era la diferencia entre una función funcional y un ticket de soporte. Construyo muchas herramientas web para Toolz.dev, y una referencia de código de estado con capacidad de búsqueda es una de esas cosas a las que busco constantemente, así que incorporé una en el sitio y escribí esta guía para acompañarla.
TL;Dr: Un código de estado HTTP es un número de tres dígitos que un servidor envía para describir el resultado de una solicitud. El primer dígito establece la clase: 1xx informativo, 2xx de éxito, 3xx de redirección, 4xx de error del cliente, 5xx de error del servidor. Busque cualquiera de ellos instantáneamente con el Herramienta de códigos de estado HTTP, que te permite buscar por número, nombre o palabra clave y cita el RFC que define cada uno.
Esta guía analiza qué son los códigos de estado, qué significa cada clase, los códigos específicos que vale la pena memorizar y cuáles suelen equivocarse las personas. Está dirigido a desarrolladores front-end que depuran llamadas API, desarrolladores back-end que deciden qué devolver y cualquier persona que realice SEO técnico y necesite redireccionamientos para comportarse.
¿qué es un código de estado HTTP?
Cada vez que su navegador o una aplicación solicita algo a través de la web, el servidor responde con una respuesta. La primera línea de esa respuesta contiene un código de estado: un número de tres dígitos, combinado con una breve frase de motivo como "OK" o "No encontrado" El código es el resumen legible por máquina de lo sucedido, y la frase de motivo es la etiqueta amigable para los humanos. Los clientes actúan sobre el número; la frase es para personas que leen registros.
Los códigos de estado los define el Grupo de Trabajo de Ingeniería de Internet, principalmente en RFC 9110, que consolidó las especificaciones HTTP más antiguas en 2022. Un registro central mantenido por la IANA enumera todos los códigos oficialmente reconocidos. Esa estandarización es lo que permite que un navegador escrito por una empresa hable con un servidor escrito por otra y acuerde lo que significa un 404. El Herramienta de códigos de estado HTTP refleja ese registro, enumerando cada código estándar con su significado y el RFC que lo define.
El modelo mental clave es que el primer dígito le indica la categoría y la categoría le indica quién es el responsable. Un código 4xx significa que el cliente envió algo mal. Un código 5xx significa que el servidor falló en una solicitud que estaba bien. Esa única distinción resuelve la mayoría de los argumentos de depuración sobre de quién es el error.
¿qué significan las cinco clases de códigos de estado?
Hay exactamente cinco clases, agrupadas por el dígito principal. Comprender la clase es más valioso que memorizar códigos individuales, porque te indica dónde buscar.
La clase 1xx es informativa. Estos códigos indican que el servidor recibió la solicitud y el procesamiento continúa. Son raros en el trabajo diario. El más conocido es 100 Continuar, y el más útil y moderno es 103 Early Hints, que permite al servidor decirle al navegador que comience a precargar recursos antes de que la respuesta completa esté lista.
La clase 2xx significa éxito. La solicitud fue recibida, comprendida y aceptada. 200 OK es el código de éxito diario, 201 Creado confirma que se creó un nuevo recurso y 204 Sin contenido dice "hecho, nada que enviar de vuelta", que es común para operaciones de eliminación.
La clase 3xx es redirección. El recurso vive en otro lugar o no ha cambiado desde la última vez que el cliente lo vio. Esta clase es donde vive el SEO, porque 301 y 302 indican a los motores de búsqueda si un movimiento es permanente. 304 No modificado es un caballo de batalla de almacenamiento en caché que ahorra un enorme ancho de banda.
La clase 4xx es un error del cliente. La solicitud fue mal formada, no autorizada o apuntaba a algo que no existe. 400, 401, 403, 404 y 429 todos viven aquí. Cuando veas un 4xx, comprueba cuál es tu código enviado antes de culpar al servidor.
La clase 5xx es un error del servidor. La solicitud era válida pero el servidor no pudo cumplirla. 500, 502, 503 y 504 son los que encontrará en incidentes de producción, que generalmente apuntan a una falla, un servicio sobrecargado o una dependencia ascendente rota.
¿qué códigos de estado HTTP debería conocer todo desarrollador?
No necesitas todos los códigos de más de sesenta en tu cabeza. Necesitas quizás quince y el resto buscas. Aquí está el conjunto de trabajo que creo que gana un lugar permanente en la memoria, con las situaciones que los desencadenan.
| Código | significación | Cuando lo ves |
|---|---|---|
| 200 | OK | Una solicitud normal y exitosa |
| 201 | Creado | Un POST o PUT creó un nuevo recurso |
| 204 | Sin contenido | Éxito con el cuerpo vacío, común después de ELIMINAR |
| 301 | Se movió permanentemente | Una URL movida definitivamente; Transferencias de clasificación SEO |
| 302 | Encontrado | Una redirección temporal; siga usando la URL anterior |
| 304 | No modificado | La copia almacenada en caché sigue siendo válida; no se envió ningún cuerpo |
| 400 | Mala petición | Sintaxis mal formada o encuadre de solicitud no válido |
| 401 | No autorizado | Falta la autenticación o falla |
| 403 | Prohibido | Autenticado pero no permitido |
| 404 | No encontrado | El recurso no existe |
| 409 | Conflicto | La solicitud choca con el estado actual |
| 422 | Contenido no procesable | Sintaxis válida, reglas de validación fallidas |
| 429 | Demasiadas solicitudes | Tarifa limitada; retroceda y vuelva a intentarlo |
| 500 | Error interno del servidor | Fallo inesperado del servidor |
| 503 | Servicio no disponible | Servidor sobrecargado o en mantenimiento |
Vale la pena reconocer pero no memorizar el resto del registro, desde 226 IM utilizados hasta 451 no disponibles por motivos legales. Para eso está exactamente una herramienta de búsqueda.
¿cuál es la diferencia entre 401 y 403?
Este par hace tropezar a casi todos, por lo que merece su propia sección. Ambos significan que se negó el acceso, pero por diferentes razones, y la diferencia cambia la forma en que debe responder su aplicación.
Un 401 No autorizado significa que la solicitud carece de autenticación válida. El servidor no sabe quién eres. O no envió credenciales o las que envió estaban incorrectas o caducaron. La respuesta correcta de su parte es iniciar sesión o actualizar el token. Según las especificaciones, una respuesta 401 debe incluir un encabezado WWW-Authenticate que le indique al cliente cómo autenticarse.
Un 403 Prohibido significa que el servidor sabe exactamente quién eres y de todos modos se niega. Estás autenticado pero no autorizado para este recurso en particular. Iniciar sesión nuevamente no ayudará, porque el problema son los permisos, no la identidad. Un usuario normal que acceda a un punto final exclusivo para administradores debería obtener un 403.
La regla rápida que uso: 401 es " ¿quién eres?" 403 es " Sé quién eres y no". Si está creando una API y desea generar los encabezados de autorización para probar estos flujos, el Generador de autenticación básico produce las credenciales codificadas que necesita.
¿por qué son importantes las redirecciones 301 versus 302 para SEO?
Las redirecciones son cuando los códigos de estado dejan de ser un detalle de implementación interna y comienzan a afectar sus clasificaciones de búsqueda. Cuando mueve una página, el código de estado que devuelve les dice a los motores de búsqueda qué hacer con la autoridad acumulada de URL 's anterior.
Un 301 Moved señala permanentemente que el movimiento es definitivo. Los motores de búsqueda eliminan la URL anterior de su índice con el tiempo, pasan las señales de clasificación a la nueva URL y actualizan sus enlaces. Este es el código que desea cuando cambia el nombre de una página, migra a HTTPS o consolida URL duplicadas. Usarlo correctamente es una de las correcciones más comunes en una auditoría técnica de SEO.
Un 302 encontrado indica un movimiento temporal. Los motores de búsqueda mantienen la URL original indexada porque les ha dicho que el cambio no es permanente. Si usa un 302 para un movimiento que es permanente, puede colocar su clasificación en una URL que ya no usa. He visto sitios perder visibilidad durante meses porque un marco se desvió de forma predeterminada a 302 durante una migración HTTPS.
También hay 307 Redireccionamiento Temporal y 308 Redireccionamiento Permanente, que se comportan como 302 y 301 pero garantizan que se conserven el método HTTP y el cuerpo. Utilice 307 y 308 para solicitudes que no sean de GET en las que cambiar el método rompería las cosas. Si está auditando cómo los rastreadores ven su sitio, combine este conocimiento con Generador de robots.txt y el Generador de metaetique para asegurarse de que toda la imagen de rastreo y redireccionamiento sea consistente. El Kit de herramientas para desarrolladores web la guía une estas piezas.
¿Cuáles son los códigos de error del servidor más comunes y cómo los depuras?
La clase 5xx es donde viven los incidentes de producción y cada código le apunta a una capa diferente de la pila. Saber cuál es el que ahorra tiempo real durante una interrupción.
Un error del servidor interno 500 es el resumen genérico. Significa que el código de su aplicación generó una excepción no controlada o alcanzó una condición que no pudo procesar. La solución casi siempre está en sus propios registros. Un 500 es el servidor que dice " algo se rompió y no tengo mejor palabra para ello" entonces el código te dice dónde buscar pero no qué salió mal.
Un 502 Bad Gateway y un 504 Gateway Timeout provienen de un servidor que actúa como puerta de enlace o proxy, como un equilibrador de carga o un proxy inverso frente a su aplicación. A 502 significa que el upstream envió algo no válido, a menudo porque su aplicación falló o no se está ejecutando. A 504 significa que el upstream tardó demasiado en responder y la puerta de enlace dejó de esperar. Si corre detrás de Nginx, una CDN o un equilibrador de carga en la nube, estos son los códigos que verá cuando lo que está detrás del proxy no sea saludable.
Un servicio 503 no disponible significa que el servidor no puede manejar temporalmente la solicitud, generalmente porque está sobrecargada o en mantenimiento. Las respuestas 503 de buen comportamiento incluyen un encabezado Retry-After que indica a los clientes cuándo regresar. Enviar un 503 durante el mantenimiento planificado es la forma correcta y segura de SEO de eliminar un sitio brevemente, porque les dice a los motores de búsqueda que regresen más tarde en lugar de asumir que las páginas se han ido. Para una mirada más amplia al diagnóstico de problemas web, el Herramientas de productividad para desarrolladores la guía cubre el conjunto de herramientas más amplio.
¿Qué pasa con los códigos de estatus menos comunes?
Más allá del conjunto de trabajo, el registro contiene una larga cola de códigos que encontrarás ocasionalmente, y reconocerlos ahorra media hora confusa. Algunos merecen un recorrido rápido.
En la familia 2xx, 206 Contenido parcial impulsa descargas reanudables y transmisión de video. Cuando un cliente envía un encabezado de rango solicitando bytes 500 a 999 de un archivo, el servidor responde 206 solo con esa porción. Así es como se reanuda una descarga en pausa en lugar de comenzar de nuevo, y cómo un navegador busca llegar a la mitad de un video sin buscarlo todo primero.
En la familia 4xx, 410 Gone es una versión más fuerte y deliberada de 404. Donde 404 dice " No pude encontrarlo" 410 dice " Estaba aquí, desapareció permanentemente, deja de preguntar". Usar 410 para el contenido que ha eliminado intencionalmente ayuda a los motores de búsqueda a dejarlo caer más rápido que un 404. Otro útil es 451 No disponible por razones legales, cuyo número es un guiño a la novela Fahrenheit 451, devuelto cuando el contenido es bloqueado por una orden legal como un derribo o una orden judicial.
También hay 418 I'm a Teapot, un código registrado real de una especificación del Día de los Inocentes de 1998 que devuelve una tetera cuando se le pide que prepare café. No se utiliza para el tráfico normal, pero aparece como un huevo de Pascua en algunas API, y es un pequeño recordatorio de que las personas que escribieron estos estándares tenían sentido del humor. La herramienta enumera todos estos para que puedas buscar cualquier cosa con la que te encuentres sin adivinar.
¿cómo ayuda la herramienta Códigos de estado HTTP?
La herramienta es deliberadamente simple, porque el trabajo es simple: tienes un código o un síntoma y quieres el significado rápido. Puede buscar por número, por la frase de razón como "no encontrado" o por una palabra clave de la descripción como "redirect" o "rate límite" Puede filtrar a una sola clase para explorar solo las redirecciones o solo los errores del servidor. Cada entrada muestra la frase de motivo, una explicación sencilla de cuándo se aplica el código y el RFC que lo define, para que pueda confirmar el comportamiento frente a la fuente principal.
Debido a que todo el registro se carga en su navegador, la búsqueda es instantánea y funciona sin conexión una vez que la página está abierta. Nada de lo que buscas se envía a ninguna parte. Es el tipo de referencia que mantengo fijada en una pestaña mientras construyo una API, justo al lado de Analizador de agentes de usuario para inspeccionar encabezados de solicitud.
Preguntas frecuentes
¿cuáles son las cinco clases de códigos de estado HTTP?
Los códigos de estado HTTP se agrupan por su primer dígito: 1xx informativo, 2xx exitoso, 3xx redirección, 4xx error del cliente y 5xx error del servidor. La clase le indica de un vistazo si una solicitud tuvo éxito, fue redirigida o falló en el lado del cliente o del servidor, lo que generalmente es suficiente para saber dónde comenzar a depurar.
¿qué significa un código de estado 404?
Un 404 No encontrado significa que el servidor no pudo encontrar el recurso solicitado. Es posible que la URL esté mal escrita, que la página se haya eliminado o que el enlace esté roto. Es un código de error del cliente, por lo que la solicitud llegó al servidor pero apuntó a algo que no existe allí.
¿Cuál es la diferencia entre una redirección 301 y 302?
Un 301 Moved le dice permanentemente a los clientes y motores de búsqueda que el recurso se ha movido para siempre, por lo que actualizan sus enlaces y transfieren señales de clasificación a la nueva URL. Un 302 encontrado es una redirección temporal, por lo que la URL original debería seguir utilizándose para futuras solicitudes y los motores de búsqueda la mantienen indexada.
¿qué significa un error interno del servidor 500?
Un error interno del servidor 500 es un mensaje genérico que significa que el servidor sufrió una condición inesperada que no pudo manejar. Señala un problema en el servidor en lugar de en la solicitud, por lo que la solución generalmente está en el código de la aplicación o la configuración, y sus propios registros del servidor son el lugar para buscar.
¿cuándo una API debería devolver 400 frente a 422?
Devuelve 400 Solicitud incorrecta cuando la solicitud en sí tiene un formato incorrecto, como JSON no válido o falta un encabezado requerido. Devuelve 422 Contenido no procesable cuando la sintaxis es válida pero los datos fallan en las reglas comerciales o de validación, como un correo electrónico que ya está tomado o un valor fuera de rango.
¿qué es un código de 429 Demasiadas solicitudes?
Un 429 Demasiadas solicitudes significa que el cliente ha enviado demasiadas solicitudes en poco tiempo y su tarifa es limitada. La respuesta a menudo incluye un encabezado Retry-After que le indica al cliente cuánto tiempo esperar antes de volver a intentarlo, y los clientes que se portan bien lo honran con un retroceso exponencial.
¿la referencia del código de estado HTTP es de uso gratuito?
Sí. La herramienta es completamente gratuita, sin registro ni límites, y funciona sin conexión una vez que la página se ha cargado porque la lista completa se ejecuta en su navegador. Nada de lo que buscas se envía a un servidor, por lo que es seguro y rápido de usar durante la depuración.
