Chaque station CloudRadio One a un point d'accès JSON public qui indique ce que fait le flux à l'instant même. Servez-vous-en pour bâtir votre propre affichage du titre en cours, votre indicateur de direct ou votre compteur d'auditeurs, avec votre propre JavaScript. Si vous préférez ne pas écrire de code, les widgets offrent les mêmes données sous forme d'extraits à copier-coller.
Point d'accès
GET https://public.cloudrad.io/your-station-slug/status
Le « slug » de votre station est l'identifiant qui figure dans vos URL publiques. Vous trouverez l'adresse exacte à la page Widgets et liens de votre station, dans Studio.
Le point d'accès ne demande aucune authentification et prend en charge CORS : vous pouvez donc l'appeler avec fetch() directement depuis votre propre domaine. Les réponses sont mises en cache pendant 5 secondes.
Réponse
{
"status": "online",
"source": {
"type": "live",
"collaborator": "studio",
"relay": null
},
"listeners": 12,
"current_track": {
"title": "Let There Be Light - Hans Hiptmair",
"start_time": "2026-08-05T14:03:21Z",
"artwork_url": "https://...",
"artwork_url_large": "https://..."
},
"history": [
{ "title": "Previous Song - Artist" }
],
"logo_url": "https://...",
"collaborators": [],
"relays": [],
"accepting_requests": false
}
Champs
| Champ | Signification |
|---|---|
status | online quand le flux est en ligne, offline autrement |
source.type | live quand une entrée en direct est en ondes, relay quand un relais est en ondes, automated quand AutoDJ joue |
source.collaborator | studio, guest ou dj quand source.type vaut live, sinon null. dj est l'entrée DJ qu'utilisent les émissions de DJ programmées |
listeners | Nombre d'auditeurs en ce moment |
current_track | Le titre en cours : title, plus start_time, artwork_url et artwork_url_large quand ils sont disponibles. Absent quand le titre n'a aucune métadonnée |
history | Les titres récemment diffusés, du plus récent au plus ancien, chacun avec un title |
logo_url | Le logo de votre station tiré de votre trousse de marque, s'il est défini |
source.relay, collaborators, relays et accepting_requests sont des champs réservés. Pour l'instant, ils renvoient toujours null, des listes vides ou false.
Une station hors ligne renvoie quand même la structure complète, avec "status": "offline" et source.type à automated.
En direct ou automatisé
source.type reflète ce que les auditeurs entendent, pas qui est connecté. Un DJ dont l'encodeur est connecté alors que le flux est déjà revenu à AutoDJ donne automated, et non live. Le champ change à l'instant où la station change de source, soit environ 10 secondes avant que les auditeurs HLS entendent le changement (la portion du délai du direct qui vient après la station). Pour le portrait complet, y compris les attributs de widget qui exposent le même état sans aucun JavaScript, consultez Indicateur de source en direct.
Exemple
Un affichage minimal du titre en cours, avec un badge de direct :
<div id="np"></div>
<script>
async function refresh() {
const res = await fetch("https://public.cloudrad.io/your-station-slug/status");
const data = await res.json();
const live = data.source.type === "live" ? "LIVE " : "";
const track = data.current_track ? data.current_track.title : "";
document.getElementById("np").textContent = live + track;
}
refresh();
setInterval(refresh, 10000);
</script>
Interrogez le point d'accès toutes les 10 secondes, ou moins souvent. Les réponses sont mises en cache pendant 5 secondes : l'interroger plus souvent renvoie donc la même réponse.
Produits visés
Ce point d'accès donne l'état du direct pour les stations CloudRadio One, qui utilisent notre AutoDJ et nos entrées en direct. Les stations qui ont leur propre serveur Shoutcast ou Icecast devraient plutôt utiliser les widgets de flux; la distinction entre direct et automatisé n'existe pas pour elles.