Sounds API

Swagger-inspired overview of the most important endpoints and cached media.

Base URL:

Core

Health checks and the aggregated home response.

3 endpoints
GET /health Full system health status.
200
GET /health/appservice Minimal App Service check.
200
GET /home Aggregated home payload.
200

Playlist

Playlist data and playback history.

2 endpoints
GET /playlist Current playlist with caching.
200
GET /history Historical playback list.
200

Live Info

Current and upcoming songs from multiple sources.

8 endpoints
GET /current_song AzuraCast now playing.
200
GET /nowplaying Current song from laut.fm.
200
GET /next_song Next song ingest output.
200
GET /radiotext Rotating on-air radiotext (RDS/DAB+).
200
WS /ws/current_song WebSocket updates for /current_song.
101
WS /ws/nowplaying WebSocket updates for /nowplaying.
101
WS /ws/next_song WebSocket updates for /next_song.
101
WS /ws/radiotext WebSocket updates for /radiotext.
101

Programme

Show metadata and schedule.

3 endpoints
GET /show Current and next show (from schedule).
200
WS /ws/show WebSocket updates for /show.
101
GET /schedule Programme schedule.
200

News

Shorts, RSS feeds, and weather.

7 endpoints
GET /news/shorts Short news feed.
200
GET /news/articles Full RSS article list.
200
GET /news/cat/:cat/articles Category-specific feed.
200
GET /news/weather Weather for German state capitals.
200
GET /news/weather/forecast 5-day forecast for German state capitals.
200
GET /news/weather/search/:country/:postcode Weather by country code and postcode.
200
GET /news/weather/search/gps/:gps Weather by GPS coordinates.
200

RadioDNS

Aggregated service discovery for RadioDNS.

2 endpoints
GET /radiodns RadioDNS service overview.
200
GET /radiodns/services Same as /radiodns for clients.
200

Media Cache

Covers, hooks, and on-demand audio.

4 endpoints
GET /media/cover/:mid Cover artwork.
200
GET /media/hook/:mid 30s preview.
200
GET /media/news News audio.
200
GET /media/weather Weather audio.
200