FR
Français English
Lancer votre station
Centre d'aide API d'état de la station

API d'état de la station

3 min de lecture Dernière mise à jour : 14 novembre 2026

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

ChampSignification
statusonline quand le flux est en ligne, offline autrement
source.typelive quand une entrée en direct est en ondes, relay quand un relais est en ondes, automated quand AutoDJ joue
source.collaboratorstudio, guest ou dj quand source.type vaut live, sinon null. dj est l'entrée DJ qu'utilisent les émissions de DJ programmées
listenersNombre d'auditeurs en ce moment
current_trackLe 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
historyLes titres récemment diffusés, du plus récent au plus ancien, chacun avec un title
logo_urlLe 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.

Cela vous a-t-il aidé?

Encore besoin d'aide?

Si vous n'avez pas trouvé la réponse, notre équipe est là pour vous aider.

Ouvrir un billet d'assistance