Provisioning Request

Prev Next

For Triton Digital’s production platform, the provisioning API’s URL is:

http://playerservices.streamtheworld.com/api/livestream?version=<version>&(mount=<mount-name>|station=<station-name>)[&lang=<lang>][&transports=<transport1>[,<transportN…>]]

The URL must be called via the GET method, and the parameters below are accepted as part of the query string (parameter names are case-sensitive).

Provisioning request parameters

Name

Value

Required

Comment

version

The Player Provisioning API’s version (current version is 1.9)

Yes

The only currently supported versions are 1, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 1.8 and 1.9.  The version number is bumped when the API has major changes, in order to maintain backward compatibility.  The returned XML’s format changes according to the version number passed in by the player. This document only describes version 1.9.

mount

The mount’s name (e.g. WXYZFM).

One of mount or station

Triton Digital provides the mount name when a new mount is configured. The value is case-sensitive.

station

The station’s name (e.g., WXYZ)

One of mount or station

Triton Digital provides the station name when a new mount is configured. The value is case-sensitive.

If a station name is used instead of a mount name, all of the station's mounts will be returned.

transports

The desired transports as a comma-separated list.

Valid values:

  • http

  • shoutcast

  • hls

No

If not present, the transports default to http, shoutcast, hls.

The transports setting has been deprecated.

Player Services Regional Endpoints

The player services always returns the global endpoint by default. However, you can choose to override the global endpoint value and use a regional endpoint instead. For more information, see Global and Regional CMOD Endpoints.

There are three available playerservices endpoints for global geographic regions. For best results (quicker listener connection, etc.) use the one that is closest to the location of most of your listeners. (Note that the examples in this article all use the playerservices endpoint.)

Endpoint

Region

playerservices

North America, South America.

ap-playerservices

Asia-Pacific.

eu-playerservices

Europe, Africa.