API : IPTV : App : Channel start over

Introduction

This request is used by the iOS/Android apps and web clients to get the streaming url for archive streaming of a channel. The start time will automatically be set to the start time of the program currently being broadcasted on the channel.

This is also used by the system to track that the device is now showing the channel, so it's important to call Channel stop when playback ends.

Request

URL	https://api.telecomx.dk/iptv/app/channel/CHANNEL_ID/startover
Method	GET
Params	CHANNEL_ID	Id of the channel to start streaming.
Query	token	String	Session token.
	lat	Number	GPS Latitude position in decimal format.
	long	Number	GPS Longitude position in decimal format.
	mode	String	`[optional]` Specifies type of streams to return: DASH, HLS or ALL for both.

Query examples

https://api.telecomx.dk/iptv/app/channel/12345678901234567890ABCD/startover?token=123456780123456780ABCD&lat=55.345435&long=23.347656
https://api.telecomx.dk/iptv/app/channel/12345678901234567890ABCD/startover?mode=ALL&token=123456780123456780ABCD&lat=55.345435&long=23.347656

Response

JSON object
airplay	Boolean	True if device may airplay/chromecast the video.
pause	Boolean	True if the UI may permit pause and resume (timeshift on live).
forwards	Boolean	True if the UI may permit scrubbing forward in time.
backwards	Boolean	True if the UI may permit scrubbing backwards in time.
sdhSubtitleTrack	String	Name of subtitle track for hearing-impaired.
drm	Object	DRM settings, if channel uses DRM.
drm.assetId	String	DRM asset id.
drm.fairplayLicenseUrl	String	URL to fetch FairPlay licenses from.
drm.fairplayCertificateUrl	String	URL to fetch the FairPlay certificate from.
drm.widevineLicenseUrl	String	URL to fetch WideVine licenses from.
drm.playreadyLicenseUrl	String	URL to fetch PlayReady licenses from.
streams	Array	List of URL's the stream is available from in the format specified in mode. Not used if mode is ALL. Always use the first, only move on to the next if streaming does not begin.
hls	String	HLS stream to playback. Only used if mode is ALL.
dash	String	DASH stream to playback. Only used if mode is ALL.
epgId	String	Id of the program that will be shown from the start.
epgStart	Date	Date and time from which playback will start.

Example - mode not set

{
  airplay: true,
  pause: true,
  forward: false,
  backward: true,
  position: 300,
  sdhSubtitleTrack: "t1",
  drm: {
    "assetId": "C72E747F-2224-E24B-2899-854665662AB7",
    "fairplayLicenseUrl": "https://fps.drmprovider.com/api/licenses/ASSETID?streamToken=TOKEN",
    "widevineLicenseUrl": "https://widevine.drmprovider.com?pX=5678945&streamToken=TOKEN",
    "playreadyLicenseUrl": "https://playready.drmprovider.com?px?pX=5763579&streamToken=TOKEN",
    "fairplayCertificateUrl": "https://api.powernet.tv/iptv/playmakerfairplay.cer"
  },
  "epgId": "23_46562772",
  "epgStart": "2020-01-01T00:00:00.000Z",
  "streams": [
    "https://str01.powernet.tv/7/index.m3u8?key=43567823td23tyfdgjiewqghucvbjkdshj&start=2017-01-01T00:00:00.000Z&end=2017-01-01T01:00:00.000Z",
    "https://str02.powernet.tv/7/index.m3u8?key=43567823td23tyfdgjiewqghucvbjkdshj&start=2017-01-01T00:00:00.000Z&end=2017-01-01T01:00:00.000Z",
    "https://str03.powernet.tv/7/index.m3u8?key=43567823td23tyfdgjiewqghucvbjkdshj&start=2017-01-01T00:00:00.000Z&end=2017-01-01T01:00:00.000Z"
  ]
}

Example - mode=ALL

{
  airplay: true,
  pause: true,
  forward: false,
  backward: true,
  position: 300,
  sdhSubtitleTrack: "t1",
  drm: {
    "assetId": "C72E747F-2224-E24B-2899-854665662AB7",
    "fairplayLicenseUrl": "https://fps.drmprovider.com/api/licenses/ASSETID?streamToken=TOKEN",
    "widevineLicenseUrl": "https://widevine.drmprovider.com?pX=5678945&streamToken=TOKEN",
    "playreadyLicenseUrl": "https://playready.drmprovider.com?px?pX=5763579&streamToken=TOKEN",
    "fairplayCertificateUrl": "https://api.powernet.tv/iptv/playmakerfairplay.cer"
  },
  "epgId": "23_46562772",
  "epgStart": "2020-01-01T00:00:00.000Z",
  hls: 'https://str01.powernet.tv/7/index-125436575-3600.m3u8?key=43567823td23tyfdgjiewqghucvbjkdshj',
  dash: 'https://str02.powernet.tv/7/Manifest-125436575-3600.mpd?key=43567823td23tyfdgjiewqghucvbjkdshj'
}

Errors

Error code	Message	Description
404	channel	Channel not found
403	geoblock	The device is outside the region where playback is permitted
404	start	Not in archive
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents