Códigos de estado HTTP: significado de 1xx a 5xx

Qué informa realmente un código de estado HTTP

Un código de estado es la primera respuesta breve que un servidor entrega tras recibir una solicitud. No cuenta toda la historia, pero separa con rapidez éxito, redirección, problema en la petición y fallo mientras el servicio la atiende. La tabla reúne los códigos que más aparecen en navegadores, APIs, registros y herramientas de desarrollo.

Lee el primer dígito como clase antes de buscar el caso concreto: 1xx es informativo, 2xx indica éxito, 3xx trata de redirección, 4xx señala una solicitud que normalmente puede revisar el cliente y 5xx indica que el servidor o un intermediario falló al atender una petición aparentemente válida.

El estado no sustituye el resto de la respuesta

Un código es un diagnóstico inicial, no una explicación completa. En una solicitud de API conviene revisar método, URL, cabeceras, cuerpo de error y hora del intento. Un 400 puede deberse a un campo obligatorio ausente, un 401 a una credencial vencida y un 429 puede exigir esperar el intervalo indicado por el propio servicio.

No esperes siempre JSON o HTML. La RFC 9110 establece que las respuestas 1xx, 204 y 304 no incluyen contenido. Cuando una integración recibe 204 No Content, la operación puede haberse completado correctamente aunque no exista cuerpo que mostrar.

200, 201, 202 y 204 son éxitos con efectos distintos

El 200 confirma que la solicitud tuvo éxito, pero no explica por sí solo qué acción ocurrió. El 201 corresponde a la creación de un recurso. El 202 indica que el servidor aceptó el trabajo sin prometer que el procesamiento ya haya terminado. El 204 informa éxito sin contenido adicional en la respuesta.

Estas diferencias evitan interfaces engañosas. Un formulario que recibe 202 debe comunicar que la tarea quedó pendiente; una eliminación que devuelve 204 no debe intentar interpretar un cuerpo inexistente. El comportamiento correcto depende del contrato de la API, no de elegir el número más conocido.

Redirecciones: 301, 302, 307 y 308

Una respuesta 3xx pide al cliente que considere otra dirección. 301 y 308 se usan para cambios permanentes; 302 y 307, para cambios temporales. La diferencia práctica importante es que 307 y 308 preservan explícitamente el método de la solicitud. Eso importa cuando la petición original no era un simple GET.

El 304 merece una lectura aparte. No significa que una página falló ni que el servidor rechazó la solicitud. Ante una petición condicional, informa que la representación almacenada en caché sigue siendo válida; por eso no se envía un cuerpo nuevo.

Cómo investigar un 4xx sin adivinar

La mayoría de los 4xx apunta a algo que el cliente puede revisar. Empieza por ruta, método y parámetros. Después valida autenticación, permiso, formato del cuerpo y límites de uso documentados. Este orden sirve más que cambiar credenciales al azar cuando el problema real es una URL equivocada o un POST enviado a un recurso que solo acepta GET.

• 401 requiere autenticación válida; 403 significa que el servidor entendió la solicitud, pero rechaza el acceso.
• 404 indica que el recurso no fue encontrado; 410 comunica que existió y fue retirado.
• 405 señala un método no permitido por el recurso; 415 señala un tipo de medio no compatible.
• 422 Unprocessable Content puede aparecer cuando la sintaxis se entiende, pero el contenido enviado no cumple las condiciones necesarias para procesarlo.
• 429 indica que se excedió un límite de solicitudes. Respeta la política del servicio y las cabeceras pertinentes antes de volver a llamar.

Cuándo un 5xx apunta a servidor, gateway o dependencia

Un 500 es un fallo general durante el procesamiento. Un 502 sugiere que un gateway o proxy recibió una respuesta inválida de otro componente. Un 503 suele indicar indisponibilidad temporal, mientras que un 504 informa que un gateway no recibió respuesta a tiempo. Todos pertenecen a la clase de error del servidor, pero llevan a comprobaciones diferentes.

Antes de repetir muchas veces la misma solicitud, registra hora, código y cualquier identificador de petición devuelto. Así el responsable del servicio recibe información concreta para investigar y resulta más fácil distinguir una caída externa de un fallo de validación de la aplicación cliente.

Cómo usar la tabla en desarrollo y soporte

Busca por número cuando aparezca un código en un registro y filtra por clase para detectar patrones. Si varios endpoints devuelven 502 o 504 en el mismo periodo, la investigación suele dirigirse al proxy o al servicio de origen. Si solo una ruta devuelve 404, empieza por la URL publicada, el entorno y el camino.

Para probar respuestas reales de servicios públicos, consulta el catálogo de APIs de DexBase. La documentación de cada proveedor aclara qué respuestas forman parte de su propio contrato.

Fuente de referencia y alcance de esta lista

Los códigos HTTP evolucionan mediante especificaciones y registro. La RFC 9110 es la referencia normativa para la semántica general y el registro de IANA conserva los códigos y sus asignaciones. Esta tabla destaca casos frecuentes; no sustituye la documentación de una API, navegador, servidor o framework concreto.

Preguntas frecuentes

¿204 es un error?

No. El 204 indica que la solicitud se atendió correctamente y no hay contenido adicional que enviar en el cuerpo de la respuesta.

¿Cuál es la diferencia entre 404 y 410?

El 404 dice que el recurso no se encontró en ese momento. El 410 comunica que existió y fue retirado de forma permanente.

¿502 y 504 son lo mismo?

No. El 502 informa una respuesta inválida de un componente anterior, mientras que el 504 indica que un gateway esperó y no recibió respuesta a tiempo.