Guides

Point de terminaison : /api/v2/history/
Méthodes HTTP : GET
Authentification : non requise
Paramètres :
limit : nombre d’enregistrements dans la réponse
offset : indique l’enregistrement de départ
server : ID du serveur radio

L'historique des titres diffusés à la radio ; le dernier titre affiché par cette API est celui qui est actuellement diffusé.

Exemple en Pyhton :

import requests

response = requests.get("https://demo.streaming.center:8080/api/v2/history/?limit=1&offset=0&server=1")
print(response.json())

Exemple en PHP avec cURL :

$url = "https://demo.streaming.center:8080/api/v2/history/?limit=1&offset=0&server=1";

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Désactiver la vérification SSL (comme avant)
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 la réponse JSON formatée
header('Content-Type: application/json');
echo $response;

Exemple de sortie JSON :

{
   "count":500,
   "next":"https://demo.streaming.center:8080/api/v2/history/?limit=1&offset=1&server=1",
   "previous":"None",
   "results":[
      {
         "album":"Ozzmosis (Expanded Edition)",
         "all_music_id":1190,
         "author":"Ozzy Osbourne",
         "author_other":"None",
         "comment":"None",
         "composer":"None",
         "dj_name":"AutoDJ",
         "genre":"None",
         "id":11552,
         "img_fetched":true,
         "img_large_url":"https://demo.streaming.center:8080/media/tracks/trackImage1190_large.jpg",
         "img_medium_url":"https://demo.streaming.center:8080/media/tracks/trackImage1190_medium.jpg",
         "img_url":"https://demo.streaming.center:8080/media/tracks/trackImage1190.jpg",
         "isrc":"None",
         "jingle_id":"None",
         "label":"None",
         "length":296347,
         "lyricist":"",
         "metadata":"Ozzy Osbourne - I Just Want You",
         "n_listeners":0,
         "performance_type":"None",
         "playlist_title":"All music",
         "publisher":"None",
         "title":"I Just Want You",
         "ts":1733763534000,
         "year":"None"
      }
   ]
}

Description

• album : album de pistes
• all_music_id : l’identifiant du morceau dans la bibliothèque musicale du serveur. Si le morceau est un jingle, ce paramètre est nul. Si le morceau a été joué en direct et ne provient pas de la bibliothèque musicale du DJ automatique, ce paramètre est nul.
• author : artiste du morceau
• author_other : co-auteur
• comment : suivre les commentaires
• composer : compositeur
• dj_name : le nom du DJ qui a joué ce morceau.
• genre : genre de composition
• id : identifiant de l'historique de suivi (valeur unique)
• img_fetched : le système a tenté de télécharger la pochette du morceau depuis les services de musique (Apple Music, Spotify, MusicBrainz) si elle était absente des métadonnées MP3 du fichier.
• img_large_url : URL de l'image de la pochette du morceau en résolution maximale, sans compression.
• img_medium_url : – une version de taille moyenne de l’image obtenue par le système en compressant l’image originale à 500 × 500 pixels
• img_url : une mini-pochette de morceau, généralement en résolution 100x100 pixels
• isrc : Code ISRC (utilisé dans les rapports de redevances)
• jingle_id : si le morceau est un jingle, ce paramètre contient l’identifiant du jingle dans la base de données de contenu Auto-DJ.
• label : étiquette
• length : durée de la piste en millisecondes
• lyricist : l'auteur des paroles
• metadata : les métadonnées finales avec lesquelles le morceau a été diffusé indiquent généralement le nom de l’artiste, mais elles peuvent également contenir d’autres données, selon leur format, spécifié dans la section « Paramètres » du panneau de commande de la radio : par exemple, le nom du DJ.
• n_listeners : nombre d'auditeurs à la radio au moment où le morceau a commencé à être diffusé.
• type_de_performance : type de performance : vocale, instrumentale, lecture, etc.
• playlist_title : le nom de la playlist diffusée peut être nul pour les jingles et les morceaux joués lors des diffusions en direct.
• publisher : éditeur
• titre : nom de la piste
• ts : heure de diffusion (entier) en millisecondes, fuseau horaire : UTC
• year : année de suivi