Atom Categories

From RadioConnected
Jump to: navigation, search

Atom defines a general-purpose <category> element with the following attributes:

term
A string that identifies the category to which the entry or feed belongs.
scheme
An optional URI identifying a categorization scheme.
label
An optional human-readable label.

Application

The category element is used to identify totallyradio records in various ways. The following schemes are used:

http://totallyradio.com/stations
Identifies which station an entity belongs to.
http://totallyradio.com/shownames
Identifies which show an entity belongs to.
http://totallyradio.com/episodes
Identifies an episode.
The above categories are also used as a web-safe ID for URL generation. For example, if an episode entry contains the following categories:
    <category scheme="http://totallyradio.com/episodes" term="86480"/>
    <category label="the daily show" scheme="http://totallyradio.com/shownames" term="the-daily-show"/>
    <category label="totallyradio" scheme="http://totallyradio.com/stations" term="totallyradio"/>
then a client can generate a web-safe URI /totallyradio/the-daily-show/86480. Likewise the corresponding show would have a URI /totallyradio/the-daily-show.
http://totallyradio.com/genres
Marks an entity as belonging to a specific genre, which is a controlled vocabulary specific to totallyradio.
http://totallyradio.com/keywords
One or more keywords or tags, this is an open vocabulary entered by totallyradio editors.