Introduction

This section describes BSS communication with AminoTV Management Device API

Authentication and authorization 

All BSS endpoints support API key authorization. The header named 'Authorization' with content "Apikey PUT_YOUR_KEY_HERE" must be passed with request.

In addition to API key authorization some clients can have IP white listing feature enabled, which will allow access only from specific IP's. 

Both API key and IP addresses allowed list are customer specific data and you should contact support person to obtain those.

Endpoints overview

Entities

Device Resource

Up-to-date resource schema could be found on API documentation page Management Device API under schemas section.

Attributes

serial_number is a unique per device and nullable.

player_id is nullable

Relationships

Each of device should belongs to one user

Use cases

Use management API to fetch, create, update and delete Devices

Management Device API

Some notes:

• Device can be created with null values in both fields serial_number and player_id.
• Device can be updated without user relationship. If we does not want to update the device to new user, we do not need to contain user relationships in the request body.

STB passwordless login

By linking user ID to serial number

Irdeto entitlement sync

By linking user ID to player ID

Postman collection

View file
name DeviceManagementV4.zip height 250