api:iptv:app:multiepg
Table of Contents
API : IPTV : App : Multi Epg
Introduction
This request is used by the iOS/Android apps and web clients to get full EPG for multiple programs
Request
| URL | https://api.telecomx.dk/iptv/app/multiepg | ||
|---|---|---|---|
| Method | POST | ||
| Body | token | String | Session token. |
| ids | Array | Array of EPG ids to lookup. | |
| watching | Boolean | If true, will get EPG for programs currently being watched by this profile. Ignored if ids is given | |
| noimages | Boolean | [optional] True to not include images (default false). |
|
| profile | String | [optional] Id of profile to show EPG for. Used to determine if this profile has recorded EPG, position, etc. |
|
Query examples
{
ids: [ '1_45467667', '7_56567898' ],
noimages: true,
profile: '1234567890ABCD123456789'
}
Response
Array of EPG objects.
| EPG object (JSON) | ||
|---|---|---|
| _id | String | Id of program. |
| programId | ObjectId | Unique program ID (if known) |
| start | Date | Start time. |
| end | Date | End time. |
| duration | Number | Length 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. |
| genres | Array | List of genres, in danish language. |
| series | Object | Episode data - only available for series. |
| series.episode | Number | Episode number in the season, if available. |
| series.episodesInSeason | Number | Number of episodes in the season, if available. |
| series.season | Number | Season number, if available. |
| series.episodeTitle | String | Name of episode, if available. |
| series.seasonId | String | Id of season, if available. |
| series.id | String | Id of series, if available. |
| date | Date | Date program/movie/series was released/first shown, if available. |
| year | Number | Date program/movie/series was released, 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, DIRECTOR-PRODUCER e.t.c. |
| credits[].role | String | Name of the role played, if type is ACTOR. |
| credits[].name | String | Name of person. |
| imageIds | Array | List of poster images available for the program. |
| images | Array | List of poster images available for the program DEPRECATED. |
| images[].type | String | Image version data, WIDTHxHEIGHT. |
| images[].url | String | URL to retrieve the image. |
| recording | Boolean | True if program has been recorded or marked for recording by the customer. |
| watchList | Boolean | If true, then this profile has this program in their watchlist. Only relevant for IPTV private, using profiles |
| position | Number | If previously played, then this is the position in seconds where playback stopped. |
| inArchive | Boolean | True if program is available in the archive. |
| eventId | String | Unique id of the event, if available. |
| eventId2 | String | Unique id of the event from secondary source, if available. |
| realStart | Date | Real start time, if available. |
| realEnd | Date | Real end time, if available. |
| rerun | Boolean | Is this a re-run of the program, if available. |
| live | Boolean | Is this program live, if available. |
| premiere | Boolean | Is this the premiere of the program, if available. |
| alsoBroadcasted | Array | List of other dates the program has been or will be broadcasted, if available. |
| restrictions | Object | Permission settings for the program, if available. |
| restrictions.nPvr | Boolean | If the program may be recorded. |
| restrictions.archive | Boolean | If the program may be viewed in catchup. |
| restrictions.startOver | Boolean | If the program mat be viewed as start-over. |
| streams | Array | Properties used, if the program is available on streaming services |
| streams[].streamingService | String (enum) | Which streaming service this stream is from. |
| streams[].logo | String | URL to logo of the streaming service |
| streams[].logoId | ObjectId | ID of logo |
| streams[].name | String | Display name of streaming service |
| streams[].url | String | URL/deeplink to content |
Note that properties holding no value may be omitted from the object.
Example
[ { _id: '7_1484358000', programId: '1234567890ABCD1234567890', start: '2017-01-14T01:40:00.000Z', end: '2017-01-14T02:30:00.000Z', duration: 50, title: 'Cold Case', subTitle: 'Frank\'s Best', description: 'Krimiserie. Rush og Valens genåbner en sag fra 2001 om en vellidt lokal viktualieforretningsejer, Frank Dicenzio, som tilsyneladende blev banket ihjel af en ansat. Valens kontaktes af broderen til en dømt morder og overbevises om at genåbne sagen. Alle elskede Frank, og ingen kunne forestille sig, at nogen ville slå ham ihjel. Alle beviser peger mod Fransk bedste medarbejder - indtil en person endelig står frem og fortæller sandheden.', genres: [ 'Drama', 'Krimi' ], series: { episode: 10, episodesInSeason: 23, id: '237655889', season: 3 }, credits: [ { type: 'ACTOR', name: 'Kathryn Morris', role: 'Lilly Rush' }, { type: 'ACTOR', name: 'Danny Pino', role: 'Scotty Valens' }, { type: 'ACTOR', name: 'John Finn', role: 'John Stillman' }, { type: 'ACTOR', name: 'Jeremy Ratchford', role: 'Nick Vera' }, { type: 'ACTOR', name: 'Thom Barry', role: 'Will Jeffries' }, { type: 'ACTOR', name: 'Tracie Thoms', role: 'Kat Miller' }, { type: 'ACTOR', name: 'Bahni Turpin', role: 'Lindsey Dunlay' }, { type: 'ACTOR', name: 'Ramon Franco', role: 'Ricardo Munoz' }, { type: 'ACTOR', name: 'James DiStefano', role: 'Frank Dicenzio' }, { type: 'ACTOR', name: 'Sandra Purpuro', role: 'Antonia Difara' }, { type: 'ACTOR', name: 'Eduardo Yanez', role: 'Felix Darosa' }, { type: 'DIRECTOR', name: 'Michael Schultz' } ], images: [ { type: '95x54', url: 'https://img.powernet.tv/95x54/7/1484/358000.jpg' }, { type: '177x100', url: 'https://img.powernet.tv/177x100/7/1484/358000.jpg' }, { type: '250x140', url: 'https://img.powernet.tv/250x140/7/1484/358000.jpg' }, { type: '270x152', url: 'https://img.powernet.tv/270x152/7/1484/358000.jpg' }, { type: '360x203', url: 'https://img.powernet.tv/360x203/7/1484/358000.jpg' }, { type: '400x225', url: 'https://img.powernet.tv/400x225/7/1484/358000.jpg' }, { type: '460x260', url: 'https://img.powernet.tv/460x260/7/1484/358000.jpg' }, { type: '750x420', url: 'https://img.powernet.tv/750x420/7/1484/358000.jpg' }, { type: '900x506', url: 'https://img.powernet.tv/900x506/7/1484/358000.jpg' }, { type: '1777x1000', url: 'https://img.powernet.tv/1777x1000/7/1484/358000.jpg' } ], recording: false, watchList: true, streams: [ { streamingService: 'NETFLIX', name: 'Netflix', url: 'https://example.com/video/12937129739/, logo: 'https://image.powernet.tv/1234567890ABCD1234567890.png', logoId: '1234567890ABCD1234567890' } ] } ]
Errors
| Error code | Message | Description |
|---|---|---|
| 403 | access_denied | Insufficient access level |
| 404 | not_found | Not found |
| 500 | internal_error | <Unspecified> |
api/iptv/app/multiepg.txt · Last modified: 2023/01/10 08:49 by Joakim Andersen