Publishers - stream metadata RSS


Stream players that want to display which show is currently playing and what is next up can use the stream RSS feed:
http://iono.fm/rss/stream/prov/<provider_id>
Where <provider_id> is the same one as used for other RSS integrations.


RSS contents

The ionofm namespace and the itunes namespace elements are included in the feed, as appropriate. 

The <channel> part of the RSS feed is populated by data from the main object that the stream belongs to (the provider in this case) and provides global data around the stream.
  • It's <link> element contains a URL to the embedded web player for this feed.
  • Client applications can use the <ionofm:stream> element to determine the latest direct streaming URLs.

Each RSS <item> element specifies a show with it's start time and duration. Each of these corresponds to a channel on our platform, and this feed is assembled from the schedule metadata configured for each channel via our admin interface.

All the <item> elements are sorted in chronological order, with the first item being either current show or the next one after that

Note that this feed may contain zero <item> elements if no channel schedules are configured! Additionally, there may be gaps between the the shows, depending on the configuration of the channel schedules.  


Time values and determining the current show

The main <channel> element contains the <lastBuildDate> element which indicates the creation date of the feed. Note that the feed contents may be cached by our platform so the <lastBuildDate> value may be in the past - it must not be seen as a current server time.

Each <item> element contains the following fields that can be used by client applications to determine and display the current and next shows:
  • The <pubDate> field indicates the start time of the show.
  • The <ionofm:endDate> element (as specified in our ionofm namespace) indicates the end of the show.
  • The <itunes:duration> element indicates the running time of the show.

Content limits

Clients can include the limit URL parameter in the request to limit the number of items returned. For example:
http://iono.fm/rss/stream/prov/179?limit=2
If no limit is specified the default is 10 items. Note that this feed, like our others, will never return more than 60 items!


Example item

An example <item> entry of a 1 hour show (the http://iono.dev/c/183 channel) from 9AM to 10AM:
<item>
<title>Interviews</title>
<link>http://iono.dev/c/1836</link>
<guid isPermaLink="true">http://iono.dev/c/1836</guid>
<description><![CDATA[Channel description]]></description>
<itunes:summary>Channel description</itunes:summary>
<pubDate>Mon, 29 Jun 2015 09:00:00 +0200</pubDate>
<ionofm:endDate>Mon, 29 Jun 2015 10:00:00 +0200</ionofm:endDate>
<itunes:author>CliffCentral.com</itunes:author>
<itunes:image href="http://link.to/image.512.png"/>
<itunes:duration>1:00:00</itunes:duration>
<source url="http://iono.dev/rss/chan/1836">Interviews</source>
<ionofm:thumbnail href="http://link.to/thumbnail.128.png"/>
</item>


Feedback and Knowledge Base