Códigos de Estado HTTP

Referencia completa de todos los códigos de estado HTTP con descripciones y casos de uso.

¿Qué son los Códigos de Estado HTTP?

Los códigos de estado HTTP son respuestas numéricas de tres dígitos que un servidor web envía al navegador o cliente cuando se realiza una solicitud. Estos códigos indican si la solicitud fue exitosa, si hubo un error, o si se requiere alguna acción adicional. Comprender estos códigos es fundamental para desarrolladores web, administradores de sistemas y especialistas en SEO.

Los códigos se agrupan en cinco categorías según su primer dígito: 1xx (Informativos) indican que la solicitud fue recibida y el proceso continúa; 2xx (Éxito) confirman que la solicitud se completó correctamente; 3xx (Redirecciones) indican que se necesita realizar una acción adicional, generalmente una redirección; 4xx (Error del Cliente) señalan que hubo un problema con la solicitud enviada; y 5xx (Error del Servidor) indican que el servidor no pudo completar una solicitud válida.

Códigos más comunes

200 OK: La solicitud fue exitosa. Es el código más común y significa que el recurso se entregó correctamente.

301 Moved Permanently: El recurso se movió permanentemente a una nueva URL. Es crucial para SEO porque transfiere el "link juice" a la nueva ubicación.

404 Not Found: El recurso solicitado no existe. Es el error más común que encuentran los usuarios al navegar por la web.

500 Internal Server Error: Error genérico del servidor cuando algo sale mal pero no puede ser más específico.

Preguntas frecuentes

¿Cuál es la diferencia entre 301 y 302?

301 indica una redirección permanente (el recurso se movió definitivamente), mientras que 302 indica una redirección temporal. Para SEO, 301 transfiere el ranking y autoridad a la nueva URL, mientras que 302 no lo hace porque se asume que el cambio es temporal.

¿Qué significa el código 418 I'm a teapot?

Es un código de error HTTP real pero poco común, definido en el RFC 2324 como una broma del Día de los Inocentes de 1998. Indica que el servidor es una tetera y no puede preparar café. Aunque es una broma, algunos servidores lo implementan como un Easter egg.

¿Cómo puedo ver los códigos de estado en mi navegador?

Puedes usar las herramientas de desarrollador del navegador (F12 o Ctrl+Shift+I) y navegar a la pestaña "Red" o "Network". Al recargar la página, verás todas las solicitudes HTTP y sus códigos de estado correspondientes. También puedes usar herramientas como curl con la opción -I para ver solo las cabeceras de respuesta.

¿Qué código debo usar para una API REST?

Para APIs REST, usa 200 para éxito, 201 para creación exitosa, 204 para éxito sin contenido, 400 para solicitudes malformadas, 401 para autenticación requerida, 403 para acceso denegado, 404 para recursos no encontrados, y 500 para errores internos del servidor. Seguir estas convenciones hace que tu API sea más predecible y fácil de usar.