EPG-API, Elektronischer Programmführer

Das Projekt

Wir haben eine hochperformante REST-API entwickelt, die als zentrale Datenquelle für elektronische Programmführer (EPG) dient. Das System versorgt mehrere Medienplattformen gleichzeitig mit TV-Programmdaten, Sendungsdetails, Empfehlungen und Streaming-Informationen, zuverlässig, skalierbar und mit Antwortzeiten unter 125 Millisekunden.

Herausforderung

TV-Programmdaten sind komplex: Hunderttausende Sendungen mit über 130 Attributen pro Datensatz, verknüpft mit Genres, Bewertungen, Besetzungslisten und externen Datenbanken. Die API muss diese Daten für unterschiedliche Kunden aufbereiten, jeweils mit eigenen Feldzuordnungen, Slugs und Feature-Sets, und dabei auch unter Last stabile Antwortzeiten liefern. Gleichzeitig müssen Empfehlungen, Suchfunktionen und Barrierefreiheits-Features wie Audiodeskriptionen nahtlos integriert sein.

Kernfunktionen

• EPG-Grid-API: Optimierte Endpunkte für Programmraster-Darstellungen, liefert Sendungen nach Sendergruppen, Zeitfenstern und Daten mit konfigurierbarer Eintragsanzahl und intelligenter Zeitbereichslogik.
• Multi-Tenant-Architektur: Dasselbe System bedient mehrere Kunden mit individuellen Konfigurationen, Slug-Systemen und Feature-Sets, ohne Code-Duplizierung.
• Personalisierte Empfehlungen: Tägliche Top-Empfehlungen und kategoriebasierte Programmvorschläge, kuratiert nach Sendetyp und Highlight-Bewertung.
• Streaming-Integration: Proxy-Anbindung an externe Streaming-Dienste zur Anzeige, auf welchen Plattformen Inhalte verfügbar sind, mit eigener Caching-Schicht.
• Volltextsuche: Effiziente Suche über Sendungen, Serien-Profile und Programme mit Filterung nach Datum, Sender und Kategorie.
• Duale API-Versionierung: Parallel betriebene V1- und V2-API mit voller Abwärtskompatibilität, ermöglicht schrittweise Migration der Clients ohne Breaking Changes.
• Barrierefreiheit: Integration von Audiodeskriptions-Metadaten und speziellen Sendungstypen für ein inklusives Nutzererlebnis.

Technische Highlights

• 75–90 % schnellere Abfragen durch 16+ optimierte Composite-Indizes auf den kritischen Query-Pfaden der Sendungstabelle
• Mehrstufige Redis-Caching-Strategie mit inhaltsabhängigen TTLs, 24 Stunden für Programmraster, 12 Stunden für Profile, 1 Woche für Stammdaten
• Automatische Response-Kompression via gzip-Middleware mit 60–80 % Bandbreitenreduktion
• 60+ API-Endpunkte mit vollständiger OpenAPI-Dokumentation, Rich-Examples und Validierungsregeln
• Service-Layer-Architektur mit sauberer Trennung von HTTP-Logik, Business-Regeln, Caching und Validierung
• Multi-Datenbank-Anbindung mit parallelem Zugriff auf Haupt- und Sekundärdatenbank für optimierte Lesezugriffe
• Antwortzeiten unter 125 ms für die meistgenutzten Grid-Listing-Endpunkte im Produktivbetrieb

Ergebnis

Die API ist das Rückgrat mehrerer Medienplattformen und liefert täglich TV-Programmdaten an Millionen von Endnutzern. Durch die Kombination aus intelligenter Indizierung, mehrstufigem Caching und Response-Kompression erreicht das System stabile Sub-125ms-Antwortzeiten, auch bei hoher Last. Die duale API-Versionierung ermöglicht eine evolutionäre Weiterentwicklung ohne Disruption der bestehenden Clients.