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