EPG-API — Guía electrónica de programación

El proyecto

Desarrollamos una API REST de alto rendimiento que sirve como fuente central de datos para guías electrónicas de programación (EPG). El sistema suministra a varias plataformas de medios simultáneamente datos de programación televisiva, detalles de emisiones, recomendaciones e información de streaming — de forma fiable, escalable y con tiempos de respuesta inferiores a 125 milisegundos.

Desafío

Los datos de programación televisiva son complejos: cientos de miles de emisiones con más de 130 atributos por registro, vinculados a géneros, valoraciones, listas de reparto y bases de datos externas. La API debe preparar estos datos para diferentes clientes — cada uno con sus propias asignaciones de campos, slugs y conjuntos de funcionalidades — y al mismo tiempo ofrecer tiempos de respuesta estables incluso bajo carga. Además, deben integrarse de forma transparente recomendaciones, funciones de búsqueda y características de accesibilidad como audiodescripciones.

Funciones principales

• API de parrilla EPG: Endpoints optimizados para representaciones de parrilla de programación — entrega emisiones por grupos de canales, franjas horarias y fechas con número configurable de entradas y lógica inteligente de rangos temporales.
• Arquitectura multiinquilino: El mismo sistema atiende a varios clientes con configuraciones individuales, sistemas de slugs y conjuntos de funcionalidades — sin duplicación de código.
• Recomendaciones personalizadas: Recomendaciones destacadas diarias y sugerencias de programación basadas en categorías, curadas según tipo de emisión y valoración de destacados.
• Integración de streaming: Conexión proxy a servicios de streaming externos para mostrar en qué plataformas están disponibles los contenidos — con su propia capa de caché.
• Búsqueda de texto completo: Búsqueda eficiente de emisiones, perfiles de series y programas con filtrado por fecha, canal y categoría.
• Versionado dual de API: APIs V1 y V2 operadas en paralelo con total compatibilidad retroactiva — permite la migración gradual de los clientes sin cambios disruptivos.
• Accesibilidad: Integración de metadatos de audiodescripción y tipos especiales de emisiones para una experiencia de usuario inclusiva.

Aspectos técnicos destacados

• Consultas un 75-90 % más rápidas gracias a más de 16 índices compuestos optimizados en las rutas de consulta críticas de la tabla de emisiones
• Estrategia de caché Redis multinivel con TTLs según el contenido — 24 horas para parrillas de programación, 12 horas para perfiles, 1 semana para datos maestros
• Compresión automática de respuestas mediante middleware gzip con reducción del ancho de banda del 60-80 %
• Más de 60 endpoints de API con documentación OpenAPI completa, ejemplos detallados y reglas de validación
• Arquitectura de capa de servicio con separación limpia de lógica HTTP, reglas de negocio, caché y validación
• Conexión multibase de datos con acceso paralelo a base de datos principal y secundaria para lecturas optimizadas
• Tiempos de respuesta inferiores a 125 ms para los endpoints de listado de parrilla más utilizados en producción

Resultado

La API es la columna vertebral de varias plataformas de medios y suministra diariamente datos de programación televisiva a millones de usuarios finales. Gracias a la combinación de indexación inteligente, caché multinivel y compresión de respuestas, el sistema alcanza tiempos de respuesta estables por debajo de 125 ms — incluso bajo alta carga. El versionado dual de API permite una evolución continua sin interrupciones para los clientes existentes.