Ce guide détaille la gestion et l'affichage des métadonnées (titres, artistes) et des pochettes d'album pour un flux de Streaming Radio / Auto DJ lors de l'utilisation d'un lecteur audio personnalisé.

Prérequis

• Obtenir l'identifiant de votre radio: la valeur station_id est indispensable pour interroger les API de métadonnées et de pochettes ; il s'agit bien de l'ID de la station et non du pack radio, que vous pouvez retrouver :
  • via un appel API,
  • ou directement depuis l'URL de votre tableau de bord sur le Manager Infomaniak: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard 

Consulter les métadonnées des titres diffusés

L'affichage dynamique des titres et des pochettes sur un lecteur personnalisé s'appuie sur des requêtes API publiques (sans authentification nécessaire) ; vous pouvez obtenir la liste des métadonnées (❓: aide) des 100 derniers titres diffusés sur votre radio via un navigateur ou par une requête GET:

https://metadata.infomaniak.com/api/radio/{station_id}/metadata

Format des données retournées

Le dernier titre diffusé se trouve toujours à la fin de la liste. Chaque titre est décrit au format suivant:

{
  "duration": 565,
  "date": 1791303566,
  "microtime": 1791303566.10439,
  "title": "ARTIST - SONG TITLE",
  "cover": null
}

Détails:

• title : métadonnée formatée sous la forme ARTISTE - TITRE
• date : horodatage de début du titre exprimé en temps Unix
• microtime : horodatage précis à la microseconde en temps Unix
• duration : durée du titre en secondes (présente uniquement si le titre n'est pas en cours de lecture, correspondant à l'écart en secondes entre la réception des métadonnées de ce titre et du suivant)
• cover : ce champ n'est pas utilisé dans cette route et retourne la valeur null ; pour obtenir les pochettes, reportez-vous à la section ci-dessous.

Note : l'horodatage est exprimé en temps Unix ; il peut être converti automatiquement ou via des outils en ligne tels que UnixTimestamp ou EpochConverter…

Récupérer les pochettes d'album

Deux routes d'API sont à votre disposition pour récupérer la pochette d'un morceau sur votre radio:

1. Pochette du titre en cours de lecture (recommandé) :
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Renseignez l'heure UTC actuelle en temps Unix dans le paramètre currentTimeOfPlayer. Cette méthode est préconisée pour sa rapidité d'exécution.
2. Liste des pochettes récentes :
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Cette méthode retourne l'ensemble des pochettes les plus récentes diffusées sur la radio.