Programm SHf

Das Programm des Schaffhauser Fernsehens folgt einer vorgegebenen Struktur, siehe Tabelle unten. Es kann jedoch Abweichungen davon geben.

Die aktuellen Programminhalte sind wie folgt verfügbar:

• TV-Programm-Seite in den «Schaffhauser Nachrichten»
• Programm-Guide in Ihrem TV-Gerät oder IPTV-Plattform 
• Online EPG, wie z.B.: TVEPG.eu

 Programm-Anpassungen sind in folgenden Fällen zu erwarten:

• Abstimmungen und Wahlen
• Live-Übertragungen von Kulturanlässen und Sportevents
• Spezialprogramm an Feiertagen wie Ostern, Weihnachten, Neujahr, etc.
• Kurzfristige Änderungen aufgrund aktueller Ereignisse

EPG-API für EPG Zulieferer

Durch die Verwendung dieser kompakten Dokumentation ist es problemlos möglich, eine EPG-Abfrage durchzuführen

Unsere elektronische Programmführer (EPG) enthält Informationen für den Sender (SHf). Die Daten sind für einen Zeitraum von bis zu 7 Tagen vor, und 20 Tagen nach dem aktuellen Tag verfügbar. Die Daten werden täglich um 04:00, 08:00, 12:00, 16:00, 20:00 und 00: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.

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-Zugriffspunkt
Unsere API kann mithilfe einer unkomplizierten GET-Anweisung abgerufen werden.

https://epg.shf.ch/?mode=[ json|xml]&date=[YYYY-mm-dd]

Werte
date          Format: Jahr-Monat-Tag (z.B. 2023-01-23)
mode        xml oder json

Rückgabewerte
Unabhängig davon, welche Methode innerhalb unserer API ausgewählt wird, 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                         Numerischer Tag (1 Montag, 7 Sonntag)
Station                            Name des Senders
Station_short                  Kurzform des Senders
dmb-Name                     Deutsche Mailbox Sendername
dmb-short                       Deutsche Mailbox Senderkürzel
Kontakt                           Technischer Kontakt
Region                            Region des Senders
Sprache                          Hauptsprache der Sendeinhalte
StationLogo                    Logo des Senders (SVG)
StationLogo_Bright        Logovariation Hell (SVG)
StationLogo_Dark          Logovariation Dukel (SVG)
LastFetch                       Letzter Datenabgleich

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

id                                   Eindeutige Sendungs-ID
title                                Sendungs- oder Episodenname
description                    Beschreibung (Mehrzeilig)
weblink                          Link zur Webseite
showstart                      Start der Sendung
showend                       Geplantes Ende der Sendung
type                               Neue Episode oder Wiederholung [«newepisode» | «recurrence»]
duration                         Länge des Segments
picture                           1920x1080, JPG
picture_1080                 HQ, JPG
picture_mobile               LQ, JPG
genre                             Genre
rating                             Empfohlene Altersfreigabe
copyright                       Copyright der Bild- & Textinformation