Sender-API

Öffentliche REST-API für deinen Sender, kostenlos.

Die Sender-API stellt Now-Playing, Sendeplan, DJ-Liste und Events als saubere REST-Endpunkte bereit. Du legst API-Keys an, vergibst Rate-Limits, externe Apps und Embeds holen die Daten per HTTP. Damit kannst du eine eigene Mobile-App, ein Studio-Display oder eine Partner-Webseite mit Live-Daten füttern, ohne dass jeder Aufruf direkt an die Datenbank geht. Gratis als Antwort auf die Now-Playing-API von AzuraCast.

Was du konkret damit machen kannst

Eigene Mobile-App füttern

Deine Native- oder PWA-App fragt /api/now-playing alle paar Sekunden ab und zeigt Titel, Interpret und Cover im Sperrbildschirm.

Embed auf Partner-Webseiten

Du gibst befreundeten Bloggern einen API-Key, sie binden ein kleines JavaScript-Widget ein, das deinen Stream-Status anzeigt.

Studio-Display oder Streamdeck

Ein Mini-Display am DJ-Pult zeigt die Live-Hörerzahl. Streamdeck-Tasten reagieren auf Schedule-Ereignisse über die API.

Installation und Aktivierung

Gratis-Plugin, keine Lizenz nötig: Admin → Plugins → Tab Marketplace → Sender-API finden (grünes FREE-Badge) → "Plugin laden" → Plugin lädt direkt → in der Plugin-Liste "Aktivieren" anklicken.

So nutzt du es

Schritt 1: Wo finde ich es

Nach der Aktivierung erscheint in der Sidebar der Punkt "Sender-API". Dort verwaltest du API-Keys, siehst die verfügbaren Endpunkte und das Live-Logging.

Schritt 2: Ersten API-Key anlegen

Klick auf "Neuer Key", Bezeichnung vergeben (z.B. "Mobile-App"), Endpunkte auswählen und Rate-Limit setzen (z.B. 60 Anfragen pro Minute). Der Key wird einmalig angezeigt, danach nur noch der Prefix.

Schritt 3: Endpunkt aufrufen

Jeder Endpunkt erwartet den Key als Header X-API-Key oder als Query-Parameter ?key=... Die Antwort ist JSON, dokumentiert direkt im Admin-Bereich.

Schritt 4: Logs und Sperren

Im Tab "Logs" siehst du wer welche Endpunkte wie oft abruft. Verdächtige Keys kannst du mit einem Klick sperren, ohne den Server zu rebooten.

Voraussetzungen

RadioCMS Community Edition ab 2.2.0. Keine zusätzlichen Plugins nötig.