Ici et dans les sous-sections suivantes, nous expliquerons comment utiliser l'API d panneau de contrôle StreamingCenter pour obtenir des informations sur les metadonnées et d'autres données, grâce à des méthodes de programmation. Notre API vous permet de créer vos propres scripts, applications et modules pour le site web de votre radio, votre application mobile et toute intégration nécessitant une interaction programmatique avec le serveur radio.
Pour utiliser l'API, vous aurez besoin de l'URL de ce panneau : l'adresse à laquelle vous accédez habituellement à l'interface de diffusion, où se trouvent vos chaînes, vos listes de lecture, votre grille de diffusion et les autres sections.
L'URL de l'API est : « adresse de votre panneau sur le serveur »/api/« version de l'API » , par exemple : https://stream.webradiolatinos.com:1030/api/v2/
L'API utilise les formats JSON et JSONP pour l'échange de données. Pour un fonctionnement optimal, nous vous recommandons vivement d'utiliser le protocole HTTPS qui est disponible par défaut sur l'URL de votre compte radio. De plus, lorsque l'autorisation est requise pour les requêtes API, le protocole HTTPS est indispensable pour sécuriser le transfert des jetons d'autorisation.
Exemples de requête API qui récupère l'historique des diffusions (le dernier morceau, qui est aussi celui actuellement diffusé à la radio) qui a été joué sur le serveur 1 :
En Python :
import requests
response = requests.get("https://stream.webradiolatinos.com:1030/api/v2/history?limit=1&offset=0&server=1")
print(response.json())en PHP avec file_get_contents :
$arrContextOptions = array("ssl"=>array("verify_peer"=>false,"verify_peer_name"=>false));
$response = file_get_contents("https://stream.webradiolatinos.com:1030/api/v2/history?
limit=1&offset=0&server=1", false, stream_context_create($arrContextOptions));
echo $response;
En PHP avec cURL :
$url = "https://stream.webradiolatinos.com:1030/api/v2/history?limit=1&offset=0&server=1";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// Désactive la vérification SSL (évite l'erreur de certificat)
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($ch);
if (curl_errno($ch)) {
echo "Erreur cURL: " . curl_error($ch);
curl_close($ch);
exit;
}
curl_close($ch);
// Afficher le JSON brut
header('Content-Type: application/json');
echo $response;
// OU (san le header et echo ci-dessus)
// Version avec décodage JSON (si tu veux récupérer les valeurs)
$data = json_decode($response, true);
print_r($data);
Exemple de résultat concernant le morceau actuellement diffusé à la radio, au format JSON :
{
"count":500
"next":"https://stream.webradiolatinos.com:1030/api/v2/history?limit=1&offset=1&server=1"
"previous":NULL
"results":[
{
"id":1175553
"img_url":"https://stream.webradiolatinos.com:1030/media/tracks/trackImage10699.jpg"
"ts":1763010277000
"metadata":"BIG NELO, JEFF BROWN, OS VAGABANDA - Hoje É Surra - O Remix"
"author":"BIG NELO, JEFF BROWN, OS VAGABANDA"
"author_other":NULL
"title":"Hoje É Surra - O Remix"
"genre":NULL
"performance_type":NULL
"lyricist":""
"composer":NULL
"publisher":NULL
"label":NULL
"playlist_title":"AfroHouse 2024"
"dj_name":"La playlist de WebradioLatinos"
"n_listeners":0
"length":189521
"img_medium_url":"https://stream.webradiolatinos.com:1030/media/tracks/trackImage10699_medium.jpg"
"img_large_url":"https://stream.webradiolatinos.com:1030/media/tracks/trackImage10699_large.jpg"
"img_fetched":true
"all_music_id":10699
"jingle_id":NULL
"album":"Karga"
"year":NULL
"comment":NULL
"isrc":NULL
}
]
}
Comme vous pouvez le constater, l'API fournit de nombreuses informations : le nom du morceau en cours, la liste de lecture, l'heure de début de la lecture et sa durée, les pochettes d'album (le cas échéant) et d'autres paramètres décrits en détail dans notre documentation.
Précisions sur les clés et valeurs constituant la requête de l'API de cette URL d'exemple :
https://stream.webradiolatinos.com:1030/api/v2/ -> c'est la base de l'API de ce compte radio
history? -> on demande à l'API l'historique des titres joués puis on ajoute le point d'interrogation pour initier des clés et valeur de type GET
limit=1 -> c'est le nombre de résultats que l'on veut, ici 1 nous fournira une seule sortie. Si 10 par exemple on aura les 10 derniers titres joués y compris celui en cours
offset=0 -> c'est la position de départ de l'historique. Le chiffre zéro détermine le tout début, on exclus donc zéro résultats. Si on voudrait les 10 derniers titres joués sans celui en cours qui est donc celui en résultat zéro, on mettrai alors 1 en offset
server=1 -> chaque compte radio est constitué d'une station qui par défaut à le numéro 1. Il faut prendre l'habitude de le spécifier dans les requêtes API car imaginons que vous ayez un jour une seconde station dans le même compte radio, elle prendre le numéro 2 et vous pourriez alors faire des requêtes API distinctes sur le server=2.
