API : IPTV : EPG Get

Introduction

This request will return the data about a single program in the Electronic Program Guide.

Request

URL	https://api.telecomx.dk/iptv/epg/EPG_ID
Method	GET
Access level	VIEWER, MANAGER, OWNER, RESELLER or ADMIN
Param	EPG_ID	ID of the program.

Query examples

https://api.telecomx.dk/iptv/epg/7_1482885000

Response

JSON object
_id	String	Unique ID of the program.
channelId	Number	Id of the TV channel carrying this show.
channelName	String	Name of channel
channelLogo	String	URL for logo of channel
start	Date	Date and time the program starts.
end	Date	Date and time the program ends.
duration	Number	Length of the program in 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.
series	Object	Episode data - only available for series.
series.episode	Number	Episode number in the season, if available.
series.episodeTitle	String	Episode title, if available.
series.episodesInSeason	Number	Number of episodes in the season, if available.
series.season	Number	Season number, if available.
series.id	String	Unique id of the series, if available.
date	Date	Date program/movie/series was released/first shown, if available.
country	string	Country of origin (ISO3166-2 country code). 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 etc.
credits[].role	String	Name of the role played, if type is ACTOR.
credits[].name	String	Name of person.
images	Array	List of poster images available for the program.
images[].type	String	Image version data, usually WIDTHxHEIGHT.
images[].url	String	URL to retrieve the image.
imageIds	Array	List of image ids.
restrictions	Array
restrictions[].nPvr	Boolean	true if nPvr Restricted
restrictions[].archive	Boolean	true if archive is restricted
restrictions[].startOver	Boolean	true if start over is restricted

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

To fetch the images from the imageIds array, use this format:

https://image.powernet.tv/<IMAGE_ID>.<jpg|png|gif|tiff|webp>?property=value...

Jpg format is recommended. A number of optional properties may also be applied to alter the returned image:

property	Description	Example
width	Resize image to the given width	width=320
height	Resize image to the given height	height=240
fit	When resizing, how to fit the image: cover: Scale image to cover requested width/height contain: Scale image to be contained within the requested width/height fill: Stretch image to fill width/height inside: Scale image to stay within requested width/height and adjust width/height to image outside: Scale image to minimum width/height and adjust width or height to image	fit=cover (default)
gravity	When fit is cover or contain, where is the important part of the image: north, northeast, east, southeast, south, southwest, west, northwest, center	gravity=center (default)
crop	Crop image to LxT-WxH	crop=10×10-320×240
quality	Image quality when output is jpeg: 1-100	quality=80 (default)
colors	Image max color when output is png: 1-256-16mill	colors=16

Example

{
  _id: '7_1482855900',
  channelId: 7,
  start: '2016-12-27T16:25:00Z',
  end: '2016-12-27T16:55:00Z',
  duration: 30,
  title: 'Grand Danois',
  description: 'Satire. Se eller gense Niels Hausgaard og Anders Grau, når de sammen med en række danske komikere og skuespillere behandler otte emner i dette satiriske sketchshow. Det er alt lige fra danskhed til lov og orden, der kommer under kærlig behandling.',
  genres: [
    'Komedie'
  ],
  credits: [
    { type: 'ACTOR', name: 'Mick Øgendahl' },
    { type: 'ACTOR', name: 'Lars Hjortshøj' },
    { type: 'PRODUCER', name: 'Rune Klan' }
  ],
  series: {
    episode: 6,
    season: 2,
    id: '232174273'
  },
  images : [
    {
      type: '95x54',
      width: 95,
      height: 54,
      url: 'https://img.powernet.tv/95x54/30/1490/821800.jpg'
    },
    {
      type: '177x100',
      width: 177,
      height: 100,
      url: 'https://img.powernet.tv/177x100/30/1490/821800.jpg'
    },
    {
      type: '250x140',
      width: 250,
      height: 140,
      url: 'https://img.powernet.tv/250x140/30/1490/821800.jpg'
    },
    {
      type: '270x152',
      width: 270,
      height: 152,
      url: 'https://img.powernet.tv/270x152/30/1490/821800.jpg'
    },
    {
      type: '360x203',
      width: 360,
      height: 203,
      url: 'https://img.powernet.tv/360x203/30/1490/821800.jpg'
    },
    {
      type: '400x225',
      width: 400,
      height: 225,
      url: 'https://img.powernet.tv/400x225/30/1490/821800.jpg'
    },
    {
      type: '460x260',
      width: 460,
      height: 260,
      url: 'https://img.powernet.tv/460x260/30/1490/821800.jpg'
    },
    {
      type: '750x420',
      width: 750,
      height: 420,
      url: 'https://img.powernet.tv/750x420/30/1490/821800.jpg'
    },
    {
      type: '900x506',
      width: 900,
      height: 506,
      url: 'https://img.powernet.tv/900x506/30/1490/821800.jpg'
    },
    {
      type: '1777x1000',
      width: 1777,
      height: 1000,
      url: 'https://img.powernet.tv/1777x1000/30/1490/821800.jpg'
    }
  ],
  imageIds: ['1234567890123458790EEEE','1234567890123457890FFFF']
}

Errors

Error code	Message	Description
403	access_denied	Insufficient access level
404	id	Not found
500	internal_error	<Unspecified>

WIKI

Table of Contents