Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

id

optional

integer which can be used for de-duplication of requests

rpuid

Required if no rpId and territory

The stations’ Radioplayer Unique ID number

rpId

Required if no rpuid. If set the territory must also be included in the URL

The old Radioplayer classic station ID

startTime

optional

the start time of the now playing data. We support the following date/time formats:

  • UNIX timestamp (number of seconds since the UNIX epoch (January 1, 1970 00:00:00 UTC))

  • time in milliseconds since the UNIX epoch (January 1, 1970 00:00:00 UTC)

  • ISO Dates (Date-Time) (e.g. “2015-03-25T12:00:00-06:30”)

If omitted, then this defaults to ‘now’.

duration

optional

The duration of the song in seconds. If omitted, the default value is 180 seconds

title

required

The song title, max length is 128 characters

artist

optional

The artist name, max length is 128 characters

description

optional

An additional description. Max length is 180 characters

imageUrl

optional

URL to an image that will be shown with this event and which you have permission to distribute.

We prefer square images, and there is a minimum resolution of 600x600 - any smaller than that and we don’t use them as they don’t look good on apps and in car systems.


Note that to maintain backwards compatibility with Radioplayer Classic, to submit a now playing event using a territory RPID rather than a Cloud RPUID, you must use the parameter rpId - note the capitalisation - for the request to be successfully authenticated.

...

Code Block
breakoutModewide
xsi:schemaLocation="http://www.radioplayer.co.uk/schemas/11/epgSI http://www.radioplayer.co.uk/schemas/11/epgSI_11.xsd"

Image sizes

...

When you send station images, you can provide us just high quality square (1400x1400) and landscape (1920x1080) images and we will generate smaller versions of them by cropping them (if necessary) and shrinking them down. Contact your country manager if you want to do this so we can configure our system to do it for you. Alternatively, send all images and we will attach them to your station.

When you send a station update, we will only reprocess images if they are included in the station record. If you do not include an image, we will leave the previous one as it is.

For schedule updates, please provide the following images sizes to guarantee that the correct imagery is available throughout our products

...