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 |
|---|
| No version | List of categories | Deprecated | List of Categories |
Channel
| Version | Title | Lifecycle | Documentation |
|---|
| 4.0 | User specified favourite channel lists (REST) | Current | Favourite channel lists |
| 4.0 | Channels | Planned | Schedule#/Channels/GetChannelsIndex |
| 4.0 | Channel details | Planned | Schedule#/Channels/GetChannelById |
| 3.1 | User specific channels | End of Life | User specific channels (v3.1) |
| 3.1 | List of channels | End of Life | List of Channels (v3.1) |
| 2 | List of channels | Deprecated | List of Channels (v2) |
| 2 | Details of channel | Deprecated | 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 |
EPG
| Version | Title | Lifecycle | Documentation |
|---|
| 4.0 | Broadcast slots | Current | Schedule#/Broadcast%20Slots/GetBroadcastSlotsIndex |
| 4.0 | Broadcast slot details | Current | Schedule#/Broadcast%20Slots/GetBroadcastSlotById |
| 3.0 | EPG List V3 | Deprecated | EPG List V3 |
| 3.0 | EPG Program Details V3 | Deprecated | EPG Program Details V3 |
| No version | EPG List V2 | End of Life | EPG List V2 |
| 2.0 | EPG V2 - Program Details | End of Life | EPG V2 - Program Details |
| 2.0 | List of top recordings | Deprecated | List of top recordings |
| 4 | Get a list of broadcast slots | Planned | Schedule#/BroadcastSlots/GetBroadcastSlotsIndex |
| 4 | Get a list of programs with basic metadata | Planned | Metadata: Programs#/Programs/GetProgramIndex |
| 4 | Get details for a specific program including rich metadata relationships | Planned | Metadata: Programs#/Programs/GetProgram |
| 4 | Get a list of genres | Planned | Metadata: Genres#/Genres/indexGenres |
| 4 | Get a list of programs for a particular genre | Planned | Metadata: Genres#/Genres/SeeGenrePrograms |
| 4 | Get list of programs for a credited person | Planned | /wiki/spaces/MAPI/pages/49676902 |
Teletext
| Version | Title | Lifecycle | Documentation |
|---|
| 2.0 | Teletext Page Item | Deprecated | Teletext Page Item |
| 2.0 | Teletext SubPage Item | Deprecated | Teletext SubPage Item |
| 2.0 | TeleText SubPage Index | Deprecated | Teletext SubPage Index |
| 2.0 | TeleText Create | Deprecated | Teletext Create |
Irdeto Integration
| Version | Title | Lifecycle | Documentation |
|---|
| 2.0 | Associate User with STBDevice | Deprecated | Associate User with STBDevice |
| REST 1.0 | Entitle a set top box to watch DVB channels | Planned | /wiki/spaces/MAPI/pages/49676635 |
| REST 1.0 | Remove entitlement from set top box | Planned | /wiki/spaces/MAPI/pages/49676635 |
Product and Licensing
| Version | Title | Lifecycle | Documentation |
|---|
| 4.0 | Get list of user's active licenses | Current | User licenses v4#/License/GetUserLicenses |
| 4.0 | Purchase a new license for the user | Current | User licenses v4#/License/PurchaseUserLicense |
| 4.0 | Get a list of products visible to the user | Current | User licenses v4#/Product/GetAllProducts |
| 4.0 | Get licenses with a filter (management) | Current | Management Licenses v4#/License/GetLicenses |
| 4.0 | Create a new license (management) | Current | Management Licenses v4#/License/CreateLicense |
| 4.0 | Get a license (management) | Current | Management Licenses v4#/License/GetLicenseById |
| 4.0 | Delete a license (management) | Current | Management Licenses v4#/License/DeleteLicenseById |
| 4.0 | Batch create licenses (management) | Current | Management Licenses v4#/License/BatchCreateLicenses |
| 4.0 | Batch delete licenses (management) | Current | Management Licenses v4#/License/BatchDeleteLicenses |
| 4.0 | Delete all user's licenses (management) | Current | Management Licenses v4#/License/BatchDeleteAllUserLicenses |
| 4.0 | Get all user's licenses (management) | Current | Management Licenses v4#/License/GetLicensesByUser |
| 4.0 | Get all products (management) | Current | Management Licenses v4#/Product/GetAllProducts |
| 4.0 | Create a new product (management) | Current | Management Licenses v4#/Product/CreateProduct |
| 4.0 | Get product details (management) | Current | Management Licenses v4#/Product/GetProductById |
| 4.0 | Update product (management) | Current | Management Licenses v4#/Product/UpdateProduct |
| 4.0 | Delete a product (management) | Current | Management Licenses v4#/Product/DeleteProductById |
| 2.0 | List of Products | Deprecated | List of Products |
| 1.1 | List of external VOD Products | Deprecated | List of external VOD Products |
| 2.0 | Details of Products | Deprecated | Details of Products |
| 2.0 | Product Buy Options | Deprecated | Product Buy Options |
| 2.0 | Buy a Product | Deprecated | Buy a Product |
| 2.0 | List of Licenses | Deprecated | List of Licenses |
| 2.0 | Details of License | Deprecated | Details of License |
| 2.0 | Update License | Deprecated | Update License |
| No version | Check License Status | Deprecated | Check License Status |
| No version | Verify App-Store Payment | Deprecated | Verify App-Store Payment |
| 2.0 | Verify Credit Card | Deprecated | Verify Credit Card |
| 2.0 | Booxmedia Product Details | Deprecated | Booxmedia Product Details |
| 2.2 | JWT token for VOD provider product license | Deprecated | JWT token for VOD provider product license |
| 2.0 | SilverHD license | Deprecated | SilverHD license |
| 2.0 | Activate Gameleo license | Deprecated | Activate Gameleo license |
User Management
| Version | Title | Lifecycle | Documentation |
|---|
| 4.0 | Get an index of Users (management) | Planned | Users#/Users/indexUsers |
| 4.0 | Create a user (management) | Planned | Users#/Users/createUser |
| 4.0 | Get the details for a particular user (management) | Planned | Users#/Users/getUser |
| 4.0 | Add user flag (management) | Current | Users#/User%20Flags/addUserFlag |
| 4.0 | Remove user flag (management) | Current | Users#/User%20Flags/deleteUserFlag |
| 4.0 | User market segmentation (management) | Current | Users#/Market%20Segmentation/getUserMarketSegments |
| 4.0 | Update user's market segmentation (management) | Current | Users#/Market%20Segmentation/createUserMarketSegments |
| 4.0 | User market segmentation | Current | Market segmentation#/Market%20Segmentation/getUserMarketSegments |
| 4.0 | User login and access tokens | Current | User Authentication#/Account%20Authentication/createAccessToken |
| 4.0 | Device Authorization | Planned | User Authentication#/Device%20Authorization/createUserCode |
| 4.0 | Device Authorization verification | Planned | User Authentication#/Device%20Authorization/verifyUserCode |
| 2.0 | User Login | Deprecated | User Login |
| 2.0 | User Logout | Deprecated | User Logout |
| 2.0 | List of Users | Deprecated | List of Users |
| 2.0 | Add New User Account | Deprecated | Add New User Account |
| 2.0 | Edit Existing User Account | Deprecated | Edit Existing User Account |
| 2.0 | Delete User Account | Deprecated | Delete User Account |
| 2.0 | Request Account Password Reset | Deprecated | Request Account Password Reset |
| 2.0 | Confirm Account Password Reset | Deprecated | Confirm Account Password Reset |
| 2.0 | Delete User Account | Deprecated | Delete User Account |
| 2.0 | Add User Alias | End of Life | Add User Alias |
| 2.0 | Change User Alias | End of Life | Change User Alias |
| 2.0 | Delete User Alias | End of Life | Delete User Alias |
| 2.0 | Link User with User Alias | End of Life | Link User with User Alias |
| 2.0 | Associate Package with User Alias | End of Life | Associate Package with User Alias |
| 2.0 | Change Associated Package | End of Life | Change Associated Package |
| 2.0 | Add Additional Service | Deprecated | Add Additional Service |
| 2.0 | Get Service Status | Deprecated | Get Service Status |
| 2.0 | Logged In User's Service Status | End of Life | Logged In User's Service Status |
| 2.0 | Update User Service Settings | End of Life
| Update User Service Settings |
| 2.0 | Get User Service Details | End of Life | Get User Service Details |
| 2.0 | Delete Additional Service | Deprecated | Delete Additional Service |
| 2.0 | Player Consume Minutes | Deprecated | Player Consume Minutes |
| 2.0 | Get Consumed Minutes | Deprecated | Get Consumed Minutes |
| 2.0 | Add STB | Deprecated | Add STB |
| 2.0 | Link STB to User | Deprecated | Link STB to User |
| 2.0 | Remove STB Ownership from an User | Deprecated | Remove STB Ownership from an User |
| 2.0 | OAuth2 User Login (Delta) | Deprecated | OAuth2 User Login (Delta) |
Recording
| Version | Title | Lifecycle | Documentation |
|---|
| 4.0 | Get a list of popular recordings | Current | Recordings v4#/Recordings/getMostPopularBroadcastSlots |
| 4.0 | Search for recordings of a given user profile | Current | Recordings v4#/Recordings/searchRecordedSlots |
| 4.0 | Create a recording | Current | Recordings v4#/Recordings/createRecordedSlot |
| 4.0 | Update a recording | Current | Recordings v4#/Recordings/updateRecordedSlot |
| 4.0 | Delete a recording | Current | Recordings v4#/Recordings/deleteRecordedSlot |
| 4.0 | Batch delete recordings | Current | Recordings v4#/Recordings/batchDeleteRecordedSlots |
| 4.0 | List all recorded broadcast slots | Current | Recordings v4#/Recordings/recordedBroadcastSlots |
| 4.0 | User's recording storage quota | Current | Recordings v4#/Recordings/storageQuota |
| 4.0 | List all automated recordings requests for a given user profile | Current | Recordings v4#/Automated%20Recording%20Requests/indexRecordingRequests |
| 4.0 | Create an automated recording request | Current | Recordings v4#/Automated%20Recording%20Requests/createRecordingRequest |
| 4.0 | Update an automated recording request | Current | Recordings v4#/Automated%20Recording%20Requests/updateRecordingRequests |
| 4.0 | Delete an automated recording request | Current | Recordings v4#/Automated%20Recording%20Requests/deleteRecordingRequests |
| 4.0 | List all recording groups for a given user profile | Current | Recordings v4#/Recording%20Groups/indexRecordingGroups |
| 4.0 | List all recordings for a specific recording group | Current | Recordings v4#/Recording%20Groups/getRecordingsForGroup |
| 4.0 | List all recording which do not belong to a group | Current | Recordings v4#/Recording%20Groups/indexUngroupedRecordingGroupRecordings |
| REST 1.0 | Update one or more attributes of an existing entity | Deprecated | /wiki/spaces/MAPI/pages/49676468 |
| REST 1.0 | Get a list of recordings that have previously been started | Deprecated | /wiki/spaces/MAPI/pages/49676468 |
| 2.0 | Recording item | Deprecated | Recording item |
| 2.3 | Add Program for Recording | Deprecated | 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 | Deprecated | Logging User Playback |
| 2.3 | Update Recorded Content | Deprecated | Update Recorded Content |
| 2.3 | Delete Recorded Content | Deprecated | Delete Recorded Content |
| 2.3 | Search Recorded Content | Deprecated | Search Recorded Content |
| 2.0 | Get list of playheads | Deprecated | Get list of playheads |
| 2.0 | Get specific playhead | Deprecated | Get specific playhead |
| 2.0 | Update Recording Playback position | Deprecated | Update Recording Playback position |
| 2.0 | List of Favorite Recordings | Deprecated | List of Favorite Recordings |
| 2.0 | Update multiple user favourites | Deprecated | Update multiple user favourites |
| 2.2 | Delete Grouped Recorded Content | Deprecated | 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 | Deprecated | List Recording Groups and Single Programs V2 |
| No version | List Programs in a Recording Group V2 | Deprecated | List Programs in a Recording Group V2 |
| 2.0 | Catchup Program | Deprecated | Catchup Program |
| 2.0 | Catchup Groups collection | Deprecated | Catchup Groups collection |
| 2.0 | Catchup Group item | Deprecated | Catchup Group item |
| 2.1 | Logging Catchup Playback | Deprecated | Logging Catchup Playback |
| 1.2 | Patch User Recordings | Deprecated | Patch User Recordings |
| 1.1 | Get Continue Watching Recordings | Deprecated | Get Continue Watching Recordings |
| 1.1 | Get User Recordings | Deprecated | Get User Recordings |
| 2.0 | User Recording Storage | Deprecated | User Recording Storage |
Catchup
| Version | Title | Lifecycle | Documentation |
|---|
4.0 | Live streams | Current | 4.0 | Recordings streams | Current | 4.0 | Catchup streams | Current | Playable streams
| Version | Title | Lifecycle | Documentation |
|---|
4.0 | Live streams | Current | 4.0 | Recordings streams | Current | 4.0 | Catchup streams | Current | 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