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.
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 | 1920x1080, 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.
Auf unserer Webseite verwenden wir Cookies und ähnliche Technologien. Aber keine Sorge, persönliche Daten werden nur mit deiner ausdrücklichen Zustimmung verarbeitet. Du entscheidest selbst, ob du in optionale Dienste einwilligst, und kannst diese Entscheidung jederzeit anpassen oder widerrufen. Ausgenommen davon sind lediglich technisch notwendige Daten – denn ohne die läuft diese Seite hier nicht.
Hier hast du die Kontrolle darüber, welche Daten genutzt werden.
Technisch Notwendige
Kann nicht deaktiviert werden. Mehr erfahren
|
|
YouTube-Integration
Intergration von Sendeinhalten.Mehr erfahren
|
|
OTT-Videoserver Integration
Intergration von Sendeinhalten in besserer Qualität. Mehr erfahren |
|
Analyse & Statistiken
Hilft uns das Angebot zu verbessern. Mehr erfahren
|
|
Marketing & Anzeigen
Sichert uns die Sichtbarkeit und den Erfolg der Angebote. Mehr erfahren
|