Radio Client API (PHP & JSON)

<?php
// sp_api.php

define('SP_API_URL', 'https://YOUR_PANEL_DOMAIN/cp/api.php');
define('SP_API_KEY', 'PASTE_YOUR_API_KEY_HERE');

// Sends one call to the API and returns the answer as an array
function sp_api($action, $params = array())
{
    $params['api_key'] = SP_API_KEY;
    $params['action']  = $action;

    $ch = curl_init(SP_API_URL);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($params));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    $body = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($body, true);
    if (!is_array($result)) {
        return array('success' => false, 'message' => 'The radio could not be reached.');
    }
    return $result;
}

// Same as sp_api() but remembers the answer for a few seconds.
// Use it for pages that many visitors open.
function sp_api_cached($action, $params = array(), $seconds = 10)
{
    $file = sys_get_temp_dir() . '/sp_api_' . md5($action . serialize($params)) . '.json';

    if (is_file($file) && (time() - filemtime($file)) < $seconds) {
        $saved = json_decode(file_get_contents($file), true);
        if (is_array($saved)) { return $saved; }
    }

    $result = sp_api($action, $params);
    if (!empty($result['success'])) {
        file_put_contents($file, json_encode($result));
    }
    return $result;
}
?>

// It worked
{ "success": true, ... }

// It did not work
{ "success": false, "error": "invalid_api_key", "message": "The API key is missing or invalid." }

<?php
require 'sp_api.php';

$r = sp_api_cached('playlists', array(), 60);

if ($r['success']) {
    foreach ($r['playlists'] as $playlist) {
        echo $playlist['id'] . ' - ' . $playlist['name'] . ' (' . $playlist['total'] . ' songs)<br>';
    }
}

{
  "success": true,
  "playlists": [
    { "id": 12, "name": "Pop Hits", "total": 148 },
    { "id": 15, "name": "Rock Classics", "total": 96 }
  ]
}

<?php
require 'sp_api.php';

$r = sp_api_cached('tracks', array('playlist_id' => 12, 'page' => 1, 'per_page' => 50), 60);

if ($r['success']) {
    echo 'Playlist: ' . $r['playlist'] . ' (' . $r['total'] . ' songs)<br>';
    foreach ($r['tracks'] as $song) {
        echo $song['id'] . ' - ' . $song['artist'] . ' - ' . $song['title'] . '<br>';
    }
}

{
  "success": true,
  "total": 148,
  "page": 1,
  "per_page": 50,
  "playlist_id": 12,
  "playlist": "Pop Hits",
  "tracks": [
    { "id": 3041, "artist": "Artist Name", "title": "Song Title", "playlist_id": 12, "playlist": "Pop Hits" }
  ]
}

<?php
require 'sp_api.php';

$text = $_GET['q'];   // what the visitor typed

$r = sp_api_cached('search', array('q' => $text), 30);

if ($r['success']) {
    foreach ($r['tracks'] as $song) {
        echo $song['artist'] . ' - ' . $song['title'] . '<br>';
    }
} else {
    echo $r['message'];
}

<?php
require 'sp_api.php';

$r = sp_api('request', array(
    'track_id'   => (int)$_POST['track_id'],
    'visitor_ip' => $_SERVER['REMOTE_ADDR'],
));

if ($r['success']) {
    echo 'Thank you! Your request is number ' . $r['position'] . ' in the queue.';
} else {
    echo $r['message'];
}

{
  "success": true,
  "message": "Your song request has been added to the queue.",
  "track": { "id": 3041, "artist": "Artist Name", "title": "Song Title" },
  "position": 2,
  "interrupted": false
}

<?php
require 'sp_api.php';

$r = sp_api_cached('next_song', array(), 10);

if ($r['success'] && $r['song']) {
    echo 'Up next: ' . $r['song']['artist'] . ' - ' . $r['song']['title'];
} else {
    echo 'The next song is not known yet.';
}

{
  "success": true,
  "song": { "position": 1, "artist": "Artist Name", "title": "Song Title", "source": "playlist" }
}

<?php
require 'sp_api.php';

$r = sp_api_cached('next_songs', array(), 10);

if ($r['success']) {
    foreach ($r['queue'] as $song) {
        echo $song['position'] . '. ' . $song['artist'] . ' - ' . $song['title'] . '<br>';
    }
}

{
  "success": true,
  "queue": [
    { "position": 1, "artist": "Artist Name", "title": "Song Title", "source": "request" },
    { "position": 2, "artist": "Another Artist", "title": "Another Song", "source": "playlist" }
  ]
}

<?php
require 'sp_api.php';

$r = sp_api_cached('queue', array('limit' => 8), 10);

if ($r['success']) {
    foreach ($r['queue'] as $song) {
        echo $song['artist'] . ' - ' . $song['title'] . '<br>';
    }
}

<?php
require 'sp_api.php';

$r = sp_api_cached('radio_info', array(), 300);

if ($r['success']) {
    echo $r['name'] . ' - ' . $r['bitrate'] . ' kbps<br>';
    echo '<audio controls src="' . htmlspecialchars($r['stream_url']) . '"></audio>';
}

{
  "success": true,
  "name": "My Radio",
  "genre": "Pop",
  "website": "https://www.example.com",
  "server_type": "shoutcast",
  "server_version": "2.6",
  "bitrate": 128,
  "max_listeners": 100,
  "port": 8000,
  "ssl_port": 8002,
  "stream_path": "/stream",
  "stream_url": "http://panel.example.com:8000/stream",
  "stream_url_secure": "https://panel.example.com:8002/stream",
  "autodj_online": true
}

<?php
require 'sp_api.php';

$r = sp_api_cached('now_playing', array(), 10);

if ($r['success'] && $r['song']) {
    echo 'Now playing: ' . $r['song']['artist'] . ' - ' . $r['song']['title'];
} else {
    echo 'Nothing to show right now.';
}

{
  "success": true,
  "song": { "artist": "Artist Name", "title": "Song Title", "started_at": "2026/10/14 22:28:05" },
  "live": false,
  "dj": ""
}

<?php
require 'sp_api.php';

$r = sp_api_cached('song_history', array('limit' => 10), 30);

if ($r['success']) {
    foreach ($r['history'] as $song) {
        echo $song['played_at'] . ' - ' . $song['artist'] . ' - ' . $song['title'] . '<br>';
    }
}

{
  "success": true,
  "history": [
    { "artist": "Artist Name", "title": "Song Title", "played_at": "2026-10-14 22:28:05" }
  ]
}

<?php
require 'sp_api.php';

$r = sp_api_cached('listeners', array(), 30);

if ($r['success']) {
    echo 'Listening now: ' . $r['listeners'];
}

{
  "success": true,
  "listeners": 12,
  "unique_listeners": 10,
  "today_hourly": { "h00": 3, "h01": 1, "h02": 0, ... "h23": 0 }
}

<?php
require 'sp_api.php';

$r = sp_api_cached('live_dj', array(), 10);

if ($r['success'] && $r['live']) {
    echo 'LIVE now: ' . $r['dj'];
} else {
    echo 'AutoDJ is playing.';
}

{ "success": true, "autodj_online": true, "live": true, "dj": "dj_john" }

<?php
require 'sp_api.php';

$r = sp_api('start_autodj');

echo $r['message'];

{ "success": true, "message": "AutoDJ started.", "restarted": false }

<?php
require 'sp_api.php';

$r = sp_api('stop_autodj');

echo $r['message'];

{ "success": true, "message": "AutoDJ stopped." }

<?php
require 'sp_api.php';

$r = sp_api('list_dj');

if ($r['success']) {
    foreach ($r['djs'] as $dj) {
        echo $dj['username'] . '<br>';
    }
}

{
  "success": true,
  "total": 1,
  "djs": [
    { "username": "dj_john", "canlogin": "yes", "canstream": "yes", "canplayjingles": "yes", "canuploadpic": "yes",
      "canusevoice": "no", "canchangepass": "no", "canstartrad": "no", "canstartdj": "no", "canskip": "no" }
  ]
}

<?php
require 'sp_api.php';

$r = sp_api('add_dj', array(
    'dj_username' => 'dj_john',
    'dj_pass'     => 'S3cretPass',
    'canstream'   => 'yes',
    'canskip'     => 'no',
));

echo $r['message'];

{ "success": true, "message": "DJ account created.", "dj": { "username": "dj_john", "canstream": "yes", ... } }

<?php
require 'sp_api.php';

$r = sp_api('update_dj', array(
    'dj_username' => 'dj_john',
    'dj_pass'     => 'NewS3cretPass',
    'canskip'     => 'yes',
));

echo $r['message'];

{ "success": true, "message": "DJ account updated." }

<?php
require 'sp_api.php';

$r = sp_api('delete_dj', array('dj_username' => 'dj_john'));

echo $r['message'];

{ "success": true, "message": "DJ account deleted." }