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.
id | Eindeutige Sendungs-ID |
title | Sendungs- oder Episodenname. |
season | Staffel-Nr., |
episode | Episoden-Nr. |
description | Beschreibung |
weblink | Link zur Website |
showstart | Start der Sendung |
showend | Geplantes Ende der Sendung |
type | [«newepisode» | «recurrence»] (Neue Episode oder Wiederholung) |
picture | 1920×1080, JPG |
picture_1080 | HQ, JPG |
picture_mobile | LQ, JPG |
genre | Genre |
rating | Empfohlene Altersfreigabe |
copyright | Copyright der Bild- & Textinformation |
Durch die Verwendung dieser kompakten Dokumentation sollte es problemlos möglich sein, eine Abfrage durchzuführen.