Häufig gestellte Fragen

Du hast Fragen? Keine Sorge! Durchstöbere unsere FAQs, um Antworten auf deine Anliegen zu finden
EPG-API

Hast du bereits ein API-Token?
Beantrage über unser Kontaktformular ein API-Token. Wir werden deine Angaben überprüfen und dir das API-Token anschliessend per E-Mail zusenden.


Bereich
Unsere elektronische Programmführer (EPG) enthält Informationen für sämtliche Sender. Die Daten sind für einen Zeitraum von bis zu 7 Tagen vor, und 24 Tagen nach dem aktuellen Tag verfügbar. Die Daten werden täglich um 04:00 Uhr erneuert. Daher ist es während dieser Zeit nicht machbar, Abfragen durchzuführen. Um festzustellen, ob eine Aktualisierung vorliegt, kann der Wert «LastFetch» verwendet werden.

Limits
Das Kontingent beträgt 10 Anfragen pro Minute. Daher ist es notwendig, die EPG-Daten auf der internen Plattform zwischenzuspeichern. Neue Tokens werden in den ersten 30 Tagen auf ein Kontingent von 100 Anfragen pro Minute gesetzt.

Wichtig
Jede Abfrage wird bei uns intern dokumentiert: Unangemessene Nutzung der API führt dazu, dass das Zugriffstoken gesperrt wird. Die Copyrightinformationen sind zwingend zu übernehmen.

API-Zugriffspunktt
Unsere API kann mithilfe einer unkomplizierten GET-Anweisung abgerufen werden. Für jede Anfrage muss der Token integriert werden

https://api.alpen-welle.ch/?token=[token]&date=[Y-m-d]&mode=[json|xml]&channel=[awg|alt|het]

Werte

token API-Token
date Format: Jahr-Monat-Tag (z.B. 2023-01-23)
mode xml oder json
channel Sender: [Alpen-Welle TV (awg), Alpenland TV (alt) oder HitExpress TV (het)

Rückgabewerte
Unabhängig davon, welche Methode du innerhalb unserer API auswählst, bleiben die Rückgabewerte gleich. Die Werte wurden segmentiert in «attributes» und die dazugehörigen Anzeigepunkte «showitem».

attributes
Die Informationen in den «attributes» spiegeln die grundlegenden Daten des Senders wider

Day Programmtag
Date Programmdatum
Start Start des Programms
NumDay Nummerischer Tag (1 Montag, 7 Sonntag)
Station Name des Senders
StationLogo Logo des Sender
StationLogo_Bright Logovariation (Hell) (SVG)
StationLogo_Dark Logovariation (Dunkel) (SVG)
LastFetch Letzter Datenabgleich

showitem (Array)
Die Informationen innerhalb des «showitem (Array)» geben die geplanten Ausstrahlungszeiten für die entsprechenden Fernsehsendungen an.

Durch die Verwendung dieser kompakten Dokumentation sollte es problemlos möglich sein, eine Abfrage durchzuführen.

Weiteres zu diesem Thema
Technische Lieferanforderungen für das Hochladen von TV-Spots Inhalt Informationen Anlieferungszeiten ...
Wir sind gespannt auf sämtliche Einsendungen von Musikvideos! Um jedoch ...
Unsere Bemühungen, Werbemöglichkeiten so transparent wie möglich zu gestalten, sind ...
Herzlich willkommen in unserem Häufig gestellte Fragen-Bereich! Wir freuen uns, ...