Versions Compared

Version Old Version 2 New Version 3
Changes made by

Andy Beak (Unlicensed)

Andy Beak (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

In the Netherlands there are local television channels that need to be made available to people living within a particular locality.

Operators are required to:

  1. Make local channels available to local residents
  2. Ensure that local channels from other areas are not available

Table of Contents


Amino implementation

Amino models local channels by including a boolean flag that indicates whether the channel is local or not.

Users are licensed by the customer to view particular local channels;  Amino does not store information about where the user lives and cannot determine what channels they need to be able to view.

Therefore, when displaying a list of local channels to a user, the client should:

  1. Obtain a general list of channels and find the ones which are local by examining the flag
  2. Filter out channels from this list that the user does not have a license for

In practice

Using legacy endpoints

Our legacy endpoint does step 1 and 2 together on behalf of the client;  It is documented at Channel#/Channel/indexUserSpecificChannels

If a channel appears in this list then the user is allowed to watch it.

Warning

There may be a further requirement from the customer that local channels appear with a sequential lcn.   Amino does not guarantee that local channels will be ordered as such in the API output and the client may need to perform further processing in order to meet customer requirements.

Using REST based endpoints

Step 1 - Obtain a list of channels

Fetch an index of the Channel resource.  This API is documented at Metadata: Channels#/Channels/GetChannelIndex

Note that this endpoint is not filtered for the individual user in order to make it publicly cacheable and reduce load on the API.

Step 2 - Obtain the user licenses

Fetch the channel licenses that are related to a user by calling the API documented at License

Step 3 - Remove channels that the user has no license for

Please see the documentation on Channels at /wiki/spaces/MAPI/pages/49676405