Skip to end of banner
Go to start of banner

Management Device v4 API

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 5 Current »

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

Endpoint

HTTP method

Purpose

/api/device/management/v4/devicesGETGet an index of devices.
/api/device/management/v4/devicesPOSTCreate new device
/api/device/management/v4/{device_id}GETGet device by id
/api/device/management/v4/{device_id}DELETEDelete device by id
/api/device/management/v4/{device_id}PATCHUpdate device

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

Table of Contents

Child Pages

  • No labels