If you are primarily using HTTP Live Streaming (HLS) or Shoutcast, livestream redirect is the recommended way to connect to Triton Digital streams. This endpoint will always return as a URL redirection, so you don’t need extensive knowledge of the Triton Digital SDK to make it work.
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>
Livestream Redirect Parameters
| Parameter | Description | Possible Values | Mandatory? |
|---|---|---|---|
mount-name | The mount name. | Any valid mount name. | Yes |
mount-extension | The mount name extension. Not required, but some players ask for it. Note that extensions are case sensitive. | See Mount Extensions table, 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, if your station is KSAD using an AAC mount (“KSADAAC”):
http://playerservices.streamtheworld.com/api/livestream-redirect/KSADAAC.m3u8?lsid=hdsjdhsjhdskj&smbid=dhsjhdjs
Mount Extensions (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 |
|
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 mount parameter) isn't available for the remote IP address. |
404 | Not Found | Mount was not found. This could be for any of the following reasons:
|