OpenTV ENTera & OpenTV Platform Documentation
25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2
25.52_Q4 25.26_Q2 25.12_Q1 24.50_Q4 24.38_Q3 24.26_Q2 23.50_Q4 23.24_Q2 23.12_Q1 22.50_Q4 22.38_Q3 22.24_Q2

Using the device utility API

OTT devices running ION are automatically added the first time they sign on. However, for integration and testing purposes, you can use this device utility API to add devices manually.

Request

To add a device to an existing account, send a POST request to:

http://<host>:<port>/adm/v1/devices/

Example

A request with this payload adds a single device to an existing account:

JSON
{
    "deviceInformation": {
        "securePlayer": {
            "codecs": [
                "H264"
            ],
            "streamings": [
                "HLS"
            ],
            "DRMs": [
                "PRM"
            ]
        },
        "device": {
            "screen": {
                "height": "2560",
                "density": "560",
                "width": "1440"
            },
            "hardware": {
                "model": "Pixel XL",
                "manufacturer": "Google",
                "type": "Handheld"
            },
            "OS": {
                "type": "Android",
                "version": "8.1.0"
            },
            "CPU": {
                "neon": "true",
                "frequency": "1.5936",
                "cores": "4"
            },
            "GPU": {
                "frequency": null,
                "cores": null
            }
        }
    },
    "deviceType": "OPEN",
    "accountUid": "5b7e71658ce5cb0001d85d18"
}

Response

A successful request returns an HTTP 201 status and the id of the new device.

An unsuccessful request returns an HTTP 400 request if there was a problem with the request.

Example

JSON
{
    "_id": "5b7e74448ce5cb0001d85d1b"
}

See also

For full details of this API, see Account and Device Manager (ADM) API documentation.