subscription/list

Get list of user subscriptions.

Request Message

Authorization

Access JSON Web Token (GetDeviceCommand or GetDeviceNotification)

Message Representation

{
    "action": {string},
    "requestId": {object},
    "type": {string}
}

Message Parameters

Property Name

Required

Type

Description

action

Yes

string

Action name: subscription/list

requestId

No

object

Request unique identifier, will be passed back in the response message.

type

No

string

Type of returned subscriptions, possible values: 'command' or 'notification'.

Response Message

Message Representation

{
    "action": {string},
    "status": {string},
    "requestId": {object},
    "subscriptions": [{
        "subscriptionId": {integer},
        "type": {string},
        "deviceId": {string},
        "networkIds": {array},
        "deviceTypeIds": {array},
        "names": {array},
        "timestamp": {datetime}
    }]
}

Message Parameters

Property Name

Type

Description

action

string

Action name: subscription/list

status

string

Operation execution status (success or error).

requestId

object

Request unique identifier as specified in the request message.

subscriptions

array

JSON with information about user subscriptions.

subscriptions.subscriptionId

integer

Subscription unique identifier.

subscriptions.type

string

Type of subscription, possible values: 'command' or 'notification'.

subscriptions.deviceId

string

Subscription unique device identifier. 'Null' means subscription to all available devices.

subscriptions.networkIds

array

List of subscribed unique network identifiers. 'Null' means subscription to all available networks.

subscriptions.deviceTypeIds

array

List of subscribed unique device type identifiers. 'Null' means subscription to all available networks.

subscriptions.names

array

List of subscribed names. 'Null' means subscription to all available notification/command names.

subscriptions.timestamp

datetime

Subscription starting timestamp (UTC).