LionFM API Übersicht

Dies ist die offizielle LionFM API. Hier sind alle Endpunkte aufgelistet mit ihren verschiedenen Funktionen.

Format

Das Format, in welches die API angeboten wird, ist immer JSON und XML.
Der Endverbraucher dieser API kann hierbei frei entscheiden mit dem austauschen der URL von "/json/" zu "/xml/" oder umgekehrt.

Das Encoding ist immer UTF-8.

Zur API-Dokumentation (PDF): LionFM_API_Dokumentation.pdf (209 KB)

Sender:



LionFM - stationList:

(JSON)
https://api.lionfm.de/json/stationList
https://api.lionfm.de/json/stationList?xmasfm=1
https://api.lionfm.de/json/stationList?schlager=1
(XML)
https://api.lionfm.de/xml/stationList
https://api.lionfm.de/xml/stationList?xmasfm=1
https://api.lionfm.de/xml/stationList?schlager=1

LionFM - stationData:

(JSON)
https://api.lionfm.de/json/stationData
https://api.lionfm.de/json/stationData?hollyfm=1
https://api.lionfm.de/json/stationData?xmasfm=1
https://api.lionfm.de/json/stationData?schlager=1
https://api.lionfm.de/json/stationData?topStations=5
https://api.lionfm.de/json/stationData?topStations=10
https://api.lionfm.de/json/stationData?stationID=1
(XML)
https://api.lionfm.de/xml/stationData
https://api.lionfm.de/xml/stationData?hollyfm=1
https://api.lionfm.de/xml/stationData?xmasfm=1
https://api.lionfm.de/xml/stationData?schlager=1
https://api.lionfm.de/xml/stationData?topStations=5
https://api.lionfm.de/xml/stationData?topStations=10
https://api.lionfm.de/xml/stationData?stationID=1

LionFM - songHistory

(JSON)
https://api.lionfm.de/json/songHistory?from=latest&till=latest&date=2023-12-02&station=1
https://api.lionfm.de/json/songHistory?from=00:00&till=01:00&date=2023-12-02&station=1
(XML)
https://api.lionfm.de/xml/songHistory?from=latest&till=latest&date=2023-12-02&station=1
https://api.lionfm.de/xml/songHistory?from=00:00&till=01:00&date=2023-12-02&station=1

LionFM - listenerCounter

(JSON)
https://api.lionfm.de/json/listenerCounter.json
(XML)
https://api.lionfm.de/xml/listenerCounter.xml

LionFM - allListeners

https://api.lionfm.de/json/allListeners

⇽ Mit Hilfe der URL können allgemeine Informationen über alle Stationen aufgerufen werden, diese werden dann im JSON oder XML Format angezeigt. Jenachdem welche URL gewählt wurde. Die Liste zeigt die ID, den Namen, den Anzeigenamen sowie die Farbe des Senders im HEX Code an. Der Zusatz mit schlager lässt nur den Sender schlager anzeigen.

⇽ Mit der StationData können alle Informationen über alle Stationen aufgerufen werden. Der Zusatz hollyfm zeigt den Sender hollyfm an, der Zusatz xmasfm nur xmasfm und schlager nur schlager. Zudem ist es möglich die besten 5 und die besten 10 Stationen anzeigen zu lassen. Ebenfalls möglich ist das anzeigen einer Station anhand der StationID. In den Informationen stehen unter anderem:

  • Station-ID, Name, Beschreibung
  • Live-Hörerzahl
  • Live geschaltet aus dem Studio?
  • laut.fm Page & Streaming-URL's
  • Station-Farbe & Font-Color im HEX-Code
  • Now-Playing Anzeige mit Artist, Title, Cover, Genre, Start- & End-Zeit
  • ⇽ Die songHistory zeigt standardmäßig die letzten Songs von LionFM an. Mit den Parametern from, till, date und station kann man dazu noch die angegebenen Informationnen anzeigen lassen. from von welcher Uhrzeit, till bis zur Uhrzeit X. date übersendet man das jeweilige Datum im Y-m-d Format. station steht für die jeweilige Station-ID (1 = LionFM etc.). Mit from=latest und till=latest lassen sich die letzten 10 gespielten Songs des Senders anzeigen.

    ⇽ Der listenerCounter zeigt die Gesamthöreranzahl an, als auch die Hörerzahlen von den einzelnen Stationen. Die Hörerzahlen beziehen wir selbst von der laut.fm-API.

    ⇽ Mit der allListeners-API kann einzig und allein die Gesamthöreranzahl abgerufen werden.