Get Channel Next Playing (REST)

Overview

The next playing function displays a basic RSS 2.0-like feed that describes what is scheduled to play next on the channel that is within 24 hours.

Request URL

http://myserver:3000/xml/playing?when=next

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

Parameters

Parameter Type Required Format Description
id Integer Range from 1 to 20 (depending on your server) Channel ID. If omitted, Channel 1 is used.

Examples of valid URL parameters and what they return:

  • http://myserver:3000/xml/playing?when=next – Returns next playing program on Channel 1.
  • http://myserver:3000/xml/playing?when=next&channel_id=2 – Returns next 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=next 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: "Next Playing" RSS

XML of a successful response:

<!--?xml version="1.0" encoding="UTF-8"?-->
 
<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 - Adoption</title>
      <pubDate>Sat, 19 Jan 2013 01:00:00 -0500</pubDate>
      <psg:eventId>15</psg:eventId>
      <psg:duration>30</psg:duration>
      <psg:end_datetime>Sat, 19 Jan 2013 01:00:30 -0500</psg:end_datetime>
      <psg:programCode/>
      <psg:episode>Hamster</psg:episode>
      <psg:episodeCode/>
      <psg:thumbnail>http://ninjagaiden:3000/thumbnails/15.jpg</psg:thumbnail>
      <description>
        In 2003, the Ad Council partnered with the Children’s Bureau
        and AdoptUSKids on a national adoption recruitment campaign to
        encourage the adoption of children from foster care. PSA’s
        have been developed with a specific annual focus, including
        teens, Spanish language, African-Americans, sibling groups,
        and children 8 and older. The consistent tag line, 'You don’t
        have to be perfect to be a perfect parent', has been used to
        communicate a humorous angle on the seemingly challenging task
        of adopting from foster care. It reassures prospective parents
        that even if not 'perfect,' they have the ability to provide
        the stability and security that children in foster care need
        and deserve.
      </description>
      <link>http://10.10.10.10</link>
      <vodURL/>
      <guid>00:25:90:21:73:5A-15</guid>
    </item>
  </channel>
</rss>
Facebooktwittergoogle_pluslinkedin