Skip to main content
Skip table of contents

Use 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:

CODE
{
    "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

CODE
{
    "_id": "5b7e74448ce5cb0001d85d1b"
}

See also

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.