Livestream Redirect

If you are primarily using HTTP Live Streaming (HLS) or Shoutcast, then livestream redirect is the recommended way to connect to Triton Digital streams. This endpoint always returns as a URL redirection, so you don’t need extensive knowledge of the Triton Digital SDK to make it work.

Livestream Redirect URL

Here are the building blocks of a live stream redirector URL:

http://playerservices.streamtheworld.com/api/livestream-redirect/<mount-name>[.<mount-extension>|_SC][?<query-string>

Item	Description	Possible Values	Required?
mount-name	The mount name.	Any valid mount name.	Yes
mount-extension	The mount name extension. Not required, but some players ask for it. Mount extensions are case sensitive.	See Mount Extensions, below.	No
query-string	If a query string is present in the initial request to the String Stream URL entry point, it must be repeated as-is on the redirection URL.	Any value.	No

For example, your station is KSAD and you are using an AAC mount, so your mount name is KSADAAC:

http://playerservices.streamtheworld.com/api/livestream-redirect/KSADAAC.m3u8?lsid=hdsjdhsjhdskj&smbid=dhsjhdjs

Mount Extensions

Mount extensions are case-sensitive.

Extension (in request URL)	Redirects to...	Transport Required
—	<mount-name>	HTTP
flv	<mount-name>	HTTP
mp3	<mount-name>.mp3	Shoutcast
aac	<mount-name>.aac	Shoutcast
_SC	<mount-name>_SC	Shoutcast
m3u8	<mount-name>/HLS/playlist.m3u8	HTTP Shoutcast HLS

Redirected URL

If successful, the player service will redirect to a URL with the following pattern:

http://<mg-host>:<mg-port>/<mount-name>[.<ext>|_SC][?<query-string>]

Status Codes

Code	Message	Description
302	Found Response	Request is successful and the redirect is done.
403	Forbidden	The requested mount name in the URL isn't available for the remote IP address.
404	Not Found	Mount was not found. This could be for any of the following reasons: Mount name was not found in the database. Building the redirection URL resulted in a malformed URL. There is no MediaGateway associated to the mount. Error while trying to redirect. Stream configuration problem, such as the mount doesn't support the provided extension.

Code

Message

Description

302

Found Response

Request is successful and the redirect is done.

403

Forbidden

The requested mount name in the URL isn't available for the remote IP address.

404

Not Found

Mount was not found. This could be for any of the following reasons:

Mount name was not found in the database.
Building the redirection URL resulted in a malformed URL.
There is no MediaGateway associated to the mount.
Error while trying to redirect.
Stream configuration problem, such as the mount doesn't support the provided extension.