Introduction
This document outlines how we approach developing and supporting multiple API endpoint versions.
Phases of life
Phase | Description | Feature changes | Security patches |
---|
Current | This is the most recent major version of our API | Yes | Yes |
Deprecated | One major version behind "current" | No | Yes |
End of life | Endpoints that are no longer supported at all | No | No |
General philosophy
We would like all of our customers to be using the most current version of our API. This is the version that we will be updating with features and actively maintaining.
Deprecated endpoints are available for use (their routes work) but are not actively supported with new features.
Endpoints that are in end of life will be scheduled to be removed from the server, clients making use of them should contact us for help in migrating to more current endpoints.
We will not move an endpoint to "end of life" before consulting with client developers.
Current version lifecycle
Category
Version | Endpoint | Lifecycle | Documentation |
---|
Not versioned | List of categories | Current | Jenkins |
Channel
Version | Title | Lifecycle | Documentation |
---|
4 | User specified favourite channel lists (REST) | Planned | Favourite channel lists |
4 | Channel index (REST) | Planned | Jenkins |
3.1 | User specific channels | Current | User specific channels (v3.1) |
3.1 | List of channels | Current | List of Channels (v3.1) |
3 | List of channels | Deprecated | List of Channels (v3) |
2 | List of channels | Deprecated | List of Channels (v2) |
2 | Details of channel | Current | Details of Channel (v2) |
2 | Play channel | Deprecated | PlayableStream |
2.0 | Mark/unmark channel as favourite | Deprecated | Mark/unmark channel as favourite |
1.0 | Play Channel | End of Life | Play Channel (deprecated) |
1.0 | Adding Channels to be Recorded | End of Life | Adding Channels to be Recorded |
Teletext
Version | Title | Lifecycle | Documentation |
---|
2.0 | Teletext Page Item | Current | Teletext Page Item |
2.0 | Teletext SubPage Item | Current | Teletext SubPage Item |
2.0 | TeleText SubPage Index | Current | Teletext SubPage Index |
2.0 | TeleText Create | Current | Teletext Create |
EPG
Version | Title | Lifecycle | Documentation |
---|
4.0 | Schedule (REST) | Planned | Schedule |
4.0 | Program metadata (REST) | Planned | Metadata: Programs |
3.1 | EPG List V3 | Current | EPG List V3 |
3.0 | EPG Program Details V3 | Current | EPG Program Details V3 |
No version | EPG List V2 | Deprecated | EPG List V2 |
2.0 | EPG V2 - Program Details | Deprecated | EPG V2 - Program Details |
2.0 | List of top recordings | Current | List of top recordings |
4.0 | Genres | Planned | Metadata: Genres |
4.0 | Seasons | Planned | /wiki/spaces/MAPI/pages/49676898 |
4.0 | Series | Planned | Metadata: Series |
4.0 | CreditedPerson | Planned | /wiki/spaces/MAPI/pages/49676902 |
Irdeto Integration
Version | Title | Lifecycle | Documentation |
---|
2.0 | Associate User with STBDevice | Current | Associate User with STBDevice |
Product and Licensing
Version | Title | Lifecycle | Documentation |
---|
4.0 | Channel License (REST) | Planned | Channel License |
2.0 | List of Products | Current | List of Products |
1.1 | List of external VOD Products | Current | List of external VOD Products |
2.0 | Details of Products | Current | Details of Products |
2.0 | Product Buy Options | Current | Product Buy Options |
2.0 | Buy a Product | Current | Buy a Product |
2.0 | List of Licenses | Current | List of Licenses |
2.0 | Details of License | Current | Details of License |
2.0 | Update License | Current | Update License |
No version | Check License Status | Current | Check License Status |
No version | Verify App-Store Payment | Current | Verify App-Store Payment |
2.0 | Verify Credit Card | Current | Verify Credit Card |
2.0 | Booxmedia Product Details | Current | Booxmedia Product Details |
2.2 | JWT token for VOD provider product license | Current | JWT token for VOD provider product license |
2.0 | SilverHD license | Current | SilverHD license |
2.0 | Activate Gameleo license | Current | Activate Gameleo license |
User Management
Version | Title | Lifecycle | Documentation |
---|
4.0 | User administration (REST) | Planned | Users |
4.0 | User Market segmentation (REST) | Planned | Users |
2.0 | User Login | Current | User Login |
2.0 | User Logout | Current | User Logout |
2.0 | List of Users | Current | List of Users |
2.0 | Add New User Account | Current | Add New User Account |
2.0 | Edit Existing User Account | Current | Edit Existing User Account |
2.0 | Delete User Account | Current | Delete User Account |
2.0 | Request Account Password Reset | Current | Request Account Password Reset |
2.0 | Confirm Account Password Reset | Current | Confirm Account Password Reset |
2.0 | Delete User Account | Current | Delete User Account |
2.0 | Add User Alias | Current | Add User Alias |
2.0 | Change User Alias | Current | Change User Alias |
2.0 | Delete User Alias | Current | Delete User Alias |
2.0 | Link User with User Alias | Current | Link User with User Alias |
2.0 | Associate Package with User Alias | Current | Associate Package with User Alias |
2.0 | Change Associated Package | Current | Change Associated Package |
2.0 | Add Additional Service | Current | Add Additional Service |
2.0 | Get Service Status | Current | Get Service Status |
2.0 | Logged In User's Service Status | Current | Logged In User's Service Status |
2.0 | Update User Service Settings | Current | Update User Service Settings |
2.0 | Get User Service Details | Current | Get User Service Details |
2.0 | Delete Additional Service | Current | Delete Additional Service |
2.0 | Player Consume Minutes | Current | Player Consume Minutes |
2.0 | Get Consumed Minutes | Current | Get Consumed Minutes |
2.0 | Add STB | Current | Add STB |
2.0 | Link STB to User | Current | Link STB to User |
2.0 | Remove STB Ownership from an User | Current | Remove STB Ownership from an User |
2.0 | OAuth2 User Login (Delta) | Current | OAuth2 User Login (Delta) |
Recommendation
Version | Title | Lifecycle | Documentation |
---|
4.0 | User recommendations (REST) | Planned | /wiki/spaces/MAPI/pages/49676845 |
4.0 | User event (REST) | Planned | /wiki/spaces/MAPI/pages/49676845 |
2.0 | List of Recommendations | Current | List of Recommendations |
2.0 | List of Recommendations for Movies | Current | List of Recommendations for Movies |
2.0 | List of Recommendations for Season | Current | List of Recommendations for Season |
2.0 | List of Recommendations for Series | Current | List of Recommendations for Series |
2.0 | List of Recommendations for Episode | Current | List of Recommendations for Episode |
2.0 | List of Recommendations for Recording | Current | List of Recommendations for Recording |
Recording
Version | Title | Lifecycle | Documentation |
---|
4.0 | User recording playable streams | Current | PlayableStream related to Recording |
4.0 | User recordings (REST) | Planned | /wiki/spaces/MAPI/pages/49676468 |
4.0 | User recording Tags (REST) | Planned | /wiki/spaces/MAPI/pages/49676468 |
2.0 | Recording item | Current | Recording item |
2.3 | Add Program for Recording | Current | Add Program for Recording |
2.3 | Play user recording | Deprecated | Play user recording in favour of PlayableStream related to Recording |
2.0 | Logging User Playback | Current | Logging User Playback |
2.3 | Update Recorded Content | Current | Update Recorded Content |
2.3 | Delete Recorded Content | Current | Delete Recorded Content |
2.3 | Search Recorded Content | Current | Search Recorded Content |
2.0 | Get list of playheads | Current | Get list of playheads |
2.0 | Get specific playhead | Current | Get specific playhead |
2.0 | Update Recording Playback position | Current | Update Recording Playback position |
2.0 | List of Favorite Recordings | Current | List of Favorite Recordings |
2.0 | Update multiple user favourites | Current | Update multiple user favourites |
2.2 | Delete Grouped Recorded Content | Current | Delete Grouped Recorded Content |
1.0 | List Programs in a Recording Group V1 | Deprecated | List Programs in a Recording Group V1 |
1.0 | List Recording Groups and Single Programs V1 | Deprecated | List Recording Groups and Single Programs V1 |
2.1 | List Recording Groups and Single Programs V2 | Current | List Recording Groups and Single Programs V2 |
No version | List Programs in a Recording Group V2 | Current | List Programs in a Recording Group V2 |
2.0 | Catchup Program | Current | Catchup Program |
2.0 | Catchup Groups collection | Current | Catchup Groups collection |
2.0 | Catchup Group item | Current | Catchup Group item |
2.1 | Logging Catchup Playback | Current | Logging Catchup Playback |
1.2 | Patch User Recordings | Current | Patch User Recordings |
1.1 | Get Continue Watching Recordings | Current | Get Continue Watching Recordings |
1.1 | Get User Recordings | Deprecated | Get User Recordings |
2.0 | User Recording Storage | Current | User Recording Storage |
Ruutu APIs
Version | Title | Lifecycle | Documentation |
---|
2.1 | Get a Ruutu session for the user | Current | Get a Ruutu session for the user |
2.0 | Verify Ruutu Agreement | Current | Verify Ruutu Agreement |
2.0 | Get user's Ruutu Licenses | Current | Get user's Ruutu Licenses |
Server
Version | Title | Lifecycle | Documentation |
---|
2.0 | Get Server Time | Current | Get Server Time |
2.0 | Translation | Current | Translation |
2.0 | Get Site Images | Current | Get Site Images |
2.0 | Application Languages List | Current | Application Languages List |
2.0 | Configuration Option List | Current | Configuration Option List |
2.0 | Detail of Configuration Option | Current | Detail of Configuration Option |
2.0 | GEO Blocking | Current | GEO Blocking |
2.0 | VAST Ads | Current | VAST Ads |
2.0 | Get server health | Current | Get server health |
Version | Title | Lifecycle | Documentation |
---|
2.0 | Login | End of Life | Login |
No version | Logout | End of Life | Logout |
2.0 | Proxy Login | End of Life | Proxy Login |
2.0 | Twitter | End of Life | Twitter |
Stats
Version | Title | Lifecycle | Documentation |
---|
2.0 | Create Playback stats log | Current | Create Playback stats log |
STB authentication and functionality
Version | Title | Lifecycle | Documentation |
---|
2.1 | STB Authentication | Current | STB Authentication |
2.0 | Refresh Token | Current | Refresh Token |
2.0 | Link STB to User | Current | Link STB to User |
2.0 | Remove STB Ownership from an User | Current | Remove STB Ownership from an User |
2.0 | Logout STB | Current | Logout STB |
User
Version | Title | Lifecycle | Documentation |
---|
4.0 | Users (REST) | Planned | Users |
2.0 | User Registration | Current | User Registration |
1.0 | Get Users | Current | Get Users |
1.0 | Get User By ID | Current | Get User By ID |
2.0 | PIN Code Verification | Current | PIN Code Verification |
2.0 | PIN Code Reset Request | Current | PIN Code Reset Request |
2.0 | PIN Code Reset/Update | Current | PIN Code Reset/Update |
2.0 | Parental PIN Code Reset/Update | Current | Parental PIN Code Reset/Update |
2.0 | Verify Parental PIN Code | Current | Verify Parental PIN Code |
2.0 | Parental PIN code reset request | Current | Parental PIN code reset request |
2.0 | Get age limit | Current | Get age limit |
2.0 | Set age limit | Current | Set age limit |
Verimatrix APIs for DRM content
Version | Title | Lifecycle | Documentation |
---|
2.0 | Registers Device player's DRM id | Current | Registers Device player's DRM id |
VoD
Version | Title | Lifecycle | Documentation |
---|
4.0 | Program metadata (REST) | Planned | Metadata: Programs |
4.0 | Genres (REST) | Planned | Metadata: Genres |
4.0 | Seasons (REST) | Planned | /wiki/spaces/MAPI/pages/49676898 |
2.0 | List of Programs | Current | List of Programs |
2.0 | Detail of Program | Current | Detail of Program |
2.0 | List of Genres | Current | List of Genres |
2.0 | Detail of Genre | Current | Detail of Genre |
2.0 | List of Seasons | Current | List of Seasons |
2.0 | Detail of Season | Current | Detail of Season |
2.0 | Mark/Unmark a VOD Program as Favorite | Current | Mark/Unmark a VOD Program as Favorite |
2.0 | Play VoD Content | Current | Play VoD Content |
2.0 | Play VOD Trailer | Current | Play VOD Trailer |
2.0 | Import XML of VOD | Current | Import XML of VOD |
Wallet
Version | Title | Lifecycle | Documentation |
---|
List of Wallets | Details of Wallet | Transactions List | Transaction Detail | Charge Product List | Charge Product Detail | Buy Product | Charge Wallet with Credit Card | Charge Wallet with Voucher | Charge Wallet with Voucher | Apple Receipt Verification | Apple Receipt Verification | Stream
Play user recordingCurrent version lifecycle
Category
Version | Endpoint | Lifecycle | Documentation | EOL |
---|
No version | List of categories | End of Life | List of Categories | June 2021 |
Channel
EPG
Teletext
Product and Licensing
User Management
Recording
Catchup
Playable streams
Ruutu APIs
Server
Playback info
STB authentication and functionality
User favourite channels
User
DRM
VoD
Wallet