Deze handleiding beschrijft hoe u de metadata (titels, artiesten) en de albumhoezen van een Streaming Radio / Auto DJ-stream kunt beheren en weergeven wanneer u een aangepaste audiospeler gebruikt.

Vereisten

• U kunt de ID van uw radiostation opvragen: de waarde station_id is essentieel om de API's voor metagegevens en omslagen te bevragen; het gaat hier om de ID van het station en niet om het radiopakket, die u kunt vinden:
  • via een API-aanroep,
  • of rechtstreeks via de URL van uw dashboard in de Infomaniak Manager: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

De metagegevens van de afgespeelde nummers bekijken

De dynamische weergave van titels en omslagen op een aangepaste speler is gebaseerd op openbare API-verzoeken (geen authenticatie vereist); u kunt de lijst met metadata (❓: hulp) van de laatste 100 nummers die op uw radiostation zijn afgespeeld, ophalen via een browser of via een GET-verzoek:

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

Formaat van de geretourneerde gegevens

De meest recente titel staat altijd aan het einde van de lijst. Elke titel wordt beschreven in het volgende formaat:

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

Details:

• title: metadata die is opgemaakt in de vorm ARTIEST - TITEL
• datum: tijdstempel van het begin van de titel, uitgedrukt in Unix-tijd
• microtijd: precieze tijdstempel tot op de microseconde, uitgedrukt in Unix-tijd
• duur: de duur van het nummer in seconden (wordt alleen weergegeven als het nummer niet wordt afgespeeld, en komt overeen met het tijdsverschil in seconden tussen het ontvangen van de metadata van dit nummer en het volgende nummer).
• cover: dit veld wordt niet gebruikt in deze route en retourneert de waarde null; raadpleeg de onderstaande sectie voor informatie over het ophalen van omslagen.

Let op: de tijdsaanduiding wordt weergegeven in Unix-tijd; deze kan automatisch worden omgezet of met behulp van online tools zoals UnixTimestamp of EpochConverter…

Albumhoezen ophalen

Er zijn twee API-routes beschikbaar om de albumhoes van een nummer op uw radio op te halen:

1. Ophalen van de titel van het huidige nummer (aanbevolen):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Vul de huidige UTC-tijd in Unix-tijd in de parameter currentTimeOfPlayer in. Deze methode wordt aanbevolen vanwege de snelle uitvoering.
2. Lijst van recente afspeellijsten:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   Deze methode retourneert alle meest recente afspeellijsten die op de radio zijn afgespeeld.