Get Channel Now Playing (REST)

Overview

The now playing function displays a basic RSS 2.0-like feed that describes what is currently playing on the channel.

Request URL

http://myserver:3000/xml/playing?channel_id=1&when=now

Substitute the hostname, domain, or IP Address of your server instead of myserver.

Parameters

Parameter Type Required Format Description
channel_id Integer Range from 1 to 20 (depending on your server) Channel ID. If omitted, Channel 1 is used.
when String Yes “now” or “next” Controls which event is returned; current or next

Examples of valid URL parameters and what they return:

  • http://myserver:3000/xml/playing?when=now – Returns currently playing program on Channel 1.
  • http://myserver:3000/xml/playing?channel_id=2&when=now – Returns currently playing program on Channel 2.

Returns

Success

The feed’s response can be tested in a web browser. Browse http://myserver:3000/xml/playing?when=now in your web browser. The information displayed depends on your browser, but typically includes the program name, date and time of broadcast, and a description from the content metadata as in this example:

Screenshot: "Now Playing" RSS

XML of a successful response:

<rss xmlns:psg="http://ninjagaiden:3000/psg_namespace/" version="2.0">
  <channel>
    <title>TelVue Princeton Channel 1</title>
    <description>TelVue Princeton Broadcast Channel 1</description>
    <item>
      <title>Ad Council - Making Home Affordable</title>
      <pubDate>Fri, 18 Jan 2013 12:01:03 -0500</pubDate>
      <psg:eventId>38</psg:eventId>
      <psg:duration>60</psg:duration>
      <psg:end_datetime>Fri, 18 Jan 2013 12:02:03 -0500</psg:end_datetime>
      <psg:programCode/>
      <psg:episode>I'm Home</psg:episode>
      <psg:episodeCode/>
      <psg:thumbnail>http://ninjagaiden:3000/thumbnails/2.jpg</psg:thumbnail>
      <description>
        Making Home Affordable is an initiative that includes a mortgage modification program to provide eligible homeowners with more affordable monthly mortgage payments. The Federal Government provides free resources to struggling homeowners to help them learn about options under the program, and to work with a HUD-approved housing counselor. Since the program launch, over one million homeowners have received help.
      </description>
      <link>http://10.10.10.10</link>
      <vodURL/>
      <guid>00:25:90:21:73:5A-38</guid>
    </item>
  </channel>
</rss>
Facebooktwittergoogle_pluslinkedin