Last updated 6 months ago
Retrieve details for a single playlist.
Playlist ID
GET /api/station/{station_id}/playlist/{id} HTTP/1.1 Host: listen.dovafm.xyz X-API-Key: YOUR_API_KEY Accept: */*
Success
{ "id": 1, "name": "Test Playlist", "type": "default", "source": "songs", "order": "shuffle", "remote_url": "https://remote-url.example.com/stream.mp3", "remote_type": "stream", "remote_buffer": 0, "is_enabled": true, "is_jingle": false, "play_per_songs": 5, "play_per_minutes": 120, "play_per_hour_minute": 15, "weight": 3, "include_in_requests": true, "include_in_on_demand": true, "backend_options": "interrupt,loop_once,single_track,merge", "avoid_duplicates": true, "schedule_items": [], "podcasts": [] }
Delete a single playlist relay.
DELETE /api/station/{station_id}/playlist/{id} HTTP/1.1 Host: listen.dovafm.xyz X-API-Key: YOUR_API_KEY Accept: */*
{ "success": true, "message": "Changes saved successfully.", "formatted_message": "<b>Changes saved successfully.</b>" }
List all current playlists.
GET /api/station/{station_id}/playlists HTTP/1.1 Host: listen.dovafm.xyz X-API-Key: YOUR_API_KEY Accept: */*
[ { "id": 1, "name": "Test Playlist", "type": "default", "source": "songs", "order": "shuffle", "remote_url": "https://remote-url.example.com/stream.mp3", "remote_type": "stream", "remote_buffer": 0, "is_enabled": true, "is_jingle": false, "play_per_songs": 5, "play_per_minutes": 120, "play_per_hour_minute": 15, "weight": 3, "include_in_requests": true, "include_in_on_demand": true, "backend_options": "interrupt,loop_once,single_track,merge", "avoid_duplicates": true, "schedule_items": [], "podcasts": [] } ]
Create a new playlist.
POST /api/station/{station_id}/playlists HTTP/1.1 Host: listen.dovafm.xyz X-API-Key: YOUR_API_KEY Content-Type: application/json Accept: */* Content-Length: 468 { "id": 1, "name": "Test Playlist", "type": "default", "source": "songs", "order": "shuffle", "remote_url": "https://remote-url.example.com/stream.mp3", "remote_type": "stream", "remote_buffer": 0, "is_enabled": true, "is_jingle": false, "play_per_songs": 5, "play_per_minutes": 120, "play_per_hour_minute": 15, "weight": 3, "include_in_requests": true, "include_in_on_demand": true, "backend_options": "interrupt,loop_once,single_track,merge", "avoid_duplicates": true, "schedule_items": [], "podcasts": [] }
Update details of a single playlist.
PUT /api/station/{station_id}/playlist/{id} HTTP/1.1 Host: listen.dovafm.xyz X-API-Key: YOUR_API_KEY Content-Type: application/json Accept: */* Content-Length: 468 { "id": 1, "name": "Test Playlist", "type": "default", "source": "songs", "order": "shuffle", "remote_url": "https://remote-url.example.com/stream.mp3", "remote_type": "stream", "remote_buffer": 0, "is_enabled": true, "is_jingle": false, "play_per_songs": 5, "play_per_minutes": 120, "play_per_hour_minute": 15, "weight": 3, "include_in_requests": true, "include_in_on_demand": true, "backend_options": "interrupt,loop_once,single_track,merge", "avoid_duplicates": true, "schedule_items": [], "podcasts": [] }