Service endpoint categories
Overview
There are three categories of API. These are shown in the Class column in the tables below. Their meanings are as follows:
CLIENT – APIs for use by client applications
OPERATOR – APIs for use by operators' systems (e.g., CRM systems)
ADMIN – APIs used for communication between modules.
Modules that only expose ADMIN (internal/private) APIs are not listed here.
Account and Device Manager (ADM)
API | Class | Purpose | |
---|---|---|---|
Tenants (only used in SSP deployments) | |||
GET |
| ADMIN | Gets tenants |
POST |
| ADMIN | Adds a tenant |
GET |
| ADMIN | Gets a tenant |
PUT |
| OPERATOR | Updates a tenant |
Account profiles | |||
GET |
| OPERATOR | Retrieves multiple account profiles. |
PUT |
| OPERATOR | Updates multiple account profiles. |
POST |
| OPERATOR | Adds an account profile. |
GET |
| OPERATOR | Retrieves an account profile by UID. |
PUT |
| OPERATOR | Updates a single account profile. |
DELETE |
| OPERATOR | Deletes a single account profile. |
Accounts | |||
GET |
| OPERATOR | Retrieves multiple accounts. |
PUT |
| OPERATOR | Updates multiple accounts. |
POST |
| OPERATOR | Adds an account. |
PUT |
| OPERATOR | Updates an account with a pre-hashed password and salt. |
POST |
| OPERATOR | Adds an account with a pre-hashed password. |
GET |
| OPERATOR | Retrieves an account by ID. |
PUT |
| OPERATOR | Updates an account. |
Accounts service (OPF specific) | |||
DELETE |
| OPERATOR | Removes all data associated with the account ID passed in. |
PUT |
| OPERATOR | Adds or updates a PIN against an account. |
GET |
| OPERATOR | Finds inactive accounts. |
POST |
| OPERATOR | Sign-on using signon ID, password, client ID, and device information. |
Operator accounts PIN status | |||
GET |
| OPERATOR | Read the PIN status for an account. |
Bundled accounts | |||
GET |
| OPERATOR | Retrieves a bundle account based on device filter. |
GET |
| OPERATOR | Retrieves account, users, and devices by device UID. |
GET |
| OPERATOR | Retrieves account, users, and devices by device caSN. |
POST |
| OPERATOR | Adds a bundled account. |
GET |
| OPERATOR | Retrieves account, users, and devices by account UID. |
Device classifiers | |||
GET |
| OPERATOR | Retrieve device classifiers. |
PUT |
| OPERATOR | Updates multiple device classifiers. |
POST |
| OPERATOR | Adds a device classifier. |
GET |
| OPERATOR | Retrieves a device classifier by UID. |
PUT |
| OPERATOR | Update a device classifier. |
DELETE |
| OPERATOR | Deletes a device classifier. |
Device profiles | |||
GET |
| OPERATOR | Retrieves multiple device profiles. |
PUT |
| OPERATOR | Updates multiple device profiles. |
POST |
| OPERATOR | Adds a device profile. |
GET |
| OPERATOR | Retrieves a device profile by UID. |
PUT |
| OPERATOR | Updates a device profile. |
DELETE |
| OPERATOR | Deletes a device profile. |
Devices | |||
GET |
| OPERATOR | Retrieves multiple devices. |
POST |
| OPERATOR | Adds a device. |
DELETE |
| OPERATOR | Deletes devices using account UID. |
GET |
| OPERATOR | Retrieves a single device by UID. |
PUT |
| OPERATOR | Updates a device. |
DELETE |
| OPERATOR | Deletes a device. |
GET |
| OPERATOR | Get account device approval details. |
Devices (OPF specific) | |||
POST |
| OPERATOR | Checks the device is authorised. Creates the device if it does not already exist, and re-assigns the device if it belongs to a different account. This API will always return the ID of the device that is authorised. |
Archived accounts | |||
POST |
| OPERATOR | Archives accounts that were cancelled over a configured number of days. |
PIN types | |||
GET |
| OPERATOR | Retrieves a PIN type. |
DELETE |
| OPERATOR | Deletes a PIN type. |
GET |
| OPERATOR | Gets all PIN types |
PUT |
| OPERATOR | Add/update a PIN type |
Users | |||
GET |
| OPERATOR | Retrieves multiple users. |
POST |
| OPERATOR | Adds a user. |
DELETE |
| OPERATOR | Deletes users using account UID. |
GET |
| OPERATOR | Retrieves a user by UID. |
PUT |
| OPERATOR | Updates a user. |
DELETE |
| OPERATOR | Deletes a user. |
User accounts (OPF specific) | |||
GET |
| CLIENT | Retrieves PINs for an account. |
POST |
| CLIENT | Validates a PIN for an account. |
PUT |
| OPERATOR | Changes the password for an account. |
PUT |
| CLIENT | Changes a PIN for an account. |
GET |
| CLIENT | Retrieves an account by account UID in token header. |
POST |
| CLIENT | Creates a PIN for an account. |
GET |
| CLIENT | Read the status of all PINs for an account. |
GET |
| CLIENT | Retrieves the set of parental control ratings threshold(s) for an account. |
POST |
| OPERATOR | Updates one or more parental control ratings threshold(s), on an account, for a specified ratings body. |
POST |
| CLIENT | Updates one or more parental control ratings threshold(s), on an account, for a specified ratings body. |
POST |
| CLIENT | Deletes one or more parental control ratings bodies and corresponding threshold(s) from an account. |
User bundled accounts | |||
GET |
| OPERATOR | Retrieves a bundled account. |
User devices | |||
GET |
| OPERATOR | Used to get the details of how many devices a user has approved and when they can approve a new one. |
PUT |
| OPERATOR | Updates a device activate. |
POST |
| OPERATOR | Checks the device is authorised. Re-assigns the device if it belongs to a different account. |
PUT |
| OPERATOR | Updates a device name. |
PUT |
| OPERATOR | Updates a device deactivate. |
GET |
| CLIENT | Used to confirm a device approval. |
POST |
| CLIENT | Used to approve and/or unapprove a device. |
POST |
| OPERATOR | Used to approve and/or unapprove a device. |
GET |
| OPERATOR | Retrieves a device by UID and token header. |
GET |
| OPERATOR | Retrieves all devices by token header. |
GET |
| CLIENT | Used to find out next available approval time. |
User users | |||
GET |
| OPERATOR | Retrieves all users by token header. |
GET |
| OPERATOR | Retrieves a user by UID. |
PUT |
| OPERATOR | Updates a user. |
User v2 accounts (OPF specific) | |||
POST |
| OPERATOR | Tigo-based sign on using |
POST |
| OPERATOR | Refreshes authorisation which will return a signon entity JSON object. |
PUT |
| OPERATOR | Resets the PIN for an account. |
POST |
| OPERATOR | Sign-on using the signon ID, password, client ID, and device information. Either client ID or device information must be used; user and password are mandatory. If no client ID is passed a new device will be created. |
POST |
| OPERATOR | Sign-on using username and password only which will return just an account id in the JSON object. |
POST |
| OPERATOR | Sign-on for managed devices using the client ID and device information. Either client ID or device information must be used; user and password are mandatory. If no client ID is passed a new device will be created. |
POST |
| OPERATOR | Sign-on using anonymous account ID. |
POST |
| OPERATOR | Generates a reset password secret which will return a |
POST |
| OPERATOR | Generates a reset pin secret which will return a |
User v3 Accounts (OPF specific) | |||
PUT |
| OPERATOR | Resets the password for an account. |
Devices additional properties | |||
POST |
| OPERATOR | Creates additional properties on a device. |
GET |
| OPERATOR | Get a device's additional properties. |
DELETE |
| OPERATOR | Delete all additional properties on a device. |
PUT |
| OPERATOR | Updates the additional properties on a device. |
Activity Gateway
API | Class | Purpose | |
---|---|---|---|
User activity | |||
POST |
| CLIENT | Log a new rating request. (This is just a specialisation of the raw |
POST |
| CLIENT | Log a new activity |
Bookmarks | |||
PUT |
| CLIENT | Creates or updates an existing bookmark for account |
DELETE |
| CLIENT | Deletes an existing bookmark for a given account. |
DELETE |
| CLIENT | Deletes all existing bookmarks for a given account. |
DELETE |
| CLIENT | Deletes an existing bookmark for a given account based on tag ID. |
PUT |
| CLIENT | Creates or updates an existing bookmark for user |
DELETE |
| CLIENT | Deletes an existing bookmark for a given user. |
DELETE |
| CLIENT | Deletes an existing bookmark for a given user based on tag ID. |
Favourites lists | |||
POST |
| CLIENT | Creates a new favourites list for account. |
PUT |
| CLIENT | Updates an existing account's favourites list. |
DELETE |
| CLIENT | Deletes an existing account's favouriteslist and all entries |
PUT |
| CLIENT | Adds a favourite to an account favourites list. |
DELETE |
| CLIENT | Removes a favourite from an account favourites list. |
POST |
| CLIENT | Creates a new favouriteslist for a user. |
PUT |
| CLIENT | Updates an existing user's favourites list. |
DELETE |
| CLIENT | Deletes an existing user's favouriteslist and all entries. |
PUT |
| CLIENT | Adds a favourite to a favourites list. |
DELETE |
| CLIENT | Removes a favourite from a favourites list. |
Histories | |||
POST |
| CLIENT | Creates the history for an account. |
DELETE |
| CLIENT | Deletes an existing history entry |
POST |
| CLIENT | Creates history for user |
DELETE |
| CLIENT | Deletes an existing history entry. |
Playlists | |||
PUT |
| CLIENT | Adds a playlist entry to an account's playlist |
DELETE |
| CLIENT | Removes a playlist entry from an account's playlist |
PUT |
| CLIENT | Updates an existing account's playlist |
DELETE |
| CLIENT | Deletes an existing account's playlist and all entries |
POST |
| CLIENT | Creates a new playlists for account |
DELETE |
| CLIENT | Removes a playlist entry from a playlist |
PUT |
| CLIENT | Updates an existing user's playlist |
DELETE |
| CLIENT | Deletes an existing user's playlist and all entries |
POST |
| CLIENT | Creates a new playlists for a user |
Reminders | |||
POST |
| CLIENT | Creates a new reminder for an account |
DELETE |
| CLIENT | Deletes an existing reminder for a given user |
POST |
| CLIENT | Creates a new reminder |
DELETE |
| CLIENT | Deletes an existing reminder for a given user |
Authentication Gateway Service (AGS)
API | Class | Purpose | |
---|---|---|---|
Authentication service discovery service | |||
GET |
| CLIENT | Discover the services available and the parameters each endpoint may accept. |
Authentication services | |||
POST |
| CLIENT | Retrieve sign on token using provided credentials. |
POST |
| CLIENT | Subsequent sign on to be used when the initial sign on endpoint returns a 300 to indicate there are multiple accounts associated with the user. |
POST |
| CLIENT | Refreshes a sign on token. |
POST |
| CLIENT | Signs out from an account. |
Registration services | |||
POST |
| CLIENT | Register using provided credentials. |
POST |
| CLIENT | Subsequent registration to be used when the initial register endpoint returns a 300 to indicate there are multiple accounts associated with the user. |
Business Configuration Manager (BCM)
Core
API | Class | Purpose | |
---|---|---|---|
Business rule groups | |||
GET |
| OPERATOR | Retrieves all business rule groups according to the provided query parameters. A default limit of 100 protecting the system is defined. |
POST |
| OPERATOR | Creates a new business rule group. |
GET |
| OPERATOR | Retrieves one business rule group specified by its identifier. |
PUT |
| OPERATOR | Updates one business rule group specified by its identifier. All the attributes must be specified otherwise they will be nullified. |
DELETE |
| OPERATOR | Deletes one business rule group specified by its identifier. |
Business rule instances | |||
GET |
| OPERATOR | Retrieves a business rule instance according to the provided module name, business rule package name and business rule name. |
PUT |
| OPERATOR | Configure a business rule instance according to the provided module name, business rule package name and business rule name. |
DELETE |
| OPERATOR | Delete a business rule instance according to the provided module name, business rule package name and business rule name. |
GET |
| OPERATOR | Retrieves all business rule instances according to the provided module name. A default limit of 100 protecting the system is defined. |
Business rules | |||
GET |
| OPERATOR | Retrieves all business rules according to the provided query parameters. A default limit of 100 protecting the system is defined. |
POST |
| OPERATOR | Loads a pseudo rule content into a BCM rule and commit it. |
GET |
| OPERATOR | Retrieves one business rule specified by its package name and its name. |
POST |
| OPERATOR | Creates a new business rule with the given name and package name. |
PUT |
| OPERATOR | Updates one business rule specifying name and package name. All the attributes must be specified otherwise they will be nullified. |
DELETE |
| OPERATOR | Deletes one business rule specified by its name and package name. |
POST |
| OPERATOR | Commits the business rule and stores the content of the |
Devices | |||
GET |
| OPERATOR | Retrieves all devices. A default limit of 100 protecting the system is defined. |
POST |
| OPERATOR | Creates a new device. |
GET |
| OPERATOR | Retrieves one device specifying its identifier. |
PUT |
| OPERATOR | Updates one device specifying its identifier. All the attributes must be specified otherwise they will be nullified. |
DELETE |
| OPERATOR | Deletes one device specifying its identifier. |
POST |
| OPERATOR | Lock device which is used by workflow instance and get particular device object. |
POST |
| OPERATOR | Lock device then decrement pending jobs count with one lock device and unlock device. |
POST |
| OPERATOR | Decrement pending jobs count by one. |
POST |
| OPERATOR | Receives the job count from CWM and responds with executable job count for the device ID. |
POST |
| OPERATOR | Inputs the pending job count that needs to be reset on the device post initial job processing in CWM. |
POST |
| OPERATOR | Executes a device action. The list of supported actions are lock and unlock. It is used for pessimistic locking when the same device is used by n workflow instances. |
Fields | |||
GET |
| OPERATOR | Retrieve all configured custom fields Used as a metadata field while creating CPM entities (editorial/technical contents/channels, events etc...) |
POST |
| OPERATOR | Create a new custom field Used as a metadata field while creating CPM entities (editorial/technical contents/channels, events etc...) |
GET |
| OPERATOR | Retrieve a specific custom field Used as a metadata field while creating CPM entities (editorial/technical contents/channels, events etc...) |
PUT |
| OPERATOR | Update an existing custom field Used as a metadata field while creating CPM entities (editorial/technical contents/channels, events etc...) |
DELETE |
| OPERATOR | Delete an existing custom field Used as a metadata field while creating CPM entities (editorial/technical contents/channels, events etc...) |
Ping | |||
GET |
| OPERATOR | Pings API to verify that the BCM is ready to accept REST calls. |
Profiles | |||
GET |
| OPERATOR | Retrieves one profile specifying its identifier. |
PUT |
| OPERATOR | Updates one profile specifying its identifier. All the attributes must be specified otherwise they will be nullified. |
DELETE |
| OPERATOR | Deletes one profile specifying its identifier. |
GET |
| OPERATOR | Retrieves all profiles. A default max limit of 100 is defined in order to protect the system. |
POST |
| OPERATOR | Creates a new profile. |
Usage rules | |||
GET |
| OPERATOR | Retrieve all usage rules used by URL builder |
POST |
| OPERATOR | Create new usage rules used by URL builder |
GET |
| OPERATOR | Retrieve a specific usage rule used by URL builder |
PUT |
| OPERATOR | Update an existing usage rule |
DELETE |
| OPERATOR | Delete an existing usage rule |
Non-core
API | Class | Purpose | |
---|---|---|---|
Authentication | |||
GET |
| OPERATOR | Retrieve authentication configured on system. |
PUT |
| OPERATOR | Create or update the authentication configured on the system. |
CDN configuration | |||
GET |
| OPERATOR | Retrieve all CDN configuration mappings configured on the config map |
PUT |
| OPERATOR | Create or update the available CDN configuration on the system |
GET |
| OPERATOR | Get available configuration for CDN ID mappings from the config map |
PUT |
| OPERATOR | Create or update the available CDN configuration on the system |
DELETE |
| OPERATOR | Delete available configuration for CDN ID mapping from the config map |
Channel session account group policy | |||
GET |
| OPERATOR | Get available configuration for channel session account group |
PUT |
| OPERATOR | Create/update available configuration for |
DELETE |
| OPERATOR | Delete available configuration for channel session account group |
GET |
| OPERATOR | Retrieve all available channel session account group policy configuration from the system. |
PUT |
| OPERATOR | Create or update all available channel session account group policy configuration from the system. |
GET |
| OPERATOR | Retrieve all channel session groups configured on the config map. |
PUT |
| OPERATOR | Create or update the available channel session groups from the system. |
Content categories | |||
GET |
| OPERATOR | Retrieve all available content categories configured on the system. |
PUT |
| OPERATOR | Create or update the available content categories configured on the system. |
Content type mappings | |||
GET |
| OPERATOR | Retrieve all configured mappings between Nagra specific content types and content providers' types |
PUT |
| OPERATOR | Configure/Modify (bulk) a list of mappings between Nagra specific content types and content providers' types |
GET |
| OPERATOR | Retrieve mapping between specified Nagra specific content types and content providers' types |
PUT |
| OPERATOR | Configure/Modify specified mappings between Nagra specific content types and content providers' types |
DELETE |
| OPERATOR | Delete specified mappings between Nagra specific content types and content providers' types |
Default image sequence number | |||
GET |
| OPERATOR | Retrieve Default Image Sequence Number configured on the config map |
PUT |
| OPERATOR | Create or update all available configuration for defaultImageSequenceNumber from the system |
Entity management | |||
GET |
| OPERATOR | Retrieve all entity management configured on the system. |
PUT |
| OPERATOR | Create or update all available configuration for entity managemnet from the system. |
External content provider | |||
GET |
| OPERATOR | Retrieve all external content providers configured on the config map. |
POST |
| OPERATOR | Create available configuration for external content provider from the config map. |
GET |
| OPERATOR | Get available configuration for external content provider from the config map for ID. |
PUT |
| OPERATOR | Update available configuration for external content provider from the config map for ID. |
DELETE |
| OPERATOR | Delete available configuration for external content provider from the config map for ID. |
FIPS codes | |||
GET |
| OPERATOR | Retrieve the configured list of FIPS codes |
PUT |
| OPERATOR | Configure a list of FIPS codes that are allowed to be used during account configuration |
Generic recommendations configuration | |||
GET |
| OPERATOR | Retrieve available generic recommendation configuration on the system. |
PUT |
| OPERATOR | Create or update the generic recommendation configuration on the system. |
Geo-filtering | |||
GET |
| OPERATOR | Retrieve geo-filtering configured on system. |
PUT |
| OPERATOR | Create or update the geo-filtering configured on the system. |
GET |
| OPERATOR | Retrieve |
PUT |
| OPERATOR | Create or update the |
Geo-blocking (countries) | |||
GET |
| OPERATOR | Retrieves all allowed countries configured on the system. |
PUT |
| OPERATOR | Creates or updates the allowed countries configured on the system. |
GET |
| OPERATOR | Retrieves all country lists configured on the system. |
PUT |
| OPERATOR | Creates or updates the country list configured on the system. |
Geo-blocking (regions) | |||
GET |
| OPERATOR | Retrieves all allowed regions configured on the system. |
PUT |
| OPERATOR | Creates or updates the allowed Regions configured on the system. |
GET |
| OPERATOR | Retrieves all Region list configured on the system. |
PUT |
| OPERATOR | Creates or updates the Region list configured on the system. |
Geo-blocking (VPN) | |||
GET |
| OPERATOR | Retrieves blockVPN configured on the system. |
PUT |
| OPERATOR | Creates or updates the blockVPN configured on the system. |
Image type mappings | |||
GET |
| OPERATOR | Retrieve mapping between Nagra image type and content providers' image types for specified image type |
PUT |
| OPERATOR | Configure/Modify (bulk) mappings between Nagra image type and content providers' image types |
DELETE |
| OPERATOR | Delete specified mapping between Nagra image type and content providers' image types |
GET |
| OPERATOR | Retrieve all mappings between Nagra image type and content providers' image types |
PUT |
| OPERATOR | Configure/Modify mapping between Nagra image type and content providers' image types |
Metadata locale | |||
GET |
| OPERATOR | Retrieves all available metadata locales configured on the system. |
PUT |
| OPERATOR | Creates or updates the available metadata locales configured on the system. |
Node links | |||
GET |
| OPERATOR | Retrieve all node links configured on the system. |
PUT |
| OPERATOR | Create or update all available configuration for node links from the system. |
Parental ratings | |||
GET |
| OPERATOR | Retrieves all available parental rating configured on the system. |
PUT |
| OPERATOR | Creates or updates the available parental rating configured on the system. |
Playback URL configuration | |||
GET |
| OPERATOR | Retrieve all playback URLs configured on the system. |
PUT |
| OPERATOR | Create or update all available configuration for playback URLs from the system. |
Playout device class configuration | |||
GET |
| OPERATOR | Retrieve the configured list of device classifiers |
PUT |
| OPERATOR | Configure list of device classifiers that are allowed in platform (mobile, managed etc...) |
Product capabilities | |||
GET |
| OPERATOR | Retrieve the configured list of product features/capabilities |
PUT |
| OPERATOR | Configure list of product features/capabilities supported in platform (SD, HD etc...) |
Rails custom templates | |||
GET |
| OPERATOR | Retrieve all Rails Custom Templates configured on the config map |
POST |
| OPERATOR | Create available configuration for Rails Custom Templates from the config map |
GET |
| OPERATOR | Get available configuration for Rails Custom Templates from the config map for ID |
PUT |
| OPERATOR | Update available configuration for Rails Custom Templates from the config map for ID |
DELETE |
| OPERATOR | Delete available configuration for Rails Custom Templates from the config map for ID |
Technical types | |||
GET |
| OPERATOR | Retrieve all available technical types for products configured on the system. |
PUT |
| OPERATOR | Create or update the available technical types for products configured on the system. |
Technical usage rule profile config | |||
GET |
| OPERATOR | Retrieve all available technical usage rule profile configuration from the system. |
PUT |
| OPERATOR | Create or update all available technical usage rule profile configuration from the system, |
GET |
| OPERATOR | Retrieve all technical usage rule profiles mappings configured on the config map. |
PUT |
| OPERATOR | Create or update the available technical usage rule profiles mappings configured on the system. Profile names should be subset of allowed technical usage rule profiles. |
GET |
| OPERATOR | Get available configuration for technical usage rule profiles for the specified profile name from the config map. |
PUT |
| OPERATOR | Create/update available configuration for profile and channel list mappings from the config map. Profile name should be subset of allowed technical usage rule profiles. |
DELETE |
| OPERATOR | Delete available configuration for technical usage rule profiles from the config map. |
Validation rules mappings | |||
GET |
| OPERATOR | Retrieve all available validation rules configured on the system. |
GET |
| OPERATOR | Retrieve validation rules of type configured on the system. |
PUT |
| OPERATOR | Creating/updating validation rules of type |
DELETE |
| OPERATOR | Delete available configuration for validation rule from the config map. |
Watermarking configuration | |||
GET |
| OPERATOR | Retrieve all available configuration for watermarking from the system . |
PUT |
| OPERATOR | Create or update all available configuration for watermarking from the system. |
CAS Gateway (CAG)
API | Class | Purpose | |
---|---|---|---|
POST |
| OPERATOR | Adds an entitlement to CAS. |
POST |
| OPERATOR | Creates a product subscriptions for a device. |
PUT |
| OPERATOR | Updates a product subscriptions for a device. |
DELETE |
| OPERATOR | Removes product subscriptions for device. |
PUT |
| OPERATOR | Pairs the ChipSet serial number. |
PUT |
| OPERATOR | Unpairs the ChipSet serial number. |
PUT |
| OPERATOR | Resets the parental PIN code for a device. |
PUT |
| OPERATOR | Creates a parental PIN code for a device. |
POST |
| OPERATOR | Posts the message. |
POST |
| OPERATOR | Send mail. |
PUT |
| OPERATOR | The number of years to recover. |
Cast, Crew, and Persona Service (CCP)
Operator
API | Class | Purpose | |
---|---|---|---|
Cast crew personas | |||
GET |
| OPERATOR | Returns one or more cast/persona entries based on filter and limit. If no filter/limit is specified, the total number of results are limited to the maximum set limit on that resource. This will always return a totalRecords element, whose value is irrespective of the limit or page being set. |
PUT |
| OPERATOR | Updates the details of one or more cast/persona entries based on id(s). |
DELETE |
| OPERATOR | Deletes the one or more cast/persona entries based the given id(s). |
GET |
| OPERATOR | Returns the details of the cast/persona for the given identifier. |
PUT |
| OPERATOR | Updates the details of the cast/persona for the given id. |
DELETE |
| OPERATOR | Deletes the cast/persona entry for the given identifier. |
DELETE |
| OPERATOR | Deletes playlist entries for each person based on the identifiers specified in the query parameter. |
Users | |||
GET |
| OPERATOR | Returns one or more users based on filter and limit. If no filter/limit is specified, the total number of results are limited to the maximum set limit on that resource. This will always return a totalRecords element, whose value is irrespective of the limit or page being set. |
PUT |
| OPERATOR | Updates the details of one or more user entries based on id(s). |
DELETE |
| OPERATOR | Deletes the one or more user entries based the given id(s). |
GET |
| OPERATOR | Returns the details of the user for the given identifier. |
PUT |
| OPERATOR | Updates the details of the user for the given id. |
DELETE |
| OPERATOR | Deletes the user entry for the given identifier. Returns the identifier of the deleted cast/persona. Also applies to resource that did not match the request. |
User
API | Class | Purpose | |
---|---|---|---|
Cast crew personas | |||
GET |
| CLIENT | Returns one or more cast/persona entries based on filter and limit. If no filter/limit is specified, the total number of results are limited to the maximum set limit on that resource. This will always return a totalRecords element, whose value is irrespective of the limit or page being set. |
Users | |||
GET |
| CLIENT | Returns one or more users based on filter and limit. If no filter/limit is specified, the total number of results are limited to the maximum set limit on that resource. This will always return a totalRecords element, whose value is irrespective of the limit or page being set. |
GET |
| CLIENT | Returns the details of the user for the given account and user ID. |
PUT |
| CLIENT | Updates the details of the user for the given account and user ID. |
DELETE |
| CLIENT | Removes the entry of the user for the given account and user ID. |
Content Builder / Content Delivery
All the endpoints except those listed below are ADMIN.
API | Class | Purpose | |
---|---|---|---|
GET |
| CLIENT | Retrieve the presentation template that is currently enabled for the requesting device. |
GET |
| CLIENT | Retrieve generic content. |
GET |
| CLIENT | Retrieve personalised content. |
GET |
| CLIENT | Retrieve generic content. |
GET |
| CLIENT | Retrieve personalised content. |
Content discovery facade
API | Class | Purpose | |
---|---|---|---|
EPG | |||
GET |
| CLIENT | Get programmes for a given time period across all channels, or for a specific channel. |
GET |
| CLIENT | Get current programmes available across all channels. |
Catchup | |||
GET |
| CLIENT | Get catchup content. |
GET |
| CLIENT | Get catchup content. |
Subscribed | |||
GET |
| CLIENT | Get products to which the account (known from the authentication details) is subscribed. |
Content Discovery Gateway (CDG)
API | Class | Purpose | |
---|---|---|---|
Bookmarks | |||
POST |
| CLIENT | Adds an entry to an accounts bookmark list. |
Contexts | |||
GET |
| CLIENT | Gets recommendation contexts. |
Operator | |||
GET |
| OPERATOR | Gets the presentation properties of all contexts. |
Ratings | |||
POST |
| CLIENT | Rates content for an account. |
Recommendations | |||
POST |
| CLIENT | Get account recommendations. |
User activity | |||
POST |
| CLIENT | Records user activity. |
Content Discovery Service (CDS)
API | Class | Purpose | |
---|---|---|---|
Devices | |||
GET |
| OPERATOR | Retrieves list of device profiles assignment. |
PUT |
| OPERATOR | Assigns profile templates to a device. |
DELETE |
| OPERATOR | Unlinks device from profiles. |
Discover view | |||
GET |
| CLIENT | Retrieves strip contents for the account. |
GET |
| CLIENT | Retrieve strip contents for the given user of the account |
Magazine view | |||
GET |
| CLIENT | Retrieves magazine contents for the given account. |
GET |
| CLIENT | Retrieves magazine contents for the given user of the account. |
Profiles | |||
GET |
| OPERATOR | Retrieves list of profiles based on query fields. |
PUT |
| OPERATOR | Adds or updates profile template. |
DELETE |
| OPERATOR | Deletes profiles based on filter. |
Content Export (CEX)
v1
API | Class | Purpose | |
---|---|---|---|
Content providers | |||
GET |
| OPERATOR | Get all content providers |
GET |
| OPERATOR | Get content provider by ID |
POST |
| OPERATOR | Create content provider |
DELETE |
| OPERATOR | Delete content provider |
Algorithm parameter set | |||
GET |
| OPERATOR | Get Algorithm ParameterSet By Id |
PUT |
| OPERATOR | Update Algorithm ParameterSet |
POST |
| OPERATOR | Create Algorithm ParameterSet |
DELETE |
| OPERATOR | Delete Algorithm ParameterSet |
DELETE |
| OPERATOR | Delete Property Key Value |
v2
API | Class | Purpose | |
---|---|---|---|
Health check | |||
GET |
| ADMIN | Healthcheck API validating the health of CPM |
GET |
| ADMIN | Healthcheck API validating the health of BCM |
GET |
| ADMIN | Healthcheck API validating the health of services used by CEX (CPM and BCM) |
Ping | |||
GET |
| ADMIN | Ping API to check if CEX is up and running |
Content Import – Disney+ (CIM-DPLUS)
API | Class | Purpose | |
---|---|---|---|
GET |
| OPERATOR | Gets the ingestion status |
POST |
| OPERATOR | Starts the manual/on-demand ingestion. |
DELETE |
| OPERATOR | Stops the ongoing ingestion (full/incremental/manual). |
Content and Product Manager (CPM)
Commercial APIs v1
API | Class | Purpose | |
---|---|---|---|
Content authorisations | |||
GET |
| OPERATOR | Fetch content authorisations by |
Products | |||
GET |
| OPERATOR | Get product by |
PUT |
| OPERATOR | Update product by |
DELETE |
| OPERATOR | Delete product by |
GET |
| OPERATOR | Find products by query. |
PUT |
| OPERATOR | Update products. |
POST |
| OPERATOR | Create a product. |
DELETE |
| OPERATOR | Delete Products by |
PATCH |
| OPERATOR | Patch product by filter. |
GET |
| OPERATOR | Find products with business products by query. |
PUT |
| OPERATOR | Update product set based on action. |
GET |
| OPERATOR | Find products for export. |
DELETE |
| OPERATOR | Delete device class by product ID. |
Commercial APIs v2
API | Class | Purpose | |
---|---|---|---|
Content groups | |||
GET |
| OPERATOR | Get |
Nodes | |||
GET |
| OPERATOR | Get a node by ID. |
Content APIs v1
API | Class | Purpose | |
---|---|---|---|
Channel events | |||
PUT |
| OPERATOR | Update channel events. |
Channel lineup links | |||
GET |
| OPERATOR | Get channel lineup links by lineup ID or name. |
POST |
| OPERATOR | Create channel lineup links. |
DELETE |
| OPERATOR | Delete channel lineup links. |
GET |
| OPERATOR | Get channel lineup links for a given channel lineup ID and editorial channel ID. |
Channel lineups | |||
GET |
| OPERATOR | Get channel lineups by query. |
PUT |
| OPERATOR | Create/update channel lineup set. |
POST |
| OPERATOR | Create channel lineup. |
GET |
| OPERATOR | Get channel lineup by ID. |
PUT |
| OPERATOR | Update a channel lineup by ID. |
DELETE |
| OPERATOR | Delete channel lineup by ID. |
Channel set events | |||
PUT |
| OPERATOR | Update channel set events. |
Content groups links | |||
PUT |
| OPERATOR | Create or update content groups link by |
DELETE |
| OPERATOR | Delete content groups link by |
GET |
| OPERATOR | Get content groups links. |
DELETE |
| OPERATOR | Delete content groups links. |
PUT |
| OPERATOR | Update content groups link. |
Content groups | |||
GET |
| OPERATOR | Get content group by |
PUT |
| OPERATOR | Update content group by |
DELETE |
| OPERATOR | Delete content group by |
DELETE |
| OPERATOR | Delink of contents from content group. |
GET |
| OPERATOR | Get content groups by query. |
PUT |
| OPERATOR | Update content groups. |
POST |
| OPERATOR | Create content group. |
DELETE |
| OPERATOR | Delete content groups by |
PUT |
| OPERATOR | Update content group set based on action. |
GET |
| OPERATOR | Find content groups for export. |
Content publishing windows | |||
GET |
| OPERATOR | Find content publishing windows by query. |
PUT |
| OPERATOR | Update content publishing windows. |
POST |
| OPERATOR | Create content publishing window. |
DELETE |
| OPERATOR | Delete content publishing windows by |
GET |
| OPERATOR | Get content publishing window by CPW ID. |
PUT |
| OPERATOR | Update content publishing window by CPW ID. |
DELETE |
| OPERATOR | Delete content publishing window by CPW ID. |
PUT |
| OPERATOR | Update content publishing window based on action. |
GET |
| OPERATOR | Find content publishing windows for export. |
Deep links | |||
GET |
| OPERATOR | Find deep links by query. |
PUT |
| OPERATOR | Update deep links. |
POST |
| OPERATOR | Create deep link. |
DELETE |
| OPERATOR | Delete deep link based on criteria. |
GET |
| OPERATOR | Get a deep link by ID. |
PUT |
| OPERATOR | Update a deep link by ID. |
DELETE |
| OPERATOR | Delete a deep link by ID. |
Dynamic content groups | |||
GET |
| OPERATOR | Find dynamic content groups by query. |
PUT |
| OPERATOR | Update dynamic content groups. |
POST |
| OPERATOR | Create dynamic content group. |
DELETE |
| OPERATOR | Delete dynamic content group based on criteria. |
GET |
| OPERATOR | Get a dynamic content group by ID. |
PUT |
| OPERATOR | Update dynamic content group by ID. |
DELETE |
| OPERATOR | Delete a dynamic content group by ID. |
POST |
| OPERATOR | Add sources for dynamic content group by ID. |
DELETE |
| OPERATOR | Delete all sources for a dynamic content group. |
POST |
| OPERATOR | Add source for dynamic content group. |
DELETE |
| OPERATOR | Delete source for a dynamic content group. |
Editorial channels | |||
GET |
| OPERATOR | Get editorial channel by ID. |
PUT |
| OPERATOR | Update an editorial channel by ID. |
DELETE |
| OPERATOR | Delete an editorial channel by ID. |
GET |
| OPERATOR | Find editorial channels by query. |
PUT |
| OPERATOR | Update editorial channel set. |
POST |
| OPERATOR | Create an editorial channel. |
DELETE |
| OPERATOR | Delete editorial channels by |
DELETE |
| OPERATOR | Delete parental rating by name. |
POST |
| OPERATOR | Create regional to editorial channel set. |
DELETE |
| OPERATOR | Delete regionalisation set from editorial channel. |
PUT |
| OPERATOR | Update editorial channel by action. Used for export scenarios. The possible values are |
POST |
| OPERATOR | Remove |
POST |
| OPERATOR | Create client controls on editorial channel set. |
DELETE |
| OPERATOR | Delete client controls from editorial channel set. |
DELETE |
| OPERATOR | Delete source preference from editorial channel set. |
DELETE |
| OPERATOR | Delete regional source preference. |
Nodes | |||
GET |
| OPERATOR | Fetch node hierarchy by node ID. |
GET |
| OPERATOR | Find nodes for export. |
DELETE |
| OPERATOR | Delete preference set from node. |
GET |
| OPERATOR | Get a node by ID. |
PUT |
| OPERATOR | Update a node by ID. |
POST |
| OPERATOR | Delete child preference set from node. |
DELETE |
| OPERATOR | Delete a node by ID. |
GET |
| OPERATOR | Find nodes by query. |
PUT |
| OPERATOR | Update a node set. |
POST |
| OPERATOR | Create a node. |
DELETE |
| OPERATOR | Delete node by |
PUT |
| OPERATOR | Update node based on action. |
PUT |
| OPERATOR | Reorder the node based on the action. Either move or copy under the new parent. |
DELETE |
| OPERATOR | Delete ordering fields from node. |
POST |
| OPERATOR | Reorder the node. Move node/nodes under the new parent. |
POST |
| OPERATOR | Reorder the node. Node copy. |
Editorial contents | |||
DELETE |
| OPERATOR | Delete parental rating by name. |
POST |
| OPERATOR | Create client controls on editorial content. |
DELETE |
| OPERATOR | Delete client controls from editorial content set. |
GET |
| OPERATOR | Get editorial content by ID. |
PUT |
| OPERATOR | Update editorial content by ID. |
DELETE |
| OPERATOR | Delete editorial content by ID. |
GET |
| OPERATOR | Find editorial contents by query. |
PUT |
| OPERATOR | Update editorial content set. |
POST |
| OPERATOR | Create an editorial content. |
DELETE |
| OPERATOR | Delete editorial contents by |
DELETE |
| OPERATOR | Delete reference asset by type. |
DELETE |
| OPERATOR | Delete reference asset ADL for a given reference asset type. |
DELETE |
| OPERATOR | Delete |
PUT |
| OPERATOR | Update editorial content set based on action. |
GET |
| OPERATOR | Get editorial contents by passing node ID. |
GET |
| OPERATOR | Find editorial contents for export. |
Events | |||
DELETE |
| OPERATOR | Delete parental rating by name. |
GET |
| OPERATOR | Find events by query. |
PUT |
| OPERATOR | Update event set. |
POST |
| OPERATOR | Create an event. |
DELETE |
| OPERATOR | Delete events by query. |
POST |
| OPERATOR | Create client controls on events. |
DELETE |
| OPERATOR | Delete clientControls to Events |
GET |
| OPERATOR | Get an event by ID. |
PUT |
| OPERATOR | Update an event by ID. |
DELETE |
| OPERATOR | Delete an event by ID. |
PUT |
| OPERATOR | Event promotion by ID. |
PUT |
| OPERATOR | Bulk get events by ID. |
Node links | |||
GET |
| OPERATOR | Get node links by resource type. |
PUT |
| OPERATOR | Update node links. |
POST |
| OPERATOR | Create node link. |
DELETE |
| OPERATOR | Delete node link by resource |
DELETE |
| OPERATOR | Delete node links by resource |
GET |
| OPERATOR | Get a node link by ID. |
PUT |
| OPERATOR | Update node link by ID. |
POST |
| OPERATOR | Copy or move contents between nodes. |
DELETE |
| OPERATOR | Delete a node link by ID. |
PUT |
| OPERATOR | Update the status per export set (SPE) context. |
DELETE |
| OPERATOR | Removes the status per export set (SPE) context, when the prefence set is modified since the last export. |
Product links | |||
PUT |
| OPERATOR | Update product links set. |
GET |
| OPERATOR | Get product links by marketable type, marketable ID set and use node relations flag. |
DELETE |
| OPERATOR | Delete product links by query. |
GET |
| OPERATOR | Get product links by marketable ID and product ID. |
PUT |
| OPERATOR | Create or update product links by marketable ID and product ID. |
DELETE |
| OPERATOR | Delete product link by marketable ID and product ID. |
POST |
| OPERATOR | Delete product link by in bulk based on product reference and multiple marketable references. |
GET |
| OPERATOR | Find the product link for export by marketable type. |
PUT |
| OPERATOR | Update status per export set (SPE) context on product links. |
Technical channels | |||
GET |
| OPERATOR | Find technical channels by query. |
PUT |
| OPERATOR | Update technical channels. |
POST |
| OPERATOR | Create a technical channel. |
DELETE |
| OPERATOR | Delete technical channels by |
GET |
| OPERATOR | Get technical channel by ID. |
PUT |
| OPERATOR | Update a technical channel by ID. |
DELETE |
| OPERATOR | Delete technical channel by ID. |
DELETE |
| OPERATOR | Delete session group ID from technical channel. |
DELETE |
| OPERATOR | Delete usage rule from technical channel. |
DELETE |
| OPERATOR | Delete |
DELETE |
| OPERATOR | Delete security info on technical channel. |
PUT |
| OPERATOR | Update technical channel by action. Used for export scenarios. The possible values are |
Technical contents | |||
GET |
| OPERATOR | Find technical contents by query. |
PUT |
| OPERATOR | Update technical contents. |
POST |
| OPERATOR | Create technical content. |
DELETE |
| OPERATOR | Delete technical content by |
GET |
| OPERATOR | Get technical content by ID. |
PUT |
| OPERATOR | Update technical content by ID. |
DELETE |
| OPERATOR | Delete technical content by ID. |
DELETE |
| OPERATOR | Delete |
DELETE |
| OPERATOR | Delete playable asset by |
DELETE |
| OPERATOR | Delete security info on technical content. |
DELETE |
| OPERATOR | Delete playable asset ADL by type. |
DELETE |
| OPERATOR | Delete supplementary asset by type. |
DELETE |
| OPERATOR | Delete ADL for a given supplementary asset type. |
PUT |
| OPERATOR | Update technical contents based on action. |
GET |
| OPERATOR | Find technical contents for export. |
Trailer links | |||
PUT |
| OPERATOR | Update trailer links. |
GET |
| OPERATOR | Get trailer links. |
DELETE |
| OPERATOR | Delete trailer links by query. |
GET |
| OPERATOR | Get trailer link by promotable ID and trailer ID. |
PUT |
| OPERATOR | Create or update trailer link by promotable ID and trailer ID. |
DELETE |
| OPERATOR | Delete trailer link by promotable ID and trailer ID. |
GET |
| OPERATOR | Find trailer links for export. |
PUT |
| OPERATOR | Update status per export set (SPE) context on trailer links. |
Content APIs v2
API | Class | Purpose | |
---|---|---|---|
Content groups | |||
GET |
| OPERATOR | Get content group by ID. |
Nodes | |||
GET |
| OPERATOR | Get a node by ID. |
Admin APIs v1
API | Class | Purpose | |
---|---|---|---|
Location Endpoint /cpm/admin/v1 | |||
GET |
| OPERATOR | |
POST |
| OPERATOR | |
DELETE |
| OPERATOR | |
GET |
| OPERATOR | |
POST |
| OPERATOR | |
DELETE |
| OPERATOR |
Content Workflow Manager (CWM)
API | Class | Purpose | |
---|---|---|---|
Location Endpoint /workflow | |||
GET |
| OPERATOR | Returns workflow jobs based on filter and limit. If no filter/limit is specified, the total number of results are limited to the maximum set limit on that resource. This will always return a totalRecords element, whose value is irrespective of the limit or page being set. |
PUT |
| OPERATOR | Updates or creates a set of workflowJobs. If a provided job has no ID, it will be created, otherwise it will be updated. (The identifier is the concatenation of the profileId, the owner id and the owner type separated by an underscore.) All the attributes must be specified otherwise they will be nullified (except the id, profileId, ownerId and ownerType wich are part of the identifier and will never be updated once the job created). |
POST |
| OPERATOR | Creates a set of workflowJobs. If the creation of one workflowJob is not possible then nothing will be created. The identifier is the concatenation of the profileId, the owner id and the owner type separated by an underscore. |
DELETE |
| OPERATOR | Deletes all jobs based on the identifiers specified in the query parameter. |
GET |
| OPERATOR | Retrieves one workflowJob specifying its identifier. |
PUT |
| OPERATOR | Updates one workflowJob by specifying its identifier. (The identifier is the concatenation of the profileId, the owner id and the owner type separated by an underscore.) All the attributes must be specified otherwise they will be nullified (except the id, profileId, ownerId and ownerType wich are part of the identifier and will never be updated once the job created). |
DELETE |
| OPERATOR | Deletes one workflowJob by specifying its identifier. |
PATCH |
| OPERATOR | Partial modification of an existing workflow job resource by specifying its identifier. When an attribute is not specified, its existing value is retained. Attributes |
POST |
| OPERATOR | Amend the schedule of any workflow jobs concerning the given event ID / owner ID. |
POST |
| OPERATOR | Processes the jobs that are stuck. |
Content Workflow Manager Harmonic VOS360 Adapter (CWM2Harmonic)
API | Class | Purpose | |
---|---|---|---|
Location Endpoint /cwm2harmonic-vos-adapter/cxf/pri/v1 | |||
POST |
| OPERATOR | Create captured assets. |
GET |
| OPERATOR | Get captured asset by ID. |
DELETE |
| OPERATOR | Delete captured asset by ID. |
CRM Gateway
API | Class | Purpose | |
---|---|---|---|
Bundled accounts | |||
POST |
| OPERATOR | Create a bundled account. |
Accounts | |||
GET |
| OPERATOR | Retrieve an account by ID. |
PUT |
| OPERATOR | Update account. |
DELETE |
| OPERATOR | Remove all data associated with the account ID passed in. |
GET |
| OPERATOR | Search the accounts collection. |
POST |
| OPERATOR | Add an account. |
Devices | |||
GET |
| OPERATOR | Get devices. |
POST |
| OPERATOR | Create a new device. |
DELETE |
| OPERATOR | Delete Device(s) using account UID. |
GET |
| OPERATOR | Get a device by UID. |
PUT |
| OPERATOR | Update a device by ID. |
DELETE |
| OPERATOR | Delete a device. |
Entitlements | |||
GET |
| OPERATOR | Get entitlements. |
PUT |
| OPERATOR | Update entitlement. |
POST |
| OPERATOR | Add an entitlement. |
POST |
| OPERATOR | Add an entitlement for a device. |
PUT |
| OPERATOR | Update entitlement by entitlement ID. |
DELETE |
| OPERATOR | Delete an entitlement. |
DELETE |
| OPERATOR | Delete an entitlement by account ID. |
Devices additional properties | |||
GET |
| OPERATOR | Get a device's additional properties. |
DELETE |
| OPERATOR | Delete all additional aroperties on a device. |
GET |
| OPERATOR | Get a device's additional properties by group name. |
POST |
| OPERATOR | Creates additional properties on a device. |
PUT |
| OPERATOR | Updates the additional properties on a device. |
Users | |||
POST |
| OPERATOR | Add a user. |
GET |
| OPERATOR | Get an user by UID. |
Device Messaging Manager (DMM)
API | Class | Purpose | |
---|---|---|---|
Message broadcast | |||
GET |
| OPERATOR | Gets the device information. |
PUT |
| OPERATOR | Provisions a new device in DMM for IP Messaging. |
GET |
| OPERATOR | Retrieves topics. |
GET |
| OPERATOR | Gets the topic Information. |
PUT |
| OPERATOR | Creates a topic with/without devices. |
Message producer | |||
POST | /messaging/v1/topics/{topicName}/inbox | OPERATOR | Sends a message to be routed to a topic within the messaging system. |
POST | /messaging/v1/clients/{clientId}/inbox | OPERATOR | Sends a message to be routed to a specific client within the messaging system. |
FIPS codes | |||
GET | /mib/v1/accounts/{accountId}/fipsCodes | OPERATOR | Retreive the list of FIPS codes for specified account ID. |
PUT | /mib/v1/accounts/{accountId}/fipsCodes | OPERATOR | Associate FIPS codes with account. |
DELETE | /mib/v1/accounts/{accountId}/fipsCodes | OPERATOR | Delete the association between FIPS codes and account. |
Identity Authentication Service (IAS)
API | Class | Purpose | |
---|---|---|---|
v2 Millicom anonymous signon | |||
POST |
| CLIENT | Retrieve Millicom device anonymous token. |
Content | |||
POST |
| CLIENT | Retrieve content token with CDN token. |
POST |
| CLIENT | Retrieve content token for PPV event. |
POST |
| CLIENT | Retrieves a content token. |
DAS service | |||
POST |
| CLIENT | Validates user and password credentials, gets device ID from DAS server, creating a new device, and returns an SSP token with optional device information. |
GET |
| CLIENT | Get device ID using |
v3 DAS service | |||
POST |
| CLIENT | Validates user and password credentials from the request body, gets device ID from DAS server, creating a new device, and returns an SSP token with optional device information. |
Operator signon | |||
POST |
| OPERATOR | Validates account ID credentials, if DAS challenge provided gets device ID from DAS server, creating a new device and returns an SSP token with optional device information. This API is used exclusively for SSP deployments for integration by third-party operators. |
v2 OATH signon | |||
POST |
| CLIENT | Retrieve device token. |
POST |
| CLIENT | Retrieve device token. |
POST |
| CLIENT | Retrieve device token. |
POST |
| CLIENT | Retrieve device token. |
v3 OATH signon | |||
POST |
| CLIENT | Retrieve device token using username, password, and device details. |
POST |
| CLIENT | Retrieve device token using the device's |
POST |
| CLIENT | Retrieve device token using the device's smartcard identifier. |
POST |
| CLIENT | Retrieve signon token using TVKey activation and optional device information. In order for the API to work, the device must be pre-provisioned. |
v3 OATH | |||
POST |
| CLIENT | Refreshes a signon token. |
POST |
| CLIENT | Signs out from an account, the account ID is obtained from the provided access token. |
v3 SSP signon | |||
POST |
| CLIENT | Retrieve device token using account ID and device details. |
v2 signout | |||
POST |
| CLIENT | Sign out. |
Location detection | |||
GET |
| CLIENT | API test for in house by IP address. |
v1 locale information | |||
GET | /ias/v1/localeInfo | CLIENT | Provides client locale specific information based upon the address of the client application. |
GET | /ias/v1/operator/localeInfo | OPERATOR | Provides client locale specific information based upon the address provided as a query parameter. |
v2 get password reset token | |||
POST |
| OPERATOR | Retrieve token for reset password. |
POST |
| OPERATOR | Retrieve token for reset PIN. |
v2 self-service | |||
POST |
| CLIENT | Self-service token. |
v3 self-service | |||
POST |
| CLIENT | Self-service token. |
v1 Starhub OAUTH STB signon | |||
POST |
| CLIENT | Retrieve device token by supplying a StarHub OAuth access token and an associated set-top box CASN. |
Token validation service | |||
GET |
| CLIENT | Validate and decode an OPF3 JWT token. |
Tigo native app configuration | |||
GET |
| OPERATOR | Return the configuration used by a native app by country code and client type. |
Tigo signon | |||
POST |
| OPERATOR | Sign in with authenticated Tigo token. |
Image Handler Service (IHS)
API | Class | Purpose | |
---|---|---|---|
Client APIs | |||
GET |
| CLIENT | Get image asynchronously. Resource types: |
PUT |
| OPERATOR | Delete the images and corresponding references of the image resource. |
Default metadata APIs | |||
GET |
| OPERATOR | Delete the images and corresponding references of the image resource |
PUT |
| OPERATOR | Creates default image metadata by image name. |
DELETE |
| OPERATOR | Deletes the default images and corresponding references of the image resource. |
GET |
| CLIENT | Retrieve Default Image metadata. wild card not supported |
POST |
| OPERATOR | Create default image metadata for a set of image resources |
External client APIs | |||
GET |
| CLIENT | Retrieve the image metadata for preferred image selection. |
Metadata APIs | |||
GET |
| OPERATOR | Retrieves the image metadata based on the provided filters. |
PUT |
| OPERATOR | Creates image metadata for a set of image resources. |
DELETE |
| OPERATOR | Deletes the images and corresponding references of the image resource. |
Preferred image APIs | |||
GET |
| CLIENT | Retrieve the image metadata for preferred image selection |
PUT |
| OPERATOR | Update the image metadata with the preferred image selection |
Image Service
API | Class | Purpose | |
---|---|---|---|
GET |
| CLIENT | Request an image. |
Metadata Aggregation Service (MAS)
API | Class | Purpose | |
---|---|---|---|
PUT |
| OPERATOR | Creates a new events using channelEvents API |
PUT |
| OPERATOR | API to create new events on multiple channels in one go |
GET |
| OPERATOR | Retrieves contentGroups. |
PUT |
| OPERATOR | Creates a new contentGroup. Unless specified, the contentGroup ID will be system generated. |
DELETE |
| OPERATOR | Delete specified contentGroups passed as IDs. |
GET |
| OPERATOR | Retrieves a specified contentGroup. |
DELETE |
| OPERATOR | Deletes a specified contentGroup. |
GET |
| OPERATOR | Retrieves contentGroups eligible for export. |
GET |
| OPERATOR | Retreive the prcessing status of specified content |
DELETE |
| OPERATOR | Delete the processing status of specified content |
POST |
| OPERATOR | Deletes a specified editorial contents with all dependent entities (technical content, event, CPW, etc.). |
POST |
| OPERATOR | Deletes a specified technical contents with all dependent entities. |
GET |
| OPERATOR | Retrieves editorial channels. |
PUT |
| OPERATOR | Creates a new editorialChannel. Unless specified, the editorialChannel ID will be system generated. |
DELETE |
| OPERATOR | Deletes editorial channels by specified IDs. |
GET |
| OPERATOR | Retrieves a specified editorialChannel. |
DELETE |
| OPERATOR | Deletes a specified editorialChannel. |
GET |
| OPERATOR | Retrieves eligible editorial contents based on node. |
GET |
| OPERATOR | Retrieves specified editorial contents based on IDs. |
PUT |
| OPERATOR | Creates a new editorialContent. Unless specified, the editorialContent ID will be system generated. |
DELETE |
| OPERATOR | Delete specified editorial contents based on IDs. |
GET |
| OPERATOR | Retrieves a specified editorialContent. |
DELETE |
| OPERATOR | Deletes a specified editorialContent. |
GET |
| OPERATOR | Retrieve list of exportable editorial contents |
GET |
| OPERATOR | Retrieves events based on spanning period. |
PUT |
| OPERATOR | Creates a new event. Unless specified, the event ID will be system generated. |
DELETE |
| OPERATOR | Deletes events based on IDs. |
GET |
| OPERATOR | Retrieves a specified event. |
DELETE |
| OPERATOR | Delete a specified event. |
GET |
| ADMIN | Retrieves status of all the dependent modules and gives the healthcheck for MAS. |
GET |
| ADMIN | Pings MAS if it is up. |
GET |
| OPERATOR | Retrieves technical contents. |
PUT |
| OPERATOR | Creates a new technicalContent. Unless specified, the technicalContent ID will be system generated. |
DELETE |
| OPERATOR | Deletes technical content passed as IDs. |
GET |
| OPERATOR | Retrieves a specified technicalContent. |
DELETE |
| OPERATOR | Deletes a specified technicalContent. |
DELETE |
| OPERATOR | Deletes security info of a technical content specified by |
Metadata Server (MDS)
API | Class | Purpose | |
---|---|---|---|
VOD | |||
GET |
| CLIENT | Browse Video on Demand (VOD) catalogues. |
GET |
| CLIENT | Browse Video on Demand (VOD) assets. |
GET |
| CLIENT | Browse Video on Demand (VOD) series. |
GET |
| CLIENT | Video On Demand (VOD) products. |
BTV | |||
GET |
| CLIENT | Browse broadcast TV (BTV) Channels |
GET |
| CLIENT | Browse broadcast TV (BTV) Programmes - EPG |
GET |
| CLIENT | Browse broadcast TV (BTV) Series |
GET |
| CLIENT | Browse broadcast TV (BTV) Products |
Search | |||
GET |
| CLIENT | Search for any kind of metadata entity |
Changes | |||
GET |
| CLIENT | Gets changes to entities since a certain timestamp |
Internal | |||
GET |
| ADMIN | Gets security information for the content related to a given |
NPVR User Recordings (cDVR)
v1
API | Class | Purpose | |
---|---|---|---|
Aggregated recordings | |||
GET |
| CLIENT | Get aggregated recordings for the current account. |
Location Endpoint /cdvr/v1/operator | |||
GET |
| OPERATOR | Retrieves a quota profile. |
PUT |
| OPERATOR | Updates a single quota profile. |
DELETE |
| OPERATOR | Deletes a single quota profile. |
GET |
| OPERATOR | Retrieves all quota profiles. |
POST |
| OPERATOR | Generate a single quotaprofile. |
Quota management | |||
GET |
| CLIENT | Return an account's cloud DVR quota usage. |
GET |
| CLIENT | Return a user's quota usage based on series ID in seconds. |
Recordings | |||
GET |
| CLIENT | Retrieves recordings for the given account with various filtering and sorting options. |
POST |
| CLIENT | Requests a new recording to be scheduled. |
DELETE |
| CLIENT | Cancels or deletes a recording. |
GET |
| CLIENT | Get recordings of episodes of the given series for the given account with various filtering and sorting options. |
Manage recordings | |||
POST |
| CLIENT | Cancel/delete a recording. |
PATCH |
| CLIENT | Update/patch a recording with |
Series recordings | |||
GET |
| CLIENT | Get series recordings for the current account. |
POST |
| CLIENT | Request for a new series recording to be created. |
GET |
| CLIENT | Get status of series recordings for the current account. |
POST |
| CLIENT | Remove a series recording. |
DELETE |
| CLIENT | Remove a series recording. |
PATCH |
| CLIENT | Update a single series recording. |
PUT |
| CLIENT | Update a single series recording. |
POST |
| CLIENT | Request for a series recording to be repaired. |
v2
API | Class | Purpose | |
---|---|---|---|
Operator | |||
POST |
| OPERATOR | Request for generation of CWM jobs for scheduled recordings. |
Recordings | |||
GET |
| CLIENT | Get recordings for the given account with various filtering and sorting options. |
Series recordings | |||
GET |
| CLIENT | Get series recordings for the current account. |
Open Device Messaging (ODM)
API | Class | Purpose | |
---|---|---|---|
Location Endpoint /odm/v1/opendevice | |||
POST |
| CLIENT | Creates a queue if does not exist for the open device. |
Orders
API | Class | Purpose | |
---|---|---|---|
Bundle history | |||
GET |
| OPERATOR | Get historic revisions of a bundle for auditing purposes. |
Bundles | |||
GET |
| ADMIN | Retrieves bundles. |
GET |
| ADMIN | Get paginated bundles (by default, will return the first 10 records). |
POST |
| OPERATOR | Create a new bundle. |
GET |
| OPERATOR | Get a specific bundle. |
PUT |
| OPERATOR | Update a specific bundle. |
POST |
| OPERATOR | Move a specific bundle to status live. |
POST |
| OPERATOR | Move a specific bundle to status archived. |
Operator | |||
GET |
| OPERATOR | Retrieves historic purchases/subscriptions for a given account, describing the audit history of each order. |
GET |
| OPERATOR | Get the current state of subscriptions for a given account . |
POST |
| OPERATOR | Creates a subscription as an operator on behalf of an account. |
POST |
| OPERATOR | Create a subscription with fixed start and end dates as an operator on behalf of an account. |
POST |
| OPERATOR | Creates an impulse order as an operator on behalf of an account. |
DELETE |
| OPERATOR | Operator interface to cancel account subscription with subscription ID. |
DELETE |
| OPERATOR | Operator interface to cancel a given subscription by bundle ID. |
History | |||
GET |
| CLIENT | Retrieves historic purchases/subscriptions for a given account, describing the audit history of each order. |
Subscriptions | |||
GET |
| CLIENT | Retrieves the current state of subscriptions for a given account. |
POST |
| CLIENT | Creates a subscriptionOrder for the signed in account. |
GET |
| CLIENT | Retrieves the current state of a given subscription. |
Promotions Manager (PMG)
API | Class | Purpose | |
---|---|---|---|
Operator account profiles | |||
GET |
| OPERATOR | Lists all the profiles associated to an account. |
PUT |
| OPERATOR | Creates an association to the specified profile if the link does not already exist, using the identifier specified in the URL as the profile id. Passing in a profile that already exists will have no effect. |
DELETE |
| OPERATOR | Removes the specified profile reference from the account id. |
GET |
| OPERATOR | Lists all accounts linked to promotion profiles in the system. |
POST |
| OPERATOR | Adds a new account link to promotion profiles. |
PUT |
| OPERATOR | Updates the specific account. If the link does not already exist, creates an account association to the specified profiles using the identifier specified in the URL as the account id. |
DELETE |
| OPERATOR | Removes a specified account reference, and its association with any promotion profiles, completely from the promotions system. |
Operator profiles | |||
GET |
| OPERATOR | Retrieves all promotion profiles configured on the system. |
POST |
| OPERATOR | Creates a new promotion profile. Unless specified, the profile ID will be system generated. |
GET |
| OPERATOR | Retrieves a specific promotion profile. |
PUT |
| OPERATOR | Updates a specific promotion profile. If the specified resource does not already exist, creates a profile using the identifier specified in the URL as the profile id. |
DELETE |
| OPERATOR | Deletes a specific promotion profile. |
GET |
| OPERATOR | Lists all the accounts linked to the profile id. |
Operator promotions | |||
GET |
| OPERATOR | Retrieves all promotion profiles configured on the system. |
POST |
| OPERATOR | Creates a new promotion. Unless specified, the promotion ID will be system generated. |
GET |
| OPERATOR | Retrieves a specific promotion. |
PUT |
| OPERATOR | Updates the specific promotion. If the specified resource does not already exist, creates one using the identifier specified in the URL as the promotion id. |
DELETE |
| OPERATOR | Deletes a specific promotion. |
GET |
| OPERATOR | Lists all the content that has been added to the promotion. |
PUT |
| OPERATOR | Updates the entire contents of the promotion. |
DELETE |
| OPERATOR | Removes all of the specified content from the promotion. |
GET |
| OPERATOR | Retrieves the specific content item from the promotion. |
DELETE |
| OPERATOR | Deletes the selected content ID from the promotion. |
Ping | |||
GET |
| ADMIN | Ping the PMG module. |
User accounts | |||
GET |
| OPERATOR | Lists all the content linked to the account via the account/profile ids/promotions/content relationship. |
User content | |||
GET |
| OPERATOR | Lists all content (within a valid promotion), unfiltered by specific profile, account or promotion. |
User profiles | |||
GET |
| OPERATOR | Lists all the content linked to this account via the profile id/promotions/content relationship. |
User promotions | |||
GET |
| OPERATOR | Lists all the content linked to this promotion (via the promotion/content relationship). |
Purchase Service
API | Class | Purpose | |
---|---|---|---|
Maintenance services | |||
GET |
| ADMIN | A liveliness probe endpoint to ensure the service is running |
GET |
| ADMIN | A readiness probe endpoint to detect if the service is ready for requests |
POST |
| ADMIN | Use this endpoint to toggle verbose request/response tracing in the console. When turned on, every incoming request and outgoing response is logged in full detail (including the body). In addition, all downstream requests and responses to/from other services will also be logged. |
POST |
| ADMIN | Use this endpoint to toggle verbose request/response tracing in the console. When called, the header (name) and (header) value provided are used to activate a trace for any future request with the sepcified header and value. |
User product purchase | |||
POST |
| CLIENT | Client API for purchasing products. |
Recommendations Facade
API | Class | Purpose | |
---|---|---|---|
Operator | |||
GET |
| OPERATOR | Get the recommendation types that are supported by the configured recommendation engine. |
Recommendations | |||
POST |
| CLIENT | Get recommendations based on the provided input. |
User activity | |||
POST |
| CLIENT | Record user activity against the provided content. |
Rights Manager (RMG)
API | Class | Purpose | |
---|---|---|---|
Tenants Service | |||
GET |
| ADMIN | Searches the tenants collection. |
POST |
| ADMIN | Adds a tenant. |
GET |
| ADMIN | Retrieve a tenant by id. |
PUT |
| ADMIN |
|
Actions Service (OPF Specific) | |||
DELETE |
| OPERATOR | Removes all data associated with the account id passed in. |
POST |
| OPERATOR | Checks if an entitlement allows the viewing of the requested channel for the account/device/user identifiers. |
POST |
| OPERATOR | Returns usage rules if operators request on behalf of a user is authorised to access the content. |
Archived Entitlements Service | |||
GET |
| OPERATOR | Search the archived entitlements collection. |
POST |
| OPERATOR | Archives entitlements that were unsubscribed or expired over a configured time period. |
GET |
| OPERATOR | Retrieves an archived entitlement by its id. |
Entitlements Service | |||
GET |
| OPERATOR | Searches the entitlements collection. |
PUT |
| OPERATOR | Updates all entitlements matching provided filter. |
POST |
| OPERATOR | Adds an entitlement, where entitlement fields (like account, device, product id ) will be validated based on configuration. |
GET |
| OPERATOR | Retrieves an entitlement by id. |
PUT |
| OPERATOR | Updates an Entitlement. |
DELETE |
| OPERATOR | Deletes an entitlement. |
PUT |
| OPERATOR | Update or create an Entitlement. |
DELETE |
| OPERATOR | Deletes all entitlements using account Id. |
DELETE |
| OPERATOR | Delete all entitlements using device Id. |
DELETE |
| OPERATOR | Delete all entitlements using product Id. |
Entitlements Service (OPF Specific) | |||
POST |
| OPERATOR | Adds an entitlement which is pre-validated. |
POST |
| OPERATOR | Adds a batch of entitlements which have been pre-validated. |
User Entitlements Service | |||
GET |
| CLIENT | Retrieves all capability type entitlements. |
GET |
| CLIENT | Retrieves a product entitlement by entitlement id. |
GET |
| CLIENT | Retrieve all entitlements for user matching provided filters. |
User Actions Service (OPF Specific) | |||
GET |
| OPERATOR | Returns usage rules if a user is authorised to access the content. |
GET |
| OPERATOR | Checks if a user is authorised to view a PPV Event. |
Search Facade
API | Class | Purpose | |
---|---|---|---|
Public | |||
GET |
| CLIENT | Make a search request. |
GET |
| CLIENT | Get typeahead suggestions based on partial search inputs. |
Internal | |||
GET |
| ADMIN | Make an advanced search request. |
Session Resource Manager (SRM)
API | Class | Purpose | |
---|---|---|---|
POST |
| CLIENT | Set up a session (latest version). |
POST |
| CLIENT | Set up a session (v1). |
PUT |
| CLIENT | Send keep-alive call (latest version). |
PUT |
| CLIENT | Send keep-alive call (v1). |
DELETE |
| CLIENT | Tear down session (latest version). |
DELETE |
| CLIENT | Tear down session (v1). |
URL Builder
API | Class | Purpose | |
---|---|---|---|
GET |
| CLIENT | Request for CDN token |
GET |
| CLIENT | Request for PPV token |
GET |
| CLIENT | Request for customisation of URL based on channel |
User Activity Vault (UAV)
API | Class | Purpose | |
---|---|---|---|
Notifications | |||
GET |
| CLIENT | The start date for the time period to fetch updated watch counts from. |
GET |
| CLIENT | Gets the notifications for any modifications made to average ratings. For efficiency reasons, the results are returned in descending chronological order. |
Ratings | |||
GET |
| CLIENT | Gets all ratings logged by the given account. Results include ratings by all users that belong to that account. |
GET |
| CLIENT | Gets a specific rating made by a user/account combination. |
GET |
| CLIENT | Gets a list of ratings made by a specific account for the given content. Returns a number of ratings if there is more than one user per account |
GET |
| CLIENT | Gets ratings by all users and accounts made against the specified content. |
GET |
| CLIENT | Gets all ratings logged by the given user for a specific account. |
GET |
| CLIENT | Gets the average rating for a given piece of content. |
User Activity | |||
POST |
| CLIENT | Logs a new activity |
POST |
| CLIENT | Logs a new rating request (This is just a specialization of the raw useractivity API). |
GET |
| CLIENT | Queries for a list of activities logged by a specific account and user |
GET |
| CLIENT | Queries for a list of activities logged by a specific account |
Bookmarks | |||
GET |
| CLIENT | Gets a bookmark for a given account and content |
PUT |
| CLIENT | Creates or updates an existing bookmark for account |
DELETE |
| CLIENT | Deletes an existing bookmark for a given account. |
GET |
| CLIENT | Gets all bookmarks for a given account. |
DELETE |
| CLIENT | Deletes all existing bookmarks for a given account. Only one query param may be passed. |
DELETE |
| CLIENT | Deletes an existing bookmark for a given account based on tag Id |
GET |
| CLIENT | Gets a bookmark for a given user and content |
PUT |
| CLIENT | Creates or updates an existing bookmark for user |
DELETE |
| CLIENT | Deletes an existing bookmark for a given user. |
GET |
| CLIENT | Gets all bookmarks for a given user. |
DELETE |
| CLIENT | Deletes an existing bookmark for a given account based on tag ID. |
Favourites Lists | |||
GET |
| CLIENT | Gets all favourites from a list for a given account. |
PUT |
| CLIENT | Updates an existing account's favourites list. |
DELETE |
| CLIENT | Deletes an existing account's favourites list and all entries |
GET |
| CLIENT | Gets all favourites lists for a given account. |
POST |
| CLIENT | Creates a new favourites list for an account. |
PUT |
| CLIENT | Adds a favourite to an account favourites list. |
DELETE |
| CLIENT | Removes a favourite from an account favourites list. |
GET |
| CLIENT | Gets all favourites lists for a given user. |
POST |
| CLIENT | Creates a new favourites list for a user. |
GET |
| CLIENT | Gets all favourites from the list for a given user. |
PUT |
| CLIENT | Updates an existing user's favourites list. |
DELETE |
| CLIENT | Deletes an existing user's favouriteslist and all entries. |
GET |
| CLIENT | Returns a group of favourites based on content Id. |
PUT |
| CLIENT | Adds a favourite to a favourites list. |
DELETE |
| CLIENT | Removes a favourite from a favourites list. |
GET |
| CLIENT | Gets all favourites from the list for a given user. |
PUT |
| CLIENT | Updates an existing user's favourites list. |
DELETE |
| CLIENT | Deletes an existing user's favourites list and all entries. |
GET |
| CLIENT | Gets all favourites lists for a given user. |
POST |
| CLIENT | Creates a new favourites list for a user. |
GET |
| CLIENT | Returns a group of favourites based on content Id. |
PUT |
| CLIENT | Adds a favourite to a favourites list. |
DELETE |
| CLIENT | Removes a favourite from a favourites list. |
Histories | |||
GET |
| CLIENT | Gets all histories for a given account. |
POST |
| CLIENT | Creates the history for an account. |
DELETE |
| CLIENT | Deletes an existing history entry |
GET |
| CLIENT | Gets all Histories for a given account |
POST |
| CLIENT | Creates history for user |
DELETE |
| CLIENT | Deletes an existing history entry. |
Playlists | |||
PUT |
| CLIENT | Adds a playlist entry to an account's playlist |
DELETE |
| CLIENT | Removes a playlist entry from an account's playlist |
GET |
| CLIENT | Gets all playlists from a list for a given account |
PUT |
| CLIENT | Updates an existing account's playlist |
DELETE |
| CLIENT | Deletes an existing account's playlist and all entries |
GET |
| CLIENT | Gets all playlists for a given account |
POST |
| CLIENT | Creates a new playlist for account |
PUT |
| CLIENT | Adds a playlist entry to a playlist |
DELETE |
| CLIENT | Removes a playlist entry from a playlist |
GET |
| CLIENT | Gets all playlist entries from a list for a given user |
PUT |
| CLIENT | Updates an existing user's playlist |
DELETE |
| CLIENT | Deletes an existing user's playlist and all entries |
GET |
| CLIENT | Gets all playlists for a given user |
POST |
| CLIENT | Creates a new playlist for a user |
Reminders | |||
DELETE |
| CLIENT | Deletes an existing reminder for a given user |
GET |
| CLIENT | Gets reminders for a given user |
POST |
| CLIENT | Creates a new reminder for an account |
DELETE |
| CLIENT | Deletes an existing reminder for a given user |
GET |
| CLIENT | Gets reminders for a given user |
POST |
| CLIENT | Creates a new reminder |
Admin | |||
PUT |
| ADMIN | Changes everything related to an account Id held in the user activity vault datastore. |
PUT |
| ADMIN | Deletes everything related to a content Id held in the user activity vault datastore. |
PUT |
| ADMIN | Deletes recordings associated with an account. |
PUT | | ADMIN | Deletes recordings associated with an account. |
PUT |
| ADMIN | Purge everything related to a content Id held in the user activity vault datastore. |
Workflow Manager Harmonic VOS360 Adapter (WFM2VOS360)
API | Class | Purpose | |
---|---|---|---|
Location Endpoint /wfm2harmonic-vos360-adapter | |||
GET | /wfm2harmonic-vos360-adapter/EncoderControlWS?wsdl | OPERATOR | |
POST | /wfm2harmonic-vos360-adapter/EncoderControlWS?wsdl | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/EncoderControl-PKGWS?wsdl | OPERATOR | |
POST | /wfm2harmonic-vos360-adapter/EncoderControl-PKGWS?wsdl | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/APUBIWS?wsdl | OPERATOR | |
POST | /wfm2harmonic-vos360-adapter/APUBIWS?wsdl | OPERATOR | |
POST | /wfm2harmonic-vos360-adapter/cxf/pri/v1/capturedassets | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/cxf/pri/v1/capturedassets/{id}?sourceId&assetRelativePath | OPERATOR | |
DELETE | /wfm2harmonic-vos360-adapter/cxf/pri/v1/capturedassets/{id}?sourceId&assetRelativePath | OPERATOR | |
Location Endpoint /wfm2harmonic-vos360-adapter/admin | |||
GET | /wfm2harmonic-vos360-adapter/admin/v1/ping | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/admin/monitoring/health | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/admin/monitoring/camel | OPERATOR | |
GET | /wfm2harmonic-vos360-adapter/admin/monitoring/statistics | OPERATOR |