¿Qué son los códigos de estado HTTP?
Son códigos de respuesta estandarizados de tres dígitos del protocolo HTTP. Se agrupan en cinco clases: 1xx (informativo), 2xx (éxito), 3xx (redirección), 4xx (error del cliente) y 5xx (error del servidor). Cada código comunica un resultado específico — 200 OK significa éxito, 404 Not Found que el recurso no existe, 500 un falló del servidor. Definidos en RFC 7231.
Por qué importan
El uso correcto es fundamental para APIs fiables. Dicen a los clientes cómo manejar respuestas: seguir redirecciones (301/302), reintentar (429/503) o mostrar errores (400/404/500). Los buscadores usan 301 para redirecciones y 404 para enlaces rotos. Los sistemas de monitoreo vigilan códigos 5xx. El código incorrecto puede romper caché, confundir clientes y dañar SEO.
Códigos comunes
Los más frecuentes: 200 (OK), 201 (Creado), 204 (Sin Contenido), 301 (Movido Permanentemente), 302 (Redirección Temporal), 304 (No Modificado), 400 (Solicitud Incorrecta), 401 (No Autenticado), 403 (Prohibido), 404 (No Encontrado), 429 (Demasiadas Solicitudes), 500 (Error Interno), 502 (Bad Gateway), 503 (Servicio No Disponible).
Mejores prácticas
Devuelve el código más específico. Usa 201 al crear recursos. Devuelve 204 para DELETE sin cuerpo. Usa 400 para errores de validación. Retorna 429 con cabecera Retry-After. Evita usar 200 para errores. Registra errores 5xx para monitoreo.
