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.