Part of Mediastream's Live Audio service is Now Playing: which allows the native audio player to deliver metadata of the artists, songs, ads. etc.
Now we are going to explain how to use the Rest API to be able to send Live Audio (radio) information and to be able to use the metadata with the Now Playing service of Mediastream.
Player showing previous songs:
You must first have your API Key to write, you can get it in Platform Tokens (https://platform.mediastre.am/settings/api).
Available for sending metadata using the API and for Adswizz branding
GET or POST Method: https://nowplaying.mdstrm.com/api/artistsApi/nowplaying
apikey = API_KEY_PLATFORM (Get from Platform, it's called Nowplaying https://platform.mediastre.am/settings/api)
stationid = ID_LIVE_PLATFORM
artistname = STRING
artistimage = BASE64 (available in POST method)
songtitle = STRING
force = true (when you don't want to use the Nowplaying Metadata service)
Example in GET to send artist and Song:
https://nowplaying.mdstrm.com/api/artistsApi/nowplaying?apikey=API_KEY_PLATFORM&stationid=5fb6bc603d70fc092488668d&artistname=rush&songtitle=bravado
The answer should be:
{"status": "OK","message": "STATION_INFO_UPDATED","type": "SONG"}
You can check the Live streaming to immediately check if the song was recognized in our Now Playing database and in Raw API Data.
Example in GET to send artist, song and that does not use the Nowplaying system so that it does not have to validate if it exists in our database:
https://nowplaying.mdstrm.com/api/artistsApi/nowplaying?apikey=API_KEY_PLATFORM&stationid=5fb6bc603d70fc092488668d&artistname=rush&songtitle=bravado&force=true
Example in GET to send a brand in the artist field to insert ads Ads Insertion Adswizz in 2 minutes:
https://nowplaying.mdstrm.com/api/artistsApi/nowplaying?apikey=API_KEY_PLATFORM&stationid=5fb6bc603d70fc092488668d&artistname=ADWTAG_120000_0
Here is an example to use with the radio automation system Proppfrexx http://www.proppfrexx.radio42.com/
Post example for Proppfrexx Radio 42
https://nowplaying.mdstrm.com/api/artistsApi/nowplaying|apikey=APIKEYTOKEN&stationid=ID_RADIO&artistname=${cpltrackartistcurrent}&songtitle=${plstracktitlecurrent}&artistimage=${albumart}