Table of Contents

API : IPTV : MDM : DASHBOARD : CUSTOMER LIST

Introduction

This request returns list of customers whom have devices that fit the query of a number presented in the mdmdashboard

Request

URL https://api.telecomx.dk/iptv/mdm/dashboard/customerlist
Method GET
Access level RESELLER_ADMIN, ADMIN
Query  type  FLEXCARE_LAUNCHER
if `type`='FLEXCARE_LAUNCHER'
versionCode Version code of launcher to find devices for
if not provided, will return devices that does not contain information about launcher version

Query example

https://api.telecomx.dk/iptv/mdm/dashboard/customerlist?type=FLEXCARE_LAUNCHER
https://api.telecomx.dk/iptv/mdm/dashboard/customerlist?type=FLEXCARE_LAUNCHER&versionCode=189

Response

JSON Array
_id ObjectId Unique id of customer
name String Name of customer
apps Number Amount of devices with type 'ANDROID'
stbs Number Amount of devices with type 'STB'
devices Array List of devices under customer
[]._id ObjectId Unique id of device
[].name String Name of device
[].type String Type of device
[].customer ObjectId Unique id of customer owning device
[].deviceId String Barcode of android device
MAC address of STB device
[].usedRoomNumber String Used room number of device
[].technicalRoomNumber String Technical room number of device
[].info Object Object containing further info about device
[].info.appVersion String Version of FlexCare launcher on the given device
[].info.lastComm Date Date of last communication with device

Example

[
    _id: "1234567890ABCDEF12345678",
    name: "This is my customer name",
    stbs: 1,
    apps: 1,
    devices: [
        {
            _id: "1234567890ABCDEF12345678",
            name: "This is a device",
            type: "ANDROID",
            customer: "1234567890ABCDEF12345678",
            deviceId: "1768352",
            usedRoomNumber: "room.23.2",
            technicalRoomNumber: "t.54.2",
            info: {
                appVersion: "189",
                lastComm: "2016-02-03T12:34:56.000Z"
            }
        },
        {
            _id: "1234567890ABCDEF12345678",
            name: "This is a device",
            type: "STB",
            customer: "1234567890ABCDEF12345678",
            deviceId: "00:01:79:12:34:56",
            usedRoomNumber: "room.23.2",
            technicalRoomNumber: "t.54.2",
            info: {
                lastComm: "2016-02-03T12:34:56.000Z"
            }
        }
    ]
]

Errors

Error code Message Description
403 access_denied Insufficient access level
500 internal_error <Unspecified>