Totallyradio feed overview

From RadioConnected
Jump to: navigation, search

See also: Atom Links Atom Categories Images

Totallyradio has three main entities: stations, shows and episodes, each of which has one or more associated feeds.

The feeds are interlinked, which means it is possible to start at a known feed and then navigate to other related feeds using the link elements.

Entities at all levels have common elements. The Atom spec defines these but in terms of totallyradio they are used as follows:

title
The title element is used to represent the title of the entity (station, show or episode).
summary/subtitle
In a feed header subtitle is used, in an entry summary is used, to describe the entity.
icon and logo
See Images
updated
In stations and shows, this is set to the date of the most recently updated episode. In episodes this is the same as the published date, unless the episode has been edited since publication.

Stations

See Station elements

Represents a radio station. This is the highest-level object. Typically there is only one radio station, totallyradio. However the possibility exists for adding another, for example Juice On Demand.

GeoRSS is used to locate the station.

Shows

See Show elements

Represents a radio show within a station.

Episodes

See Episode elements

Represents an individual episode of a radio show. Episodes may be broadcast daily, weekly etc.

published
The published date is used to identify the date an episode was made available to the public. This will be less than or equal to the updated element.

Feeds

This gives us three types of feed, defined by the entity they contain: stations, shows and episodes.

These feeds are available at three levels.

At the top (Stations) level, three feeds are available:

Stations
All stations in the system
Shows
All shows, for all stations
Episodes
All episodes, for all stations and shows

At the next (Shows) level, two feeds are available for each station:

Shows
All shows for the selected station
Episodes
All episodes for the selected station

At the bottom (Episodes) level, one feeds is available for each show:

Episodes
All episodes for the selected show