RadioTime Extensions

We add just a few concepts to the basic radio domain.

The first are partners and devices. You, as an integrator of the API, are considered a partner. Your application, if it happens to live on dedicated hardware, is a device. Otherwise we might call it a product or application.

The person using the application may have a RadioTime account. These accounts are typical of any site offering registration – we store a username, hashed password, and other details that constitute a profile. Users may log in and adjust their settings directly on radiotime.com.

Presets

Each account may have associated presets, otherwise known as favorites or bookmarks. Presets come in three flavors:

• Stations
• Shows
• URLs

Groups of presets may be organized in a preset folder. Every user has a default folder in which his or her presets live.

From a developer perspective, presets are managed “in the cloud” and are portable between devices, applications, and the website. One of the key features this enables is intelligent filtering – a stream compatible with one device but not another will be displayed differently on those devices.

Presets may have an assigned slot, such as you might find on your car stereo, to enable custom sorting.

Preset URL

Only preset stations and programs may be manipulated on the website. Preset URLs are an extension reserved for application partners. The primary use case is to save a custom stream entered by a user, but there are more interesting possibilities. We recommend using the URI format if you go this direction. Examples:

# To save a search as a preset
search://indiana radio

# To save an alternative service item
local://serviceId.value