API-metoder: Musik

Här beskrivs de metoder som gör det möjligt att hitta låtinformation.

"Just nu" - Låtlista per kanal

Listar den låt som spelas just nu i angiven kanal samt nästkommande låt.

URL:

http://api.sr.se/api/v2/playlists/rightnow?channelid={id}

Parametrar:

channelid (obligatorisk) - listar "låt just nu" endast för angiven kanal. Kanalerna fås med metoden lista kanaler

Se avsnittet generella parametrar för fler parametrar.

Exempelanrop:

http://api.sr.se/api/v2/playlists/rightnow?channelid=2576 - hämta låtlista för kanalen "Din gata" (channelid = 2576)

Svar:

En playlist returneras och kan innehålla 4 underobjekt.

previoussong - föregående låt som spelas just nu i den valda kanalen
song - den låt som spelas just nu i den valda kanalen
nextsong - nästkommande låt som ska spelas i kanalen
channel - beskriver kanalen med två attribut, id och name

De två låt-objekten är uppbyggda av samma element. Se beskrivning som följer på en låts element:

title - låtens titel
description - beskrivningen är en sammansättning av artist alt. tonsättare och låtens titel separerat med -
artist - låtens artist/artister
composer - låtens tonsättare
conductor - låtens dirigent
albumname - albums namn
recordlabel - skivbolagets namn
lyricist - låtens sångskrivare
producer - låtens producent
starttimeutc - låtens startid i utc
stopttimeutc - låtens stoptid i utc

Exempelsvar (förkortat):


                    <?xml version="1.0" encoding="utf-8"?>
<sr>
  <copyright>Copyright Sveriges Radio 2012. All rights reserved.</copyright>
  <playlist>
    <song>
      <title>Black Heart</title>
      <description>Stooshe - Black Heart</description>
      <artist>Stooshe</artist>
      <composer>Karis Anderson, Alexandra Buggs, Jo Per</composer>
      <conductor />
      <albumname />
      <recordlabel />
      <lyricist />
      <producer />
      <starttimeutc />
      <stopttimeutc />
 </song>
    <nextsong>
      <title>U Remind Me</title>
      <description>Usher - U Remind Me</description>
      <artist>Usher</artist>
      <composer>MCCLOUD, A/CLEMENT, E</composer>
      <conductor />
      <albumname />
      <recordlabel />
      <lyricist />
      <producer />
      <starttimeutc />
      <stopttimeutc />
   </nextsong>
    <channel id="2576" name="Din gata" />
  </playlist>
</sr>

Kanals låtlista för tidsintervall

Listar låtar som spelats i en kanal i angivet tidsintervall.

URL:

http://api.sr.se/api/v2/playlists/getplaylistbychannelid?id={id}&startdatetime={startdatetime}&enddatetime={enddatetime}

Parametrar:

channelid (obligatorisk) - listar "låt just nu" endast för angiven kanal. Kanalerna fås med metoden lista kanaler
startDateTime (default: dagens datum utan tid)
endDateTime (default: startDateTime + en dag)
size Sidstorlek (default: 20)
format xml|json|jsonp (default: xml)

Exempelanrop:

http://api.sr.se/api/v2/playlists/getplaylistbychannelid?id=132&startdatetime=2014-09-01 - hämta låtlista för p1 den 1 sept 2014

Exempelsvar (förkortat):


                    <?xml version="1.0" encoding="utf-8" ?>
<songlist>
    <copyright>Copyright Sveriges Radio 2014. All rights reserved.</copyright>
    <song>
        <title>Alla Som Inte Dansar</title>
        <description>Maskinen - Alla Som Inte Dansar</description>
        <artist>Maskinen</artist>
        <composer>Maskinen</composer>
        <starttimeutc>2014-09-01T21:30:00Z</starttimeutc>
        <stoptimeutc>2014-09-01T21:32:05Z</stoptimeutc>
        <albumname>Alla Som Inte Dansar</albumname>
        <recordlabel>P.O.P.E.</recordlabel>
    </song>
...
</songlist>

Programs låtlista för tidsintervall

Listar låtar som spelats i ett program i angivet tidsintervall.

URL:

http://api.sr.se/api/v2/playlists/getplaylistbyprogramid?id={id}&startdatetime={startdatetime}&enddatetime={enddatetime}

Parametrar:

channelid (obligatorisk) - listar "låt just nu" endast för angiven kanal. Kanalerna fås med metoden lista kanaler
startDateTime (default: dagens datum utan tid)
endDateTime (default: startDateTime + en dag)
format xml|json|jsonp (default: xml)

Exempelanrop:

http://api.sr.se/api/v2/playlists/getplaylistbyprogramid?id=3718&startdatetime=2014-09-01 - hämta låtlista för alla tankesmedjans avsnitt den 1 sept 2014

Exempelsvar (förkortat):


                    <?xml version="1.0" encoding="utf-8" ?>
<songlist>
    <copyright>Copyright Sveriges Radio 2014. All rights reserved.</copyright>
    <song>
        <title>Alla Som Inte Dansar</title>
        <description>Maskinen - Alla Som Inte Dansar</description>
        <artist>Maskinen</artist>
        <composer>Maskinen</composer>
        <starttimeutc>2014-09-01T21:30:00Z</starttimeutc>
        <stoptimeutc>2014-09-01T21:32:05Z</stoptimeutc>
        <albumname>Alla Som Inte Dansar</albumname>
        <recordlabel>P.O.P.E.</recordlabel>
    </song>
...
</songlist>

Ett programavsnitts låtlista

Listar låtar som spelats i ett programavsnitt (episode).

URL:

http://api.sr.se/api/v2/playlists/getplaylistbyepisodeid?id={id}

Parametrar:

channelid (obligatorisk) - listar "låt just nu" endast för angiven kanal. Kanalerna fås med metoden lista kanaler
startDateTime (default: dagens datum utan tid)
endDateTime (default: startDateTime + en dag)
format xml|json|jsonp (default: xml)

Exempelanrop:

http://api.sr.se/api/v2/playlists/getplaylistbyepisodeid?id=422962 - hämta låtlista för ett avsnitt

Exempelsvar (förkortat):


                    <?xml version="1.0" encoding="utf-8" ?>
<songlist>
    <copyright>Copyright Sveriges Radio 2014. All rights reserved.</copyright>
    <song>
        <title>Alla Som Inte Dansar</title>
        <description>Maskinen - Alla Som Inte Dansar</description>
        <artist>Maskinen</artist>
        <composer>Maskinen</composer>
        <starttimeutc>2014-09-01T21:30:00Z</starttimeutc>
        <stoptimeutc>2014-09-01T21:32:05Z</stoptimeutc>
        <albumname>Alla Som Inte Dansar</albumname>
        <recordlabel>P.O.P.E.</recordlabel>
    </song>
...
</songlist>