API : IPTV : App : Streaming : Featured

Introduction

This request is used by the iOS/Android apps and web clients to list featured content from PlayMaker's archive and streaming services.

Request

URL	https://api.telecomx.dk/iptv/app/streaming/featured
Method	GET
Query	token	String	Device token
Query	profile	Id	ID of DRM profile

Query examples

https://api.telecomx.dk/iptv/app/streaming/featured?profile=1234567890ABCD1234567890&token=123456789asd23

Response

The response consists is a list of the objects below. The _id is “ARCHIVE” for PlayMaker's own content.

JSON response
_id	String	Unique streaming service ID. If archive, the ID is 'ARCHIVE'
logo	String	URL for logo of streaming service
logoId	ObjectId	ID of the logo
programs	Array	List of program objects

Program object - Field	Type	Description
_id	ObjectId	Unique program ID
kind	String	Allowed values are SHOW, EPISODE, MOVIE, SPORT, EVENT, ADULT
duration	Number	Length of the program in whole minutes.
title	String	Title of the program.
subTitle	String	Teaser/sub title - short description or episode title for a series episode.
description	String	Long description for the program.
genres	Array	List of genres.

date	Date	Date program/movie/series was released/first shown, if available.
year	Number	Year program/move/series was released/first shown, if available.
country	string	Country where program was produced, e.g. 'Amerikansk'. If multiple countries, comma separated string, if available.
credits	Array	List of credited persons for this program.
credits[].type	String	What the person is credited for: ACTOR, DIRECTOR, PRODUCER, DIRECTOR-PRODUCER, PRESENTER, MUSIC, CONDUCTOR, WRITER e.t.c.
credits[].role	String	Name of the role played, if type is ACTOR.
credits[].name	String	Name of person.
credits[].image	ObjectId	ID of image of the credited person.
imagesIds	Array	List of image IDs from image server
streams	Array	Properties used, if the program is available on streaming services
streams[].streamingService	String (enum)	Which streaming service this url is from.
streams[].url	String	URL/deeplink to content
ratings	Object	Contains ratings of programs, properties will be the rating database, and the value is a float, eg. “imdb”: 7.4.
epgList	Array	List of EPG calendar objects, showing which channels and at time this program is currently played on
epgList[]. _id	String	Id of program.
epgList[].channelId	Number	Id of the TV channel carrying this show
epgList[].channelName	String	Name of channel from IpTvBaseChannels.
epgList[].channelLogo	String	URL of channel logo
epgList[].start	Date	Start time.
epgList[].end	Date	End time.
epgList[].realStart	Date	Real start time, if available.
epgList[].realEnd	Date	Real end time, if available.
epgList[].rerun	Boolean	Is this a re-run of the program, if available.
epgList[].live	Boolean	Is this program live, if available.
epgList[].premiere	Boolean	Is this the premiere of the program, if available.
epgList[].availableUntil	Date	The date when this EPG is no longer available in archive

Note that properties holding no value may be omitted from the object.

Example - normal

{
    _id: 'ARCHIVE',
    name: 'Arkiv',
    logo: null,
    logoId: null,
    programs:[
        {
            "_id": "1234567890ABCD1234567890",
            "duration": 105,
            "title": "Jagten 2",
            "subTitle": "Prisvindende dansk spillefilm fra 2013",
            "description": null,
            "genres": [
                "Krimi",
                "Drama"
            ],
            "date": null,
            "year": 1990,
            "country": null,
            "credits": [
                {
                    "name": "Kevin Whately",
                    "type": "ACTOR",
                    "role": "Lewis"
                },
                {
                    "name": "John Thaw",
                    "type": "ACTOR",
                    "role": "Morse"
                },
                {
                    "name": "Tom Wilkinson",
                    "type": "ACTOR",
                    "role": "Jake Normington"
                },
                {
                    "name": "John Madden",
                    "type": "DIRECTOR",
                    "role": null
                }
            ],
            "imageIds": [
                "1234567890ABCD1234567890"
            ],
            "ratings": {
                "imdb": 8.2
            },
            "streams": [
              {
                 "streamingService": "DR_TV",
                 "name": "DR TV",
                 "logo": "https://image.powernet.tv/1234567890ABCD1234567890.png",
                 "logoId": '"234567890ABCD1234567890",
                 "url": "https://dr.dk/programmer/129381737"
              }     
           ],
            "epgList": []	
           },
           { ... }    
    ],
    _id: 'NETFLIX',
    name: 'Netflix',
    logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png',
    logoId: '1234567890ABCD1234567890',
    programs: [
        { ... }
    ],
    _id: 'HBO',
    name: 'HBO',
    logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png',
    logoId: '1234567890ABCD1234567890',
    programs: [ { ... }, { ... } ]
}

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
500	internal_error	<Unspecified>

WIKI

Table of Contents