diff --git a/docs/api/index.html b/docs/api/index.html index 927291ff..e6b45699 100644 --- a/docs/api/index.html +++ b/docs/api/index.html @@ -114,7 +114,7 @@
Create an action group-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A data synchronization sequence between the gateway and the server has started | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
-} |
-
| Field name | -Field description | -
| gatewayId | -Gateway id | -
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"actionGroupOID" : "an action group OID",
"actionGroupLabel" : "an action group label",
"metadata" : "some metadata",
@@ -300,7 +267,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}Update an action group-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A data synchronization sequence between the gateway and the server has started | +An action group has been updated | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "actionGroupOID" : "an action group OID",
+ "actionGroupLabel" : "an action group label",
+ "metadata" : "some metadata",
+ "notificationCondition" : "a notification condition",
+ "actions" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "commands" : [ {
+ "name" : "an execution command entry name",
+ "delay" : 1,
+ "parameters" : [ {
+ "type" : 1,
+ "value" : "an execution command parameter entry value"
+ } ]
+ } ]
+ } ],
+ "type" : "ActionGroupUpdatedEvent"
} |
||
| gatewayId | -Gateway id | +actionGroupLabel | +Action group label |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +actionGroupOID | +Action group OID | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -A data synchronization sequence between the gateway and the server has completed | +A data synchronization sequence between the gateway and the server has started |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -An action group has been updated | +A data synchronization sequence between the gateway and the server has completed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "actionGroupOID" : "an action group OID",
- "actionGroupLabel" : "an action group label",
- "metadata" : "some metadata",
- "notificationCondition" : "a notification condition",
- "actions" : [ {
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "commands" : [ {
- "name" : "an execution command entry name",
- "delay" : 1,
- "parameters" : [ {
- "type" : 1,
- "value" : "an execution command parameter entry value"
- } ]
- } ]
- } ],
- "name" : "ActionGroupUpdatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| actionGroupLabel | -Action group label | +gatewayId | +Gateway id |
| actionGroupOID | -Action group OID | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID | {
- "creationTime" : 1769503155441,
- "lastUpdateTime" : 1769503155442,
+ "creationTime" : 1785140822217,
+ "lastUpdateTime" : 1785140822217,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : true,
@@ -911,7 +971,7 @@ |
@@ -993,10 +1053,12 @@
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has started | +An action group has been deleted | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "actionGroupOID" : "an action group OID",
+ "type" : "ActionGroupDeletedEvent"
} |
||
| gatewayId | -Gateway id | +actionGroupOID | +Action group OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -An action group has been deleted | +A data synchronization sequence between the gateway and the server has started | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "actionGroupOID" : "an action group OID",
- "name" : "ActionGroupDeletedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| actionGroupOID | -Action group OID | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
Retrieve all user-defined actions groups
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Enduser Open API (enduser/o)
Access scope : enduser/o
[ {
- "creationTime" : 1769503155441,
- "lastUpdateTime" : 1769503155441,
+ "creationTime" : 1785140822217,
+ "lastUpdateTime" : 1785140822217,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : true,
@@ -1339,7 +1429,7 @@
Launch a persistent action group by OID
Per-session rate-limit : 1 calls per 28min 48s period for all operations of the same category (exec)
- Access scope : Enduser Open API (enduser/o)
+ Access scope : enduser/o
> Test operation
| Description | -One or more states of a device have changed (high-level) | +A data synchronization sequence between the gateway and the server has started | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| deviceStates | -Updated device states | +gatewayId | +Gateway id |
| deviceURL | -Device URL | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID |
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -A data synchronization sequence between the gateway and the server has completed | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
} |
||
| gatewayId | -Gateway id | +deviceStates | +Updated device states |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}| Description | +One or more states of a device have changed (high-level) | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
+} |
+
| Field name | +Field description | +
| deviceStates | +Updated device states | +
| deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -One or more states of a device have changed (high-level) | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
-} |
- ||
| Field name | -Field description | -||
| deviceStates | -Updated device states | +setupOID | +Setup OID |
| deviceURL | -Device URL | +siteOID | +Site OID |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +subType | +Execution sub type |
| setupOID | -Setup OID | +timeToNextState | +Remaining time until next execution state |
| Description | -An execution state has changed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "execId" : "an exec id",
- "newState" : "IN_PROGRESS",
- "ownerKey" : "an owner key",
- "type" : 1,
- "subType" : 1,
- "oldState" : "TRANSMITTED",
- "timeToNextState" : 2,
- "failedCommands" : [ {
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "detailedStatus" : {
- "message" : "a message",
- "error" : true
- },
- "rank" : 1,
- "failureType" : "NON_EXECUTING"
- } ],
- "failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
- "failureType" : "NON_EXECUTING"
-} |
-
| Field name | -Field description | -
| execId | -Execution id | -
| failedCommands | -List of failed commands | -
| failureType | -Failure type | -
| newState | -Execution new state | -
| oldState | -Execution previous state | -
| ownerKey | -Execution owner key | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| subType | -Execution sub type | -
| timeToNextState | -Remaining time until next execution state | -
| type | -Execution type | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
}| Description | +An execution state has changed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "execId" : "an exec id",
+ "newState" : "IN_PROGRESS",
+ "ownerKey" : "an owner key",
+ "executionType" : 1,
+ "subType" : 1,
+ "oldState" : "TRANSMITTED",
+ "timeToNextState" : 2,
+ "failedCommands" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "detailedStatus" : {
+ "type" : "generic-error",
+ "message" : "a message",
+ "error" : true
+ },
+ "rank" : 1,
+ "failureType" : "NON_EXECUTING"
+ } ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
+ "failureTypeCode" : 11,
+ "type" : "ExecutionStateChangedEvent",
+ "failureType" : "NON_EXECUTING"
+} |
+
| Field name | +Field description | +
| execId | +Execution id | +
| executionType | +Execution type | +
| failedCommands | +List of failed commands | +
| failureType | +Failure type | +
| newState | +Execution new state | +
| oldState | +Execution previous state | +
| ownerKey | +Execution owner key | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| relatedDevices | +List of devices involved in this execution | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| subType | +Execution sub type | +
| timeToNextState | +Remaining time until next execution state | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}Cancel a running setup-level execution-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Get an action group execution currently running-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Cancel a running execution-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Get action groups executions currently running-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Cancel all running executions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Cancel all running setup-level executions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Get action groups currently running-
Allows fetching internal action group executions
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Cancel a running gateway-level execution. DEPRECATED : all executions started through the API are now attached to setup level-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Cancel all running gateway-level executions. DEPRECATED : all executions started through the API are now attached to setup level-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Get a scheduled execution of delayed trigger-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Cancel a delayed trigger-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"triggerId" : "a trigger id",
- "name" : "DelayedTriggerCancelledEvent"
+ "type" : "DelayedTriggerCancelledEvent"
}Get the list of all scheduled executions of delayed trigger-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Execute a non-persistent action group
The executed action group does not have to be persisted on the server before use.
Per-session rate-limit : 1 calls per 28min 48s period for all operations of the same category (exec)-
Access scope : Enduser Open API (enduser/o)
Access scope : enduser/o
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}| Description | -A data synchronization sequence between the gateway and the server has started | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | -||
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| Description | +One or more states of a device have changed (high-level) | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
+} |
+
| Field name | +Field description | +
| deviceStates | +Updated device states | +
| deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
} |
Execution id | +
|---|---|---|
| executionType | +Execution type | +|
| failedCommands | List of failed commands | @@ -5446,11 +5889,21 @@Owning partners of the parent entity (setup, ...)) . only available in event streams |
| relatedDevices | +List of devices involved in this execution | +|
| setupOID | Setup OID | |
| siteOID | +Site OID | +|
| subType | Execution sub type | @@ -5461,34 +5914,25 @@Remaining time until next execution state |
| type | -Execution type | -
| Description | -One or more states of a device have changed (high-level) | +A data synchronization sequence between the gateway and the server has started | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| deviceStates | -Updated device states | +gatewayId | +Gateway id |
| deviceURL | -Device URL | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID |
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Description | -A data synchronization sequence between the gateway and the server has completed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
} |
Execution id | +
|---|---|---|
| executionType | +Execution type | +|
| failedCommands | List of failed commands | @@ -5848,11 +6327,21 @@Owning partners of the parent entity (setup, ...)) . only available in event streams |
| relatedDevices | +List of devices involved in this execution | +|
| setupOID | Setup OID | |
| siteOID | +Site OID | +|
| subType | Execution sub type | @@ -5863,11 +6352,6 @@Remaining time until next execution state |
| type | -Execution type | -
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}| Description | -A data synchronization sequence between the gateway and the server has started | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | -||
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
} |
Execution id | +
|---|---|---|
| executionType | +Execution type | +|
| failedCommands | List of failed commands | @@ -6251,11 +6776,21 @@Owning partners of the parent entity (setup, ...)) . only available in event streams |
| relatedDevices | +List of devices involved in this execution | +|
| setupOID | Setup OID | |
| siteOID | +Site OID | +|
| subType | Execution sub type | @@ -6266,28 +6801,25 @@Remaining time until next execution state |
| type | -Execution type | -
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}| Description | -A data synchronization sequence between the gateway and the server has completed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | -||
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID | {
- "creationTime" : 1769503155441,
- "lastUpdateTime" : 1769503155441,
+ "creationTime" : 1785140822216,
+ "lastUpdateTime" : 1785140822216,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : true,
@@ -6664,7 +7178,7 @@
- Access scope : Full enduser API access (enduser/*) + Access scope : enduser/* > Test operation |
@@ -6831,7 +7345,7 @@
| Description | -One or more states of a device have changed (high-level) | +A data synchronization sequence between the gateway and the server has started |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+ |
| Field name | +Field description | +|
| gatewayId | +Gateway id | +|
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +|
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | +A new delayed trigger has been scheduled | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartners" : [ "some owning partners" ],
+ "triggerId" : "a trigger id",
+ "type" : "DelayedTriggerSetEvent"
+} |
+
| Field name | +Field description | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| triggerId | +Trigger id | +
| Description | +An action group has been triggered and is currently in execution | +||
|---|---|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "triggerId" : "a trigger id",
+ "triggerType" : "a trigger type",
+ "actionGroupOID" : "an action group OID",
+ "execId" : "an exec id",
+ "type" : "GroupTriggeredEvent"
} |
||
| deviceStates | -Updated device states | +actionGroupOID | +OID of the started action group |
| deviceURL | -Device URL | +execId | +Execution id |
| Setup OID | |||
| siteOID | +Site OID | +||
| triggerId | +Trigger id | +||
| triggerType | +Trigger type | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -An action group has been triggered and is currently in execution | +One or more states of a device have changed (high-level) |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "triggerId" : "a trigger id",
- "triggerType" : "a trigger type",
- "actionGroupOID" : "an action group OID",
- "execId" : "an exec id",
- "name" : "GroupTriggeredEvent"
-} |
- |
| Field name | -Field description | -|
| actionGroupOID | -OID of the started action group | -|
| execId | -Execution id | -|
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -|
| setupOID | -Setup OID | -|
| triggerId | -Trigger id | -|
| triggerType | -Trigger type | -
| Description | -A data synchronization sequence between the gateway and the server has started | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
} |
||
| gatewayId | -Gateway id | +deviceStates | +Updated device states |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +deviceURL | +Device URL |
| Description | -A new delayed trigger has been scheduled | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "triggerId" : "a trigger id",
- "name" : "DelayedTriggerSetEvent"
-} |
- ||
| Field name | -Field description | -||
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -7253,8 +7825,8 @@||
| triggerId | -Trigger id | +siteOID | +Site OID |
@@ -7632,7 +8204,7 @@
|
@@ -7763,7 +8335,7 @@
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"conditionGroupOID" : "a condition group OID",
"label" : "a condition group created event label",
"metadata" : "some metadata",
@@ -8467,7 +9040,7 @@ |
||
| Setup OID | |||
| siteOID | +Site OID | +
Update a condition group-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"conditionGroupOID" : "a condition group OID",
"label" : "a condition group updated event label",
"metadata" : "some metadata",
@@ -8663,7 +9242,7 @@ Generated events on method call
"controllableNames" : [ "some controllable names" ]
}
} ],
- "name" : "ConditionGroupUpdatedEvent"
+ "type" : "ConditionGroupUpdatedEvent"
}Retrieve a condition group by OID-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155097,
- "lastUpdateTime" : 1769503155101,
+ "creationTime" : 1785140821820,
+ "lastUpdateTime" : 1785140821825,
"label" : "a condition group label",
"metadata" : "some metadata",
"conditions" : [ {
@@ -8923,7 +9507,7 @@ Generated events on method call
Delete a condition group by OID
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"conditionGroupOID" : "a condition group OID",
- "name" : "ConditionGroupDeletedEvent"
+ "type" : "ConditionGroupDeletedEvent"
}Evaluate a condition group-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"evaluationStatus" : "FAILED",
- "evaluationTime" : 1769503155103,
+ "evaluationTime" : 1785140821828,
"failedDevices" : [ "some failed devices" ],
"invalidatingDevices" : [ "some invalidating devices" ],
"ignoredControllables" : [ "some ignored controllables" ]
@@ -9261,7 +9851,7 @@ Generated events on method call
Retrieve all user-defined condition groups
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
[ {
- "creationTime" : 1769503155101,
- "lastUpdateTime" : 1769503155101,
+ "creationTime" : 1785140821825,
+ "lastUpdateTime" : 1785140821826,
"label" : "a condition group label",
"metadata" : "some metadata",
"conditions" : [ {
@@ -9481,7 +10071,7 @@
Return an URL to use for August authentication. At the end of the authentication process, the user will be redirected to the given {redirectURL}
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
Return the list of the gateways candidates-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "AugustDiscoverHousesCandidatesFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "AugustDiscoverHousesCandidatesFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"houses" : [ {
"id" : "an id",
"name" : "an august house candidate name",
@@ -9759,7 +10356,7 @@ Generated events on method call
"name" : "an august lock candidate name"
} ]
} ],
- "name" : "AugustDiscoverHousesCandidatesCompletedEvent"
+ "type" : "AugustDiscoverHousesCandidatesCompletedEvent"
}Refresh current access token if necessary-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -9897,10 +10499,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "AugustRefreshCurrentTokenCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "AugustRefreshCurrentTokenFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Setup OID | |
| siteOID | +Site OID | +
| Description | @@ -9931,11 +10540,11 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "AugustRefreshCurrentTokenFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "AugustRefreshCurrentTokenCompletedEvent"
} |
| Setup OID | |
| siteOID | +Site OID | +
Start a discover August gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -10100,12 +10714,12 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "name" : "AugustGatewayDiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "AugustGatewayDiscoverCompletedEvent"
} |
|
| Field description | ||
| gatewayId | +gateway Id | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -10123,11 +10742,16 @@Setup OID |
| siteOID | +Site OID | +
| Description | @@ -10136,11 +10760,13 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "name" : "AugustGatewayDiscoverCompletedEvent"
+ "type" : "AugustGatewayDiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| gatewayId | -gateway Id | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -10163,6 +10784,11 @@Setup OID |
| siteOID | +Site OID | +
Start discover August devices-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverFailedEvent",
+ "type" : "DiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -10421,7 +11072,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}Pair and configure a camera-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -10693,7 +11350,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"cameraId" : "a camera id",
- "name" : "CameraDiscoveredEvent"
+ "type" : "CameraDiscoveredEvent"
}Delete discovered but unpaired cameras for a given gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Set Wifi settings of a paired camera-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get active commissioning codes on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add one or more device commissioning code(s) on given protocol for a future pairing procedure. The limit for zigbee protocol is 4+
Add one or more device commissioning code(s) on given protocol for a future pairing procedure. The limit for zigbee protocol is 127-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove all device commissioning codes on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove a device commissioning code on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Import saved device commissioning codes to the actual codes list-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get saved commissioning codes on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add one or more device saved commissioning code(s) on given protocol for a future pairing procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove all saved device commissioning codes on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove a device saved commissioning code on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
This operation allows to create a device. This operation is useful to add RTS devices, RTD alarm system and EnOcean actuators-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -13099,7 +13790,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}Get addresses of partial devices on given protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
"address" : "an address",
- "creationTime" : 1769503155454
+ "creationTime" : 1785140822239
} ]This operation allows to purge partially discovered raw devices (with status PARTIAL)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"deletedRawDevicesCount" : 1,
- "name" : "PurgePartialRawDevicesEvent"
+ "type" : "PurgePartialRawDevicesEvent"
}This operation allows to purge a partial raw device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Initialize the protocol, and create a stack if needed-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Refresh current access token if necessary-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "EliotRefreshCurrentTokenCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "EliotRefreshCurrentTokenCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "EliotRefreshCurrentTokenFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "EliotRefreshCurrentTokenFailedEvent",
"failureType" : "NON_EXECUTING"
}Start a discover Eliot gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -14189,11 +14909,12 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
- "name" : "EliotDiscoverGatewayCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "EliotDiscoverGatewayFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| gatewayId | -Eliot gateway id | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -14216,11 +14932,16 @@Setup OID |
| siteOID | +Site OID | +
| Description | @@ -14229,11 +14950,12 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "EliotDiscoverGatewayFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
+ "type" : "EliotDiscoverGatewayCompletedEvent"
} |
|
| Field description | ||
| gatewayId | +Eliot gateway id | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -14251,6 +14978,11 @@Setup OID |
| siteOID | +Site OID | +
Send get a list of all user's gateways-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"plants" : [ {
"id" : "an id",
"name" : "an eliot plant name"
} ],
- "name" : "EliotDiscoverGatewaysCompletedEvent"
+ "type" : "EliotDiscoverGatewaysCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "EliotDiscoverGatewaysFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "EliotDiscoverGatewaysFailedEvent",
"failureType" : "NON_EXECUTING"
}Start discover Eliot devices-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A new device has been added to the setup | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
- "type" : 1,
- "value" : "a device attribute change item value"
- } ],
- "name" : "DeviceCreatedEvent"
-} |
-
| Field name | -Field description | -
| deviceAttributes | -Compatible device attributes | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverCompleteEvent"
} |
|---|---|
| Reference | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverFailedEvent",
+ "type" : "DiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}| Description | +A new device has been added to the setup | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
+ "type" : 1,
+ "value" : "a device attribute change item value"
+ } ],
+ "type" : "DeviceCreatedEvent"
+} |
+
| Field name | +Field description | +
| deviceAttributes | +Compatible device attributes | +
| deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Return an URL to use for Eliot authentication. At the end of the authentication process, the user will be redirected to the given {redirectURL}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Return next available EnOcean device address for a given device type-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start an EnOcean learning device procedure (pair a new device indicating the device reference). Useful for devices using generic profiles (require a manual specification). DEPRECATED: use commands on enocean stack-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -15262,10 +16036,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanBadDeviceStimulationEvent"
+ "type" : "EnOceanLearnModeTimeoutEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanLearnStartedEvent"
+ "type" : "EnOceanLearnStartedEvent"
}| Description | -- | ||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanLearnModeTimeoutEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -15377,7 +16142,7 @@ |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | ++ |
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "EnOceanBadDeviceStimulationEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Start an EnOcean learning procedure. DEPRECATED: use commands on enocean stack-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | ++ |
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "EnOceanLearnModeTimeoutEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanLearnStartedEvent"
+ "type" : "EnOceanLearnStartedEvent"
} |
|---|---|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | @@ -15717,10 +16591,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanLearnModeTimeoutEvent"
+ "type" : "EnOceanBadDeviceStimulationEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -15764,7 +16651,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}| Description | -- | ||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanBadDeviceStimulationEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | -||
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "EnOceanLearnStoppedEvent"
+ "type" : "EnOceanLearnStoppedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
Deprecated, use the discoverActuators command on the stack device. Start the IO actuators discover full procedure (discover actuators that share the same key and actuators that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -16215,7 +17086,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}Deprecated, use discover/simple instead. Start the IO actuators discover simple procedure (discover only actuators that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -One or more states of a device have changed (high-level) | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
-} |
-
| Field name | -Field description | -
| deviceStates | -Updated device states | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -16630,7 +17479,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -17166,7 +17815,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}"string value"
{
+ "actuatorAddresses" : [ "some actuator addresses" ],
+ "searchForController" : false,
+ "state" : 1
+}The device address (must be an Atlantic Electrical heater with adjustable temperature setpoint device)+
Options
This operation allows to send a system table to a controller+
This operation forces a device to stop twinning procedure (only supported by Atlantic Electrical heater with adjustable temperature setpoint devices)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "actuatorAddresses" : [ "some actuator addresses" ],
- "sendStackMaster" : false
-}Options+
The device address (must be an Atlantic Electrical heater with adjustable temperature setpoint device)+
| Type | +Name | +Value | +Description | +
|---|---|---|---|
| + Response Body + | ++ (JSON) + | +{
+ "execId" : "string value"
+} |
+ + + + + | +
| Code | + +Meaning | +
|---|---|
| + 200 + | + ++ The request has succeeded + | +
| POST | ++ + + + Controller + + + | ++ + + + /config/{gatewayId}/io/controller/{controllerAddress}/sendSystemTable + + + | +application/json | +
| Description | -One or more states of a device have changed (high-level) | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
-} |
-
| Field name | -Field description | -
| deviceStates | -Updated device states | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -18479,7 +19380,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}| Description | +One or more states of a device have changed (high-level) | +||
|---|---|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
+} |
+ ||
| Field name | +Field description | +||
| type | -Execution type | +deviceStates | +Updated device states | +
| deviceURL | +Device URL | +||
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
} |
Execution id | +|
| executionType | +Execution type | +||
| failedCommands | List of failed commands | @@ -18909,11 +19898,21 @@Owning partners of the parent entity (setup, ...)) . only available in event streams | |
| relatedDevices | +List of devices involved in this execution | +||
| setupOID | Setup OID | ||
| siteOID | +Site OID | +||
| subType | Execution sub type | @@ -18924,11 +19923,6 @@Remaining time until next execution state | |
| type | -Execution type | -
Deprecated, use the resetNetworkSecurity on the stack device. This operation allows to change the IO security key in the box unit and to send this new key to the entire installation-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}This operation allows to retrieve the IO security key from a control point with feedback function and to send it to the entire installation-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}This operation allows to send the current IO security key-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "IOChangedKeyEvent"
+ "type" : "IOChangedKeyEvent"
}This operation allows to send the current IO security key to specified devices-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Deprecated, use the shareNetwork command on the stack device. This operation allows to send the installation IO security key to an IO control point with feedback function-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}This operation allows to send the installation IO security key to an IO control point with feedback function-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Deprecated, use the discover1WayController command on the stack device. Start the IO 1-way remote controller discovery procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -20662,7 +21749,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}Deprecated, use the discoverSensors command on the stack device. Start the IO sensor discover full procedure (discover sensors that share the same key and sensors that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -One or more states of a device have changed (high-level) | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
"type" : 1,
- "value" : "a device state change item value"
+ "value" : "a device attribute change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceCreatedEvent"
} |
||
| deviceStates | -Updated device states | +deviceAttributes | +Compatible device attributes |
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -A new device has been added to the setup | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
"type" : 1,
- "value" : "a device attribute change item value"
+ "value" : "a device state change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +deviceStates | +Updated device states |
| Setup OID | |||
| siteOID | +Site OID | +
Deprecated, use the discoverSensors command on the stack device. Start the IO sensor discover simple procedure (discover only sensors that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A new device has been added to the setup | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
"type" : 1,
- "value" : "a device attribute change item value"
+ "value" : "a device state change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +deviceStates | +Updated device states |
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -One or more states of a device have changed (high-level) | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
"type" : 1,
- "value" : "a device state change item value"
+ "value" : "a device attribute change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceCreatedEvent"
} |
||
| deviceStates | -Updated device states | +deviceAttributes | +Compatible device attributes |
| Setup OID | |||
| siteOID | +Site OID | +
Unsubscribe an IO sensor from the installation-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Unsubscribe an IO sensor from the installation-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Import KNX installation file-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start the Modbus actuators discover procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Discover is complete | +Discover has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| failureType | +Failure type | +|
| gatewayId | Gateway id | @@ -22255,26 +23417,37 @@Reference |
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -Discover has failed | +Discover is complete |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "DiscoverCompleteEvent"
} |
|
| Field description | ||
| failureType | -Failure type | -|
| gatewayId | Gateway id | @@ -22307,6 +23475,16 @@Reference |
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
Start the Modbus modules discover procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Return an URL to use for OAuth2 authorization workflow. At the end of the authentication process, the user will be redirected to the given {redirectUrl}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a discovery of a device. Device commissioning key must be passed in request body. Only works on clouds using device-level integration mode.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
- "name" : "OGCPDiscoverDeviceCompletedEvent"
+ "type" : "OGCPDiscoverDeviceCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
- "name" : "OGCPDiscoverDeviceFailedEvent",
+ "type" : "OGCPDiscoverDeviceFailedEvent",
"failureType" : "NON_EXECUTING"
}Start a discovery of a specific site. If multi-sites is not supported, siteId should be 'default'. Only works on clouds using site-level integration mode.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"siteId" : "a site id",
- "name" : "OGCPDiscoverSiteFailedEvent",
+ "type" : "OGCPDiscoverSiteFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"siteId" : "a site id",
- "name" : "OGCPDiscoverSiteCompletedEvent"
+ "type" : "OGCPDiscoverSiteCompletedEvent"
}Start a discovery of available sites. Only works on clouds using site-level integration mode and supporting multi-sites per account.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A discovery operation of available sites has failed | +A discovery operation of available sites has successfully completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
- "name" : "OGCPDiscoverSitesFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "sites" : [ {
+ "siteId" : "a site id",
+ "label" : "a OGCPSite reference label"
+ } ],
+ "type" : "OGCPDiscoverSitesCompletedEvent"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -A discovery operation of available sites has successfully completed | +A discovery operation of available sites has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
- "sites" : [ {
- "siteId" : "a site id",
- "label" : "a OGCPSite reference label"
- } ],
- "name" : "OGCPDiscoverSitesCompletedEvent"
+ "type" : "OGCPDiscoverSitesFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
Get a list of all available OGCP instances on that server-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get new oauth tokens from user credentials. Only works on clouds using site-level integration mode-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Transmit device pairing informations to the third-party Cloud. Only works on clouds using device-level integration mode and supporting pairing requests.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
"commissioningKey" : "a commissioning key",
@@ -23841,7 +25056,7 @@ Generated events on method call
"deviceMetaData" : {
"a device meta data" : "a device meta data"
},
- "name" : "OGCPDevicePairingCompletedEvent"
+ "type" : "OGCPDevicePairingCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
- "name" : "OGCPDevicePairingFailedEvent",
+ "type" : "OGCPDevicePairingFailedEvent",
"failureType" : "NON_EXECUTING"
}Transmit device pairing informations to the third-party Cloud. Only works on clouds using device-level integration mode and supporting pairing requests.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A device pairing operation has successfully completed | +A device pairing operation has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
- "commissioningKey" : "a commissioning key",
- "productMetaData" : {
- "a product meta data" : "a product meta data"
- },
- "deviceMetaData" : {
- "a device meta data" : "a device meta data"
- },
- "name" : "OGCPDevicePairingCompletedEvent"
+ "type" : "OGCPDevicePairingFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -A device pairing operation has failed | +A device pairing operation has successfully completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
"deviceId" : "a device id",
- "name" : "OGCPDevicePairingFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "commissioningKey" : "a commissioning key",
+ "productMetaData" : {
+ "a product meta data" : "a product meta data"
+ },
+ "deviceMetaData" : {
+ "a device meta data" : "a device meta data"
+ },
+ "type" : "OGCPDevicePairingCompletedEvent"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
Refresh OAuth2 tokens if necessary-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -OAuth2 tokens could not be refreshed | +OAuth2 tokens were successfully refreshed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
- "name" : "OGCPTokensRefreshFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "OGCPTokensRefreshCompletedEvent"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -OAuth2 tokens were successfully refreshed | +OAuth2 tokens could not be refreshed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"cloudId" : "a cloud id",
- "name" : "OGCPTokensRefreshCompletedEvent"
+ "type" : "OGCPTokensRefreshFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
Generate OAuth2 tokens from credentials-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "OpenDoorsGenerateOAuthTokensFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "OpenDoorsGenerateOAuthTokensFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "OpenDoorsGenerateOAuthTokensCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "OpenDoorsGenerateOAuthTokensCompletedEvent"
}Test an OpenDoors account, create and attach a cloud gateway to the current setup then discover devices on that gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -24767,16 +26029,13 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
- "candidates" : [ {
- "deviceLabel" : "a device label",
- "deviceAddress" : "a device address",
- "deviceType" : 2
- } ],
- "name" : "OpenDoorsDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "userId" : "a user id",
+ "type" : "OpenDoorsDiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| candidates | -List of user opendoors devices | -||
| gatewayId | -User login | +failureType | +Failure type |
| Setup OID | |||
| siteOID | +Site OID | +||
| userId | +User login | +
| Description | @@ -24817,12 +26081,17 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "userId" : "a user id",
- "name" : "OpenDoorsDiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
+ "candidates" : [ {
+ "deviceLabel" : "a device label",
+ "deviceAddress" : "a device address",
+ "deviceType" : 2
+ } ],
+ "type" : "OpenDoorsDiscoverCompletedEvent"
} |
||
| failureType | -Failure type | +candidates | +List of user opendoors devices | +
| gatewayId | +User login | ||
| userId | -User login | +siteOID | +Site OID |
| Description | @@ -25016,12 +26290,17 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "userId" : "a user id",
- "name" : "OpenDoorsDiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
+ "candidates" : [ {
+ "deviceLabel" : "a device label",
+ "deviceAddress" : "a device address",
+ "deviceType" : 2
+ } ],
+ "type" : "OpenDoorsDiscoverCompletedEvent"
} |
||
| failureType | -Failure type | +candidates | +List of user opendoors devices | +
| gatewayId | +User login | ||
| userId | -User login | +siteOID | +Site OID |
| Description | @@ -25062,16 +26346,13 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
- "candidates" : [ {
- "deviceLabel" : "a device label",
- "deviceAddress" : "a device address",
- "deviceType" : 2
- } ],
- "name" : "OpenDoorsDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "userId" : "a user id",
+ "type" : "OpenDoorsDiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| candidates | -List of user opendoors devices | -||
| gatewayId | -User login | +failureType | +Failure type |
| Setup OID | |||
| siteOID | +Site OID | +||
| userId | +User login | +
Discover OpenDoors devices on given gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
"candidates" : [ {
"deviceLabel" : "a device label",
"deviceAddress" : "a device address",
"deviceType" : 2
} ],
- "name" : "OpenDoorsDiscoverCompletedEvent"
+ "type" : "OpenDoorsDiscoverCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"userId" : "a user id",
- "name" : "OpenDoorsDiscoverFailedEvent",
+ "type" : "OpenDoorsDiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}Return an URL to use for OpenDoors authentication. At the end of the authentication process, the user will be redirected to the given {redirectURL}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start the OVP actuators discover full procedure (discover actuators that share the same key and actuators that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -An execution state has changed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "execId" : "an exec id",
- "newState" : "IN_PROGRESS",
- "ownerKey" : "an owner key",
- "type" : 1,
- "subType" : 1,
- "oldState" : "TRANSMITTED",
- "timeToNextState" : 2,
- "failedCommands" : [ {
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "detailedStatus" : {
- "message" : "a message",
- "error" : true
- },
- "rank" : 1,
- "failureType" : "NON_EXECUTING"
- } ],
- "failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
- "failureType" : "NON_EXECUTING"
-} |
-
| Field name | -Field description | -
| execId | -Execution id | -
| failedCommands | -List of failed commands | -
| failureType | -Failure type | -
| newState | -Execution new state | -
| oldState | -Execution previous state | -
| ownerKey | -Execution owner key | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| subType | -Execution sub type | -
| timeToNextState | -Remaining time until next execution state | -
| type | -Execution type | -
| Description | -One or more states of a device have changed (high-level) | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
-} |
-
| Field name | -Field description | -
| deviceStates | -Updated device states | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -25905,7 +27057,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
| Description | +One or more states of a device have changed (high-level) | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
+} |
+
| Field name | +Field description | +
| deviceStates | +Updated device states | +
| deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | +An execution state has changed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "execId" : "an exec id",
+ "newState" : "IN_PROGRESS",
+ "ownerKey" : "an owner key",
+ "executionType" : 1,
+ "subType" : 1,
+ "oldState" : "TRANSMITTED",
+ "timeToNextState" : 2,
+ "failedCommands" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "detailedStatus" : {
+ "type" : "generic-error",
+ "message" : "a message",
+ "error" : true
+ },
+ "rank" : 1,
+ "failureType" : "NON_EXECUTING"
+ } ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
+ "failureTypeCode" : 11,
+ "type" : "ExecutionStateChangedEvent",
+ "failureType" : "NON_EXECUTING"
+} |
+
| Field name | +Field description | +
| execId | +Execution id | +
| executionType | +Execution type | +
| failedCommands | +List of failed commands | +
| failureType | +Failure type | +
| newState | +Execution new state | +
| oldState | +Execution previous state | +
| ownerKey | +Execution owner key | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| relatedDevices | +List of devices involved in this execution | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| subType | +Execution sub type | +
| timeToNextState | +Remaining time until next execution state | +
Start the OVP actuators discover in system procedure (discover only actuators that share the same system key)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -26269,7 +27618,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}Start the OVP actuators discover simple procedure (discover only actuators that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -26486,7 +27841,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}| Description | -An execution state has changed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "execId" : "an exec id",
- "newState" : "IN_PROGRESS",
- "ownerKey" : "an owner key",
- "type" : 1,
- "subType" : 1,
- "oldState" : "TRANSMITTED",
- "timeToNextState" : 2,
- "failedCommands" : [ {
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "detailedStatus" : {
- "message" : "a message",
- "error" : true
- },
- "rank" : 1,
- "failureType" : "NON_EXECUTING"
- } ],
- "failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
- "failureType" : "NON_EXECUTING"
-} |
- ||
| Field name | -Field description | -||
| execId | -Execution id | -||
| failedCommands | -List of failed commands | -||
| failureType | -Failure type | -||
| newState | -Execution new state | -||
| oldState | -Execution previous state | -||
| ownerKey | -Execution owner key | -||
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -||
| setupOID | -Setup OID | -||
| subType | -Execution sub type | -||
| timeToNextState | -Remaining time until next execution state | -||
| type | -Execution type | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | +An execution state has changed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "execId" : "an exec id",
+ "newState" : "IN_PROGRESS",
+ "ownerKey" : "an owner key",
+ "executionType" : 1,
+ "subType" : 1,
+ "oldState" : "TRANSMITTED",
+ "timeToNextState" : 2,
+ "failedCommands" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "detailedStatus" : {
+ "type" : "generic-error",
+ "message" : "a message",
+ "error" : true
+ },
+ "rank" : 1,
+ "failureType" : "NON_EXECUTING"
+ } ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
+ "failureTypeCode" : 11,
+ "type" : "ExecutionStateChangedEvent",
+ "failureType" : "NON_EXECUTING"
+} |
+
| Field name | +Field description | +
| execId | +Execution id | +
| executionType | +Execution type | +
| failedCommands | +List of failed commands | +
| failureType | +Failure type | +
| newState | +Execution new state | +
| oldState | +Execution previous state | +
| ownerKey | +Execution owner key | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| relatedDevices | +List of devices involved in this execution | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| subType | +Execution sub type | +
| timeToNextState | +Remaining time until next execution state | +
Start an OVP sensors discover modules on a modbus gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -One or more states of a device have changed (high-level) | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
"type" : 1,
- "value" : "a device state change item value"
+ "value" : "a device attribute change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceCreatedEvent"
} |
||
| deviceStates | -Updated device states | +deviceAttributes | +Compatible device attributes |
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -A new device has been added to the setup | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
"type" : 1,
- "value" : "a device attribute change item value"
+ "value" : "a device state change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +deviceStates | +Updated device states |
| Setup OID | |||
| siteOID | +Site OID | +
Start the OVP sensors discover full procedure (discover sensors that share the same key and actuators that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -27182,7 +28583,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}Start the OVP sensor discover simple procedure (discover only sensors that are in config state)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -One or more states of a device have changed (high-level) | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
"type" : 1,
- "value" : "a device state change item value"
+ "value" : "a device attribute change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceCreatedEvent"
} |
||
| deviceStates | -Updated device states | +deviceAttributes | +Compatible device attributes |
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -A new device has been added to the setup | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
"type" : 1,
- "value" : "a device attribute change item value"
+ "value" : "a device state change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +deviceStates | +Updated device states |
| Setup OID | |||
| siteOID | +Site OID | +
Create a bridge user on the Philips HUE bridge. Does nothing if the user already exists.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a discover for a Philips HUE bridge-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a configuration discover on the target Philips HUE bridge-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
This operation give the next available address-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Pair profalux device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Unpair profalux device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Retrieve all protocol groups and their devices present in a given setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create a group node for a protocol-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Retrieve all controllables allowed in protocol group creation-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Retrieve the urls of the devices present in a given protocol group-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Return an available RTD device address-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a RTD sensor discover procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -29661,7 +31080,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}This operation allows to retrieve the RTD key from an alarm system-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}This operation allows to retrieve an available RTS channel-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
This operation allows to retrieve the RTS key from a control point-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}This operation allows to discover a Ramses gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverFailedEvent",
+ "type" : "DiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -30774,7 +32255,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}This operation allows to discover nodes of a Ramses master device, like an EvoHome-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Discover has failed | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "ref" : "a ref",
- "name" : "DiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
+ "type" : 1,
+ "value" : "a device attribute change item value"
+ } ],
+ "type" : "DeviceCreatedEvent"
} |
||
| failureType | -Failure type | +deviceAttributes | +Compatible device attributes |
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams |
| protocolType | -Device protocol type | +setupOID | +Setup OID |
| ref | -Reference | +siteOID | +Site OID |
| Description | -A new device has been added to the setup | +Discover has failed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
- "type" : 1,
- "value" : "a device attribute change item value"
- } ],
- "name" : "DeviceCreatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "ref" : "a ref",
+ "type" : "DiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceAttributes | -Compatible device attributes | +failureType | +Failure type |
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| protocolType | +Device protocol type | +||
| ref | +Reference | ||
| Setup OID | |||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverCompleteEvent"
}This operation allows to test the Ramses master device address-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"address" : "an address",
- "name" : "ValidAddressEvent"
+ "type" : "ValidAddressEvent"
}This operation allows to test the Ramses gateway address-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"address" : "an address",
- "name" : "ValidAddressEvent"
+ "type" : "ValidAddressEvent"
}Generate OAuth2 tokens from credentials-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatGenerateOAuthTokensCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatGenerateOAuthTokensCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatGenerateOAuthTokensFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatGenerateOAuthTokensFailedEvent",
"failureType" : "NON_EXECUTING"
}Refresh current access token if necessary-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -31878,10 +33430,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatCurrentTokensCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatCurrentTokensFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Setup OID | |
| siteOID | +Site OID | +
| Description | @@ -31912,11 +33471,11 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatCurrentTokensFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatCurrentTokensCompletedEvent"
} |
| Setup OID | |
| siteOID | +Site OID | +
Start a SomfyThermostat discover devices procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Discover is complete | +Discover has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
"ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
+ "type" : "DiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| failureType | +Failure type | +|
| gatewayId | Gateway id | @@ -32114,33 +33686,37 @@Reference |
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -A new device has been added to the setup | +Discover is complete | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
- "type" : 1,
- "value" : "a device attribute change item value"
- } ],
- "name" : "DeviceCreatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "ref" : "a ref",
+ "type" : "DiscoverCompleteEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +gatewayId | +Gateway id |
| deviceURL | -Device URL | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +protocolType | +Device protocol type | +
| ref | +Reference | ||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -Discover has failed | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "ref" : "a ref",
- "name" : "DiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
+ "type" : 1,
+ "value" : "a device attribute change item value"
+ } ],
+ "type" : "DeviceCreatedEvent"
} |
||
| failureType | -Failure type | +deviceAttributes | +Compatible device attributes |
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams |
| protocolType | -Device protocol type | +setupOID | +Setup OID |
| ref | -Reference | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverCompletedEvent"
} |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | @@ -32374,12 +33974,12 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "thermostatId" : "a thermostat id",
- "thermostatLabel" : "a thermostat label",
- "name" : "SomfyThermostatDiscoveredEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| thermostatId | -thermostat ID | -||
| thermostatLabel | -thermostat Label | +siteOID | +Site OID |
| Description | @@ -32420,11 +34015,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "thermostatId" : "a thermostat id",
+ "thermostatLabel" : "a thermostat label",
+ "type" : "SomfyThermostatDiscoveredEvent"
} |
| Setup OID | |
| siteOID | +Site OID | +
| thermostatId | +thermostat ID | +
| thermostatLabel | +thermostat Label | +
discover the gateway corresponding to the gatewayId-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -32589,10 +34201,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "thermostatId" : "a thermostat id",
+ "thermostatLabel" : "a thermostat label",
+ "type" : "SomfyThermostatDiscoveredEvent"
} |
| Setup OID | |
| siteOID | +Site OID | +
| thermostatId | +thermostat ID | +
| thermostatLabel | +thermostat Label | +
| Description | @@ -32623,12 +34253,11 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "thermostatId" : "a thermostat id",
- "thermostatLabel" : "a thermostat label",
- "name" : "SomfyThermostatDiscoveredEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverCompletedEvent"
} |
||
| thermostatId | -thermostat ID | -||
| thermostatLabel | -thermostat Label | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
} |
Setup OID | +|
| siteOID | +Site OID | +
discover gateways candidates-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"candidates" : [ {
"thermostatLabel" : "a thermostat label",
"gatewayId" : "a gateway id",
"thermostatId" : "a thermostat id"
} ],
- "name" : "SomfyThermostatsCandidatesDiscoveredEvent"
+ "type" : "SomfyThermostatsCandidatesDiscoveredEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyThermostatDiscoverFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyThermostatDiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}Return an URL to use for Somfy thermostat authentication. At the end of the authentication process, the user will be redirected to the given {redirectURL}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Register webhook for events-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "SomfyThermostatRegisterWebhookSuccessEvent"
+ "type" : "SomfyThermostatRegisterWebhookSuccessEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "SomfyThermostatRegisterWebhookFailedEvent",
+ "type" : "SomfyThermostatRegisterWebhookFailedEvent",
"failureType" : "NON_EXECUTING"
}Delete webhook for events-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -33482,12 +35142,13 @@ | ||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "webhookId" : 1,
- "name" : "SomfyThermostatDeleteWebhookSuccessEvent"
+ "type" : "SomfyThermostatDeleteWebhookFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| webhookId | -Webhook id | +siteOID | +Site OID |
| Description | @@ -33528,12 +35189,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "SomfyThermostatDeleteWebhookFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "webhookId" : 1,
+ "type" : "SomfyThermostatDeleteWebhookSuccessEvent"
} |
| Setup OID | |
| siteOID | +Site OID | +
| webhookId | +Webhook id | +
Generate OAuth2 tokens from credentials-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectGenerateOAuthTokensFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectGenerateOAuthTokensFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectGenerateOAuthTokensCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectGenerateOAuthTokensCompletedEvent"
}Refresh current access token if necessary-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectCurrentTokenFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectCurrentTokenFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"accessToken" : "an access token",
"refreshToken" : "a refresh token",
- "name" : "SomfyProtectCurrentTokenCompletedEvent"
+ "type" : "SomfyProtectCurrentTokenCompletedEvent"
}Start a SomfyProtect discover devices procedure-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Discover has failed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "ref" : "a ref",
- "name" : "DiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
-} |
-
| Field name | -Field description | -
| failureType | -Failure type | -
| gatewayId | -Gateway id | -
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | -
| protocolType | -Device protocol type | -
| ref | -Reference | -
| Description | -Discover is complete | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "ref" : "a ref",
- "name" : "DiscoverCompleteEvent"
-} |
-
| Field name | -Field description | -
| gatewayId | -Gateway id | -
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | -
| protocolType | -Device protocol type | -
| ref | -Reference | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -34243,7 +35842,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
| Description | +Discover has failed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "ref" : "a ref",
+ "type" : "DiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
+} |
+
| Field name | +Field description | +
| failureType | +Failure type | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| protocolType | +Device protocol type | +
| ref | +Reference | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | +Discover is complete | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "ref" : "a ref",
+ "type" : "DiscoverCompleteEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| protocolType | +Device protocol type | +
| ref | +Reference | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Start a discover of the gateway with the siteID-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -34418,11 +36144,11 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectDiscoverFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectDiscoverCompletedEvent"
} |
|
| Field description | ||
| failureType | -Failure type | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -34445,11 +36166,16 @@Setup OID |
| siteOID | +Site OID | +
| Description | @@ -34458,10 +36184,12 @@ | |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectDiscoverFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| failureType | +Failure type | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -34479,6 +36212,11 @@Setup OID |
| siteOID | +Site OID | +
Start a discover gateways @Deprecated: use discoverGatewaysCandidates and discoverGateway to discover a gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectDiscoverFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectDiscoverFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"siteId" : "a site id",
"siteLabel" : "a site label",
- "name" : "SomfyProtectSiteDiscoveredEvent"
+ "type" : "SomfyProtectSiteDiscoveredEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectDiscoverCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectDiscoverCompletedEvent"
}Discover gateways candidates-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"sites" : [ {
"siteId" : "a site id",
"securityLevel" : "a security level",
@@ -34904,7 +36661,7 @@ Generated events on method call
"shutterAutomaticEnabled" : false,
"label" : "a somfy protect site label"
} ],
- "name" : "SomfyProtectGetSitesCompletedEvent"
+ "type" : "SomfyProtectGetSitesCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectGetSitesFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectGetSitesFailedEvent",
"failureType" : "NON_EXECUTING"
}Send get sites @Deprecated: use discoverGatewaysCandidates-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"sites" : [ {
"siteId" : "a site id",
"securityLevel" : "a security level",
@@ -35126,7 +36895,7 @@ Generated events on method call
"shutterAutomaticEnabled" : false,
"label" : "a somfy protect site label"
} ],
- "name" : "SomfyProtectGetSitesCompletedEvent"
+ "type" : "SomfyProtectGetSitesCompletedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "SomfyProtectGetSitesFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "SomfyProtectGetSitesFailedEvent",
"failureType" : "NON_EXECUTING"
}Return an URL to use for SomfyProtect authentication. At the end of the authentication process, the user will be redirected to the given {redirectUrl}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Private tags : [ upnpcontrol-config ]+
Private tags : [ wiser-config ]
| GET | +POST | - Topology + discover devices | @@ -35432,15 +37212,15 @@application/json | |
- Check if action groups are consistent with the topology+ Start a discover devices on a gateway- Access scope : Full enduser API access (enduser/*) - > Test operation + Access scope : enduser/* + > Test operation |
||||
| Type | -Name | -Value | -Description | -
|---|---|---|---|
| - Response Body - | -- (JSON) - | -{
- "impactedElements" : {
- "actionGroupsOID" : [ "some action groups OID" ],
- "calendarDaysOID" : [ "some calendar days OID" ],
- "setupTriggersOID" : [ "some setup triggers OID" ]
- }
-} |
- - - - - | -
Get sonos topology+
Return an URL to use for wiser authentication. At the end of the authentication process, the user will be redirected to the given {redirectURL}
- Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
"string value"
{
+ "applicationId" : "an application id"
+}The device url+
| Code | - -Meaning | -
|---|---|
| - 200 - | - -- The request has succeeded - | -
| Description | -Sonos get topology successfully finished | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "SonosGetTopologySuccessEvent"
-} |
-
| Field name | -Field description | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| Description | -Sonos get topology failed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "SonosGetTopologyFailedEvent",
- "failureType" : "NON_EXECUTING"
-} |
-
| Field name | -Field description | -
| deviceURL | -Device URL | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
| Description | -Sonos get topology changed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
- "setupOID" : "a setup OID",
- "actionGroupOIDsToUpdate" : [ "an action group OIDs to update" ],
- "name" : "SonosTopologyChangedEvent"
-} |
-
| Field name | -Field description | -
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -
| setupOID | -Setup OID | -
- - - - Wiser protocol - - - --Private tags : [ wiser-config ]- - |
- - | - | |||||||||||||||||||||||||||||||||||||
-
|
- |||||||||||||||||||||||||||||||||||||||
-
Generated events on method callReturn the list of the gateways candidates- Access scope : Full enduser API access (enduser/*) + Access scope : enduser/* > Test operation @@ -36487,14 +37821,15 @@ Generated events on method callJSON |
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"candidates" : [ {
"id" : "an id",
"name" : "a wiser site name"
} ],
- "name" : "WiserSitesCandidatesDiscoveredEvent"
+ "type" : "WiserSitesCandidatesDiscoveredEvent"
}Generated events on method callSetup OID |
siteOID |
+ Site OID |
+ Generated events on method call | |||||||||||||||||||||||||||||||||||
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "WiserSitesCandidatesFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "WiserSitesCandidatesFailedEvent",
"failureType" : "NON_EXECUTING"
} |
Setup OID | +|||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| siteOID | +Site OID | +||||||||||||||||||||||||||||||||||||||
Get Z-Wave controller capability: Unknown (0), First config (1), Primary controller (2) or Secondary controller (3)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Set device wake up interval. DEPRECATED: use command on the related node-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Set device wake up interval and if set, assign the return route. DEPRECATED: use command on the related node-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Device is disabled | +||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDisabledEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZWaveSetModeCompleteEvent"
} |
||
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -+ | Device is disabled | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceDisabledEvent"
} |
||
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
| Description | -+ | Device is disabled | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceDisabledEvent"
} |
||
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -Device is disabled | +||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDisabledEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
Stop a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -37879,10 +39285,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | @@ -37913,11 +39332,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Start a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -38130,11 +39560,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | -+ | Device is disabled | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceDisabledEvent"
} |
||
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -Device is disabled | +||
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDisabledEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveExclusionInOtherNetworkEvent"
+ "type" : "ZWaveExclusionInOtherNetworkEvent"
}Stop a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}Start a Z-Wave exclusion procedure. DEPRECATED: Use startExclusionWithMode command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDisabledEvent"
+ "type" : "DeviceDisabledEvent"
}| Description | @@ -38729,11 +40231,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | -A device is excluded from other zwave network | +|
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveExclusionInOtherNetworkEvent"
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -+ | A device is excluded from other zwave network |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveExclusionInOtherNetworkEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
Stop a Z-Wave exclusion procedure. DEPRECATED: Use stopExclusion command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}Check if device is failed. DEPRECATED: Use isFailedDevice command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a failed device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Z-Wave : replace a given failed node. DEPRECATED: Use replaceFailedDevice command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Start a Z-Wave inclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -39760,11 +41322,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | @@ -39795,10 +41368,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Start a Z-Wave inclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}Stop a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}Start a Z-Wave inclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -40492,11 +42126,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | @@ -40527,10 +42172,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Stop a Z-Wave exclusion procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}Start a Z-Wave inclusion procedure. DEPRECATED: Use startInclusionWithMode command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
+ "type" : "ZWaveSetModeFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"deviceSecurityKey" : "28953-04992-55692-50731-21112-52062-29652-14707",
- "name" : "ZWaveNewClientSideAuthenticationDSKEvent"
+ "type" : "ZWaveNewClientSideAuthenticationDSKEvent"
}Stop a Z-Wave inclusion procedure. DEPRECATED: Use stopInclusion command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | @@ -41252,11 +42970,12 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZWaveSetModeCompleteEvent"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| Description | @@ -41287,10 +43016,13 @@ |
|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveSetModeCompleteEvent"
+ "type" : "ZWaveSetModeFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Z-Wave : start learning mode. DEPRECATED: Use startLearnWithMode command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Z-Wave : stop learning mode. DEPRECATED: Use stopLearn command on transceiver controller.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Launch the refresh operation on the corresponding association group.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Launch the refresh operation on all the association groups available on the node.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Start a Z-Wave reset procedure.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveResetCompleteEvent"
+ "type" : "ZWaveResetCompleteEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZWaveResetFailedEvent",
+ "type" : "ZWaveResetFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDisabledEvent"
+ "type" : "DeviceDisabledEvent"
}Retrieve the last association information sent by the product for the corresponding groupId. Be aware that this information might no be up to date. The 'Association refresh' APIs shall be called to explicitly retrieve the association information from the product.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Retrieve the last association information sent by the product. Be aware that this information might no be up to date. The 'Association refresh' APIs shall be called to explicitly retrieve the association information from the product.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Set the corresponding association group.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
}Bind all device state-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -When zigbee network cannot be bound | +When zigbee network is bound |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeBindNetworkFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZigbeeBindNetworkCompletedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -Device has been updated | +When zigbee network cannot be bound | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device updated event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZigbeeBindNetworkFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -When zigbee network is bound | +Device has been updated | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeBindNetworkCompletedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "label" : "a device updated event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "type" : "DeviceUpdatedEvent"
} |
||
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -A new device has been added to the setup | +The new Zigbee network has been successfully created | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "label" : "a device created event label",
- "placeOID" : "a place OID",
- "metadata" : "some metadata",
- "deviceAttributes" : [ {
- "name" : "a device attribute change item name",
- "type" : 1,
- "value" : "a device attribute change item value"
- } ],
- "name" : "DeviceCreatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZigbeeCreateNetworkCompletedEvent"
} |
||
| deviceAttributes | -Compatible device attributes | +gatewayId | +Gateway id |
| deviceURL | -Device URL | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID |
| Description | -The new Zigbee network has been successfully created | +A new device has been added to the setup | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeCreateNetworkCompletedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "label" : "a device created event label",
+ "placeOID" : "a place OID",
+ "metadata" : "some metadata",
+ "deviceAttributes" : [ {
+ "name" : "a device attribute change item name",
+ "type" : 1,
+ "value" : "a device attribute change item value"
+ } ],
+ "type" : "DeviceCreatedEvent"
} |
||
| gatewayId | -Gateway id | +deviceAttributes | +Compatible device attributes |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeCreateNetworkFailedEvent",
+ "type" : "ZigbeeCreateNetworkFailedEvent",
"failureType" : "NON_EXECUTING"
} |
Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +|
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
Create a new network on restricted channels (leave any existing network before calling this api)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeCreateNetworkFailedEvent",
+ "type" : "ZigbeeCreateNetworkFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -43965,7 +45858,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeCreateNetworkCompletedEvent"
+ "type" : "ZigbeeCreateNetworkCompletedEvent"
}Join a open network-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | +When zigbee network is joined | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZigbeeJoinNetworkCompletedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -44216,7 +46173,7 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeJoinNetworkFailedEvent",
+ "type" : "ZigbeeJoinNetworkFailedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -When zigbee network is joined | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeJoinNetworkCompletedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| Description | -When zigbee network cannot be left | +When zigbee network is left |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeLeaveNetworkFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "ZigbeeLeaveNetworkCompletedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -When zigbee network is left | +A device has been removed from the gateway | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeLeaveNetworkCompletedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "controllableName" : "a controllable name",
+ "type" : "DeviceRemovedEvent"
} |
||
| gatewayId | -Gateway id | +deviceURL | +Device URL |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -A device has been removed from the gateway | +When zigbee network cannot be left | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "name" : "DeviceRemovedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZigbeeLeaveNetworkFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceURL | -Device URL | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
Refresh all device state-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -When zigbee network cannot be refreshed | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeRefreshNetworkFailedEvent",
- "failureType" : "NON_EXECUTING"
-} |
-
| Field name | -Field description | -
| gatewayId | -Gateway id | -
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device created event label",
@@ -44860,7 +46802,7 @@ Generated events on method call
"type" : 1,
"value" : "a device attribute change item value"
} ],
- "name" : "DeviceCreatedEvent"
+ "type" : "DeviceCreatedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "ZigbeeRefreshNetworkCompletedEvent"
+ "type" : "ZigbeeRefreshNetworkCompletedEvent"
}| Description | +When zigbee network cannot be refreshed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "ZigbeeRefreshNetworkFailedEvent",
+ "failureType" : "NON_EXECUTING"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"userId" : "a user id",
"locked" : true,
"owner" : false,
- "templateName" : "a template name",
+ "roleName" : "a role name",
"setupLabel" : "a setup label",
"firstName" : "a first name",
"lastName" : "a last name",
@@ -45317,7 +47324,8 @@ Generated events on method call
"locale" : "a locale",
"mobilePhone" : "a mobile phone",
"phoneNumber" : "a phone number",
- "name" : "EndUserAccountUpdatedEvent"
+ "templateName" : "a role name",
+ "type" : "EndUserAccountUpdatedEvent"
}Ask a single-use token for logged-in user email validation. A token can only be used once. Asking for a new token will cancel the previous one.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create a short-lived Json Web Token representing the current user authority, to be used by external services to access the API on behalf of the user-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Change logged-in user password, given the old password and a new password-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create a new setup and attach it to connected end user-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get default setup OID for the connected user-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Set default setup OID for the connected user-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get setup label-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update setup label-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get all setup information for the connected user. Activation/Expiration timestamps are expressed as milliseconds since EPOCH.
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
"setupOID" : "a setup OID",
"userId" : "a user id",
- "templateName" : "a template name",
+ "roleName" : "a role name",
"owner" : false,
"defaultSetup" : true,
"label" : "a setup end user label",
- "activationTimestamp" : 1769503155136,
- "expirationTimestamp" : 1769503155135
+ "templateName" : "a role name",
+ "activationTimestamp" : 1785140821860,
+ "expirationTimestamp" : 1785140821860
} ]Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete activation date and expiration date for user access on setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155114,
- "lastUpdateTime" : 1769503155114,
+ "creationTime" : 1785140821853,
+ "lastUpdateTime" : 1785140821854,
"userId" : "a user id",
"title" : 1,
"firstName" : "a first name",
@@ -47986,7 +50001,7 @@ Generated events on method call
}
},
"label" : "a main enduser account label",
- "templateName" : "a template name",
+ "roleName" : "a role name",
"applicationId" : "an application id",
"activationTimestamp" : 120123456790,
"expirationTimestamp" : 120123456794,
@@ -48005,7 +50020,8 @@ Generated events on method call
"email" : "an email"
} ]
},
- "password" : "a password"
+ "password" : "a password",
+ "templateName" : "a role name"
}Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "name" : "MainAccountUpdatedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "type" : "MainAccountUpdatedEvent"
}Delete the main enduser account-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add a secondary enduser account-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update a secondary enduser account-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get the secondary account for the given userId-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a secondary enduser account-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get secondary accounts
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get custom roles
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create or update custom role-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get custom role-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a custom role-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get end-user permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get end-user device control permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get end-user device view permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a secondary end-user permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a secondary end-user device control permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add a secondary end-user device control permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove a secondary end-user device control permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a secondary end-user device view permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add a secondary end-user device view permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Remove a secondary end-user device view permissions-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get user preferences
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create a user preference-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"preferenceOID" : "a preference OID",
"userId" : "a user id",
"preferenceName" : "a preference name",
"preferenceValue" : "a preference value",
- "name" : "EndUserPreferenceCreatedEvent"
+ "type" : "EndUserPreferenceCreatedEvent"
}Get a user preference-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a user preference-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"preferenceOID" : "a preference OID",
"userId" : "a user id",
"preferenceName" : "a preference name",
- "name" : "EndUserPreferenceDeletedEvent"
+ "type" : "EndUserPreferenceDeletedEvent"
}Update a user preference-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"preferenceOID" : "a preference OID",
"userId" : "a user id",
"preferenceName" : "a preference name",
"preferenceValue" : "a preference value",
- "name" : "EndUserPreferenceUpdatedEvent"
+ "type" : "EndUserPreferenceUpdatedEvent"
}Register an event listener-
Register a new setup event listener on the current session and return a new listener id. Only one listener may be registered on a given session. Registering an new listener will invalidate the previous one if any. Note that registering an event listener drastically reduces the session timeout : listening sessions are expected to call the /events/{listenerId}/fetch API on a regular basis.
Access scope : Enduser Open API (enduser/o)
Access scope : enduser/o
Unregister an event listener-
Register a new setup event listener on the current session and return a new listener id. Only one listener may be registered on a given session. Registering an new listener will invalidate the previous one if any. Default session timeout is restored.
Access scope : Enduser Open API (enduser/o)
Access scope : enduser/o
Fetch new events
Fetch new events from a registered event listener. Fetched events are removed from the listener buffer. Return an empty response if no event is available.
Per-session rate-limit : 1 calls per 1s period for this particular operation (polling)-
Access scope : Enduser Open API (enduser/o)
Access scope : enduser/o
[ {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"execId" : "an exec id",
"newState" : "IN_PROGRESS",
"ownerKey" : "an owner key",
- "type" : 1,
+ "executionType" : 1,
"subType" : 1,
"oldState" : "TRANSMITTED",
"timeToNextState" : 2,
"failedCommands" : [ {
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"detailedStatus" : {
+ "type" : "generic-error",
"message" : "a message",
"error" : true
},
"rank" : 1,
"failureType" : "NON_EXECUTING"
} ],
+ "relatedDevices" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])"
+ } ],
+ "technical" : false,
"failureTypeCode" : 11,
- "name" : "ExecutionStateChangedEvent",
+ "type" : "ExecutionStateChangedEvent",
"failureType" : "NON_EXECUTING"
} ]Retrieve a device event by ID+
Get a device event that occurred on an actuator or a sensor (fault or warning)
Retrieve data retention policy for executions and states in days-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Code | + +Meaning | +
|---|---|
| + 200 + | + ++ The request has succeeded + | +
| GET | ++ + + + Device events history + + + | ++ + + + /history/devicesEvent + + + | +application/json | +{
- "creationTime" : 1769503155362,
- "lastUpdateTime" : 1769503155366,
+ "creationTime" : 1785140822076,
+ "lastUpdateTime" : 1785140822096,
"id" : "an id",
"location" : {
- "creationTime" : 1769503155366,
- "lastUpdateTime" : 1769503155366,
+ "creationTime" : 1785140822090,
+ "lastUpdateTime" : 1785140822096,
"city" : "a city",
"country" : "a country",
"postalCode" : "a postal code",
@@ -59284,18 +61740,21 @@ |
@@ -59525,7 +62015,7 @@ Generated events on method callGet the list of uploaded files on the setup- Access scope : Full enduser API access (enduser/*) + Access scope : enduser/* > Test operation |
@@ -59556,7 +62046,7 @@ [ {
"filename" : "a filename",
"size" : 2,
- "uploadTime" : 1769503155356,
+ "uploadTime" : 1785140822114,
"metadata" : "some metadata",
"comments" : "some comments",
"oid" : "the setup file UUID"
@@ -59663,7 +62153,7 @@ |
@@ -59838,7 +62328,7 @@ [ {
- "creationTime" : 1769503155378,
- "lastUpdateTime" : 1769503155378,
+ "creationTime" : 1785140822116,
+ "lastUpdateTime" : 1785140822117,
"optionId" : "an option id",
- "startDate" : 1769503155378,
- "endDate" : 1769503155378,
+ "startDate" : 1785140822117,
+ "endDate" : 1785140822116,
"parameters" : [ {
"name" : "a setup option parameter name",
"value" : "a setup option parameter value"
@@ -60986,7 +63476,7 @@ |
@@ -61042,11 +63532,11 @@ {
- "creationTime" : 1769503155378,
- "lastUpdateTime" : 1769503155379,
+ "creationTime" : 1785140822117,
+ "lastUpdateTime" : 1785140822117,
"optionId" : "an option id",
- "startDate" : 1769503155379,
- "endDate" : 1769503155378,
+ "startDate" : 1785140822117,
+ "endDate" : 1785140822117,
"parameters" : [ {
"name" : "a setup option parameter name",
"value" : "a setup option parameter value"
@@ -61154,7 +63644,7 @@ |
@@ -61330,7 +63820,7 @@ [ {
- "creationTime" : 1769503155350,
- "lastUpdateTime" : 1769503155350,
+ "creationTime" : 1785140822009,
+ "lastUpdateTime" : 1785140822043,
"label" : "a calendar day label",
"type" : "WORK_DAY",
"dayTimeTriggers" : [ {
@@ -61716,8 +64206,8 @@ |
@@ -62005,10 +64495,12 @@
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
|---|---|---|---|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Description | -A data synchronization sequence between the gateway and the server has completed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarDayOID" : "a calendar day OID",
"label" : "a calendar day created event label",
"metadata" : "some metadata",
- "type" : "a calendar day created event type",
+ "dayType" : "a day type",
"dayTimeTriggers" : [ {
"startActionGroupTimeTrigger" : {
"triggerType" : "DAWN",
@@ -62097,8 +64566,8 @@ |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | +A data synchronization sequence between the gateway and the server has completed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Update a calendar day.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A data synchronization sequence between the gateway and the server has started | -
|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
-} |
-
| Field name | -Field description | -
| gatewayId | -Gateway id | -
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | -
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarDayOID" : "a calendar day OID",
"label" : "a calendar day updated event label",
"metadata" : "some metadata",
- "type" : "a calendar day updated event type",
+ "dayType" : "a day type",
"dayTimeTriggers" : [ {
"startActionGroupTimeTrigger" : {
"triggerType" : "DAWN",
@@ -62400,8 +64887,8 @@ |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}Get a calendar day.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155345,
- "lastUpdateTime" : 1769503155346,
+ "creationTime" : 1785140822061,
+ "lastUpdateTime" : 1785140822062,
"label" : "a calendar day label",
"type" : "WORK_DAY",
"dayTimeTriggers" : [ {
@@ -62627,8 +65177,8 @@ Generated events on method call
"alwaysAfterMinutes" : 9,
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155345,
- "lastUpdateTime" : 1769503155346,
+ "creationTime" : 1785140822061,
+ "lastUpdateTime" : 1785140822062,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : true,
@@ -62760,7 +65310,7 @@ Generated events on method call
Delete a calendar day.
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
| Description | -A data synchronization sequence between the gateway and the server has completed | +A calendar day has been deleted | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "calendarDayOID" : "a calendar day OID",
+ "type" : "CalendarDayDeletedEvent"
} |
||
| gatewayId | -Gateway id | +calendarDayOID | +Calendar day OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID |
| Description | -A calendar day has been deleted | +A data synchronization sequence between the gateway and the server has completed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "calendarDayOID" : "a calendar day OID",
- "name" : "CalendarDayDeletedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| calendarDayOID | -Calendar day OID | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
}Get all calendar objects applicable for the given startDate and endDate. All the
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get all calendar objects applicable for the given
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Create a calendar day according to calendar days/rules to be removed-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155345,
- "lastUpdateTime" : 1769503155346,
+ "creationTime" : 1785140822061,
+ "lastUpdateTime" : 1785140822062,
"label" : "a calendar day label",
"type" : "WORK_DAY",
"dayTimeTriggers" : [ {
@@ -63503,8 +66083,8 @@ Generated events on method call
"alwaysAfterMinutes" : 9,
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155345,
- "lastUpdateTime" : 1769503155346,
+ "creationTime" : 1785140822061,
+ "lastUpdateTime" : 1785140822062,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : true,
@@ -63636,7 +66216,7 @@ Generated events on method call
Get all calendar rules for setup.
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
[ {
"weeklyCalendarRule" : {
- "creationTime" : 1769503155322,
- "lastUpdateTime" : 1769503155341,
+ "creationTime" : 1785140822056,
+ "lastUpdateTime" : 1785140822057,
"priority" : 1,
"calendarDayOID" : "a calendar day OID",
"finalRule" : true,
@@ -63680,8 +66260,8 @@ Generated events on method call
"endTimeHours" : 1,
"endTimeMinutes" : 1,
"localCalendarDay" : {
- "creationTime" : 1769503155324,
- "lastUpdateTime" : 1769503155341,
+ "creationTime" : 1785140822056,
+ "lastUpdateTime" : 1785140822056,
"label" : "a calendar day label",
"type" : "DAY_OFF_AT_HOME",
"dayTimeTriggers" : [ {
@@ -63701,8 +66281,8 @@ Generated events on method call
"alwaysAfterMinutes" : 10,
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155336,
- "lastUpdateTime" : 1769503155341,
+ "creationTime" : 1785140822056,
+ "lastUpdateTime" : 1785140822056,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : false,
@@ -63846,7 +66426,7 @@ Generated events on method call
Create a calendar rule.
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
| Description | -A calendar rule has been created | +A data synchronization sequence between the gateway and the server has completed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "calendarRuleOID" : "a calendar rule OID",
- "calendarRuleId" : "a calendar rule id",
- "type" : "a calendar rule created event type",
- "priority" : 1,
- "calendarDayOID" : "a calendar day OID",
- "dayType" : "a day type",
- "metadata" : "some metadata",
- "finalRule" : false,
- "randomTimeRange" : 1,
- "startDay" : 4,
- "startMonth" : 3,
- "startYear" : 5,
- "startTimeHours" : 6,
- "startTimeMinutes" : 10,
- "endDay" : 9,
- "endMonth" : 11,
- "endYear" : 7,
- "endTimeHours" : 2,
- "endTimeMinutes" : 8,
- "name" : "CalendarRuleCreatedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| calendarRuleId | -Calendar rule Id | +gatewayId | +Gateway id |
| calendarRuleOID | -Calendar rule OID | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has completed | +A calendar rule has been created | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "calendarRuleOID" : "a calendar rule OID",
+ "calendarRuleId" : "a calendar rule id",
+ "priority" : 1,
+ "calendarDayOID" : "a calendar day OID",
+ "dayType" : "a day type",
+ "metadata" : "some metadata",
+ "finalRule" : false,
+ "randomTimeRange" : 1,
+ "startDay" : 7,
+ "startMonth" : 3,
+ "startYear" : 8,
+ "startTimeHours" : 4,
+ "startTimeMinutes" : 10,
+ "endDay" : 6,
+ "endMonth" : 11,
+ "endYear" : 5,
+ "endTimeHours" : 2,
+ "endTimeMinutes" : 9,
+ "type" : "CalendarRuleCreatedEvent"
} |
||
| gatewayId | -Gateway id | +calendarRuleId | +Calendar rule Id |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +calendarRuleOID | +Calendar rule OID | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarRuleOID" : "a calendar rule OID",
"calendarRuleId" : "a calendar rule id",
- "type" : "a calendar rule updated event type",
"priority" : 1,
"calendarDayOID" : "a calendar day OID",
"dayType" : "a day type",
"metadata" : "some metadata",
"finalRule" : false,
"randomTimeRange" : 1,
- "startDay" : 4,
+ "startDay" : 7,
"startMonth" : 3,
- "startYear" : 5,
- "startTimeHours" : 6,
+ "startYear" : 8,
+ "startTimeHours" : 4,
"startTimeMinutes" : 10,
- "endDay" : 9,
+ "endDay" : 6,
"endMonth" : 11,
- "endYear" : 7,
+ "endYear" : 5,
"endTimeHours" : 2,
- "endTimeMinutes" : 8,
- "name" : "CalendarRuleUpdatedEvent"
+ "endTimeMinutes" : 9,
+ "type" : "CalendarRuleUpdatedEvent"
} |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has completed | +A data synchronization sequence between the gateway and the server has started |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
Get a calendar rule.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"weeklyCalendarRule" : {
- "creationTime" : 1769503155347,
- "lastUpdateTime" : 1769503155348,
+ "creationTime" : 1785140822063,
+ "lastUpdateTime" : 1785140822065,
"priority" : 1,
"calendarDayOID" : "a calendar day OID",
"finalRule" : true,
@@ -64652,8 +67290,8 @@ Generated events on method call
"endTimeHours" : 1,
"endTimeMinutes" : 1,
"localCalendarDay" : {
- "creationTime" : 1769503155347,
- "lastUpdateTime" : 1769503155348,
+ "creationTime" : 1785140822064,
+ "lastUpdateTime" : 1785140822064,
"label" : "a calendar day label",
"type" : "DAY_OFF_AT_HOME",
"dayTimeTriggers" : [ {
@@ -64673,8 +67311,8 @@ Generated events on method call
"alwaysAfterMinutes" : 10,
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155347,
- "lastUpdateTime" : 1769503155348,
+ "creationTime" : 1785140822064,
+ "lastUpdateTime" : 1785140822064,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : false,
@@ -64818,7 +67456,7 @@ Generated events on method call
Delete a calendar rule.
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
| Description | -A data synchronization sequence between the gateway and the server has started | +A calendar rule has been deleted | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "calendarRuleOID" : "a calendar rule OID",
+ "type" : "CalendarRuleDeletedEvent"
} |
||
| gatewayId | -Gateway id | +calendarRuleOID | +Calendar rule OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
| Description | -A calendar rule has been deleted | +A data synchronization sequence between the gateway and the server has started | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "calendarRuleOID" : "a calendar rule OID",
- "name" : "CalendarRuleDeletedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
} |
||
| calendarRuleOID | -Calendar rule OID | +gatewayId | +Gateway id |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Setup OID | |||
| siteOID | +Site OID | +
Create a set of calendar rules.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
}| Description | -A data synchronization sequence between the gateway and the server has completed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarRuleOID" : "a calendar rule OID",
"calendarRuleId" : "a calendar rule id",
- "type" : "a calendar rule created event type",
"priority" : 1,
"calendarDayOID" : "a calendar day OID",
"dayType" : "a day type",
"metadata" : "some metadata",
"finalRule" : false,
"randomTimeRange" : 1,
- "startDay" : 4,
+ "startDay" : 7,
"startMonth" : 3,
- "startYear" : 5,
- "startTimeHours" : 6,
+ "startYear" : 8,
+ "startTimeHours" : 4,
"startTimeMinutes" : 10,
- "endDay" : 9,
+ "endDay" : 6,
"endMonth" : 11,
- "endYear" : 7,
+ "endYear" : 5,
"endTimeHours" : 2,
- "endTimeMinutes" : 8,
- "name" : "CalendarRuleCreatedEvent"
+ "endTimeMinutes" : 9,
+ "type" : "CalendarRuleCreatedEvent"
} |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | +A data synchronization sequence between the gateway and the server has completed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Update a set of calendar rules.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | +A data synchronization sequence between the gateway and the server has started | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationStartedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarRuleOID" : "a calendar rule OID",
"calendarRuleId" : "a calendar rule id",
- "type" : "a calendar rule updated event type",
"priority" : 1,
"calendarDayOID" : "a calendar day OID",
"dayType" : "a day type",
"metadata" : "some metadata",
"finalRule" : false,
"randomTimeRange" : 1,
- "startDay" : 4,
+ "startDay" : 7,
"startMonth" : 3,
- "startYear" : 5,
- "startTimeHours" : 6,
+ "startYear" : 8,
+ "startTimeHours" : 4,
"startTimeMinutes" : 10,
- "endDay" : 9,
+ "endDay" : 6,
"endMonth" : 11,
- "endYear" : 7,
+ "endYear" : 5,
"endTimeHours" : 2,
- "endTimeMinutes" : 8,
- "name" : "CalendarRuleUpdatedEvent"
+ "endTimeMinutes" : 9,
+ "type" : "CalendarRuleUpdatedEvent"
} |
|---|---|
| Setup OID | |
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Description | -A data synchronization sequence between the gateway and the server has completed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| Description | -A data synchronization sequence between the gateway and the server has completed | +A data synchronization sequence between the gateway and the server has started |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"calendarRuleOID" : "a calendar rule OID",
- "name" : "CalendarRuleDeletedEvent"
+ "type" : "CalendarRuleDeletedEvent"
}| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
Get calendar status.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update calendar status.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"functionType" : 1,
"enabled" : false,
- "name" : "GatewayFunctionChangedEvent"
+ "type" : "GatewayFunctionChangedEvent"
}Delete a list of pictures.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a picture-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get url of a picture of a camera-
Url contains a session id available for 30 seconds.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete every picture-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a url where pictures can be exported within a zip file. Url contains a session id available for 30 seconds-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get pictures of a camera in a time range and pictures range-
Same as getPictures operation but within a range of pictures. This operation is useful to render a paginated pictures library.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a particular setup device definition-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155248,
- "lastUpdateTime" : 1769503155269,
- "label" : "a device label",
+ "label" : "a device response label",
+ "uiClass" : "a ui class",
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "shortcut" : false,
- "controllableName" : "core:StatefulClosableActuator",
+ "shortcut" : true,
+ "controllableName" : "a controllable name",
"metadata" : "some metadata",
+ "creationTime" : 1785140821935,
+ "lastUpdateTime" : 1785140821958,
"definition" : {
"commands" : [ {
"commandName" : "a command name",
@@ -67901,7 +70670,7 @@
"name" : "a device state name",
"type" : 1,
"value" : "a device state value",
- "lastUpdateTime" : 120123456793
+ "lastUpdateTime" : 120123456794
} ],
"attributes" : [ {
"name" : "a device attribute name",
@@ -67912,13 +70681,18 @@
"name" : "a device manufacturer data name",
"value" : "a device manufacturer data value"
} ],
+ "localDeviceData" : [ {
+ "key" : "a key",
+ "value" : "a local device attribute value",
+ "category" : "a category",
+ "localDeviceOID" : "a local device OID"
+ } ],
"available" : false,
- "enabled" : true,
+ "enabled" : false,
"placeOID" : "a place OID",
+ "oid" : "the device response UUID",
"widget" : "a widget name",
- "type" : 1,
- "oid" : "the device UUID",
- "uiClass" : "a ui class"
+ "type" : 1
}
This operation allows to delete a device-
This operation is useful to delete IO actuators, RTS devices, RTD alarm system and sensors, EnOcean actuators and Ramses devices.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDeletionFailedEvent",
+ "type" : "DeviceDeletionFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
- "name" : "DeviceRemovedEvent"
+ "type" : "DeviceRemovedEvent"
}This operation allows to delete a device-
This operation is useful to delete IO actuators, RTS devices, RTD alarm system and sensors, EnOcean actuators and Ramses devices.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A device has been removed from the gateway | +Device deletion from the gateway has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "controllableName" : "a controllable name",
- "name" : "DeviceRemovedEvent"
+ "type" : "DeviceDeletionFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Device URL | ||
| failureType | +Failure type | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -68395,25 +71187,31 @@Setup OID |
| siteOID | +Site OID | +
| Description | -Device deletion from the gateway has failed | +A device has been removed from the gateway |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDeletionFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "controllableName" : "a controllable name",
+ "type" : "DeviceRemovedEvent"
} |
|
| Device URL | ||
| failureType | -Failure type | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -68441,6 +71234,11 @@Setup OID |
| siteOID | +Site OID | +
This operation allows to delete a device-
This operation starts an asynchronous workflow to delete a device, updating action groups, triggers and calendar days if necessary. If device protocol allows it, the device is also unpaired from the gateway. Only one device deletion workflow may be run at a time. Use the returned jobId and events to determine when the workflow is complete.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
- "name" : "DeviceRemovedEvent"
+ "type" : "DeviceRemovedEvent"
}| Description | -An asynchronous job has failed | +Device deletion from the gateway has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "jobId" : "a job id",
- "name" : "SetupJobFailedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceDeletionFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| deviceURL | +Device URL | +|
| failureType | +Failure type | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -68700,25 +71516,30 @@Setup OID |
| siteOID | +Site OID | +
| Description | -Device deletion from the gateway has failed | +An asynchronous job has completed successfully |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceDeletionFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "jobId" : "a job id",
+ "type" : "SetupJobCompletedEvent"
} |
|
| Field description | ||
| deviceURL | -Device URL | -|
| failureType | -Failure type | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -68746,24 +71557,30 @@Setup OID |
| siteOID | +Site OID | +
| Description | -An asynchronous job has completed successfully | +An asynchronous job has failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"jobId" : "a job id",
- "name" : "SetupJobCompletedEvent"
+ "type" : "SetupJobFailedEvent"
} |
|
| Setup OID | ||
| siteOID | +Site OID | +
Get a particular setup device controllable definition-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Relocate a device in an existing place+
Update the name of a device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
"string value"
Existing place OID where device is relocated+
New device label+
false
If true, device name will also be updated
| Type | +Name | +Value | +Description | +
|---|---|---|---|
| + Response Body + | ++ (JSON) + | +{
+ "execId" : "string value"
+} |
+ + + + + | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Update the name of a device+
Relocate a device in an existing place-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
"string value"
New device label-
false
If true, device name will also be updated+
Existing place OID where device is relocated
| Type | -Name | -Value | -Description | -
|---|---|---|---|
| - Response Body - | -- (JSON) - | -{
- "execId" : "string value"
-} |
- - - - - | -
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Update the name of a device and its measurement category+
This will set the device attribute core:MeasurementCategory to the set newCategory parameter (See Appendix for details about supported measurement category values). - -This operation is only supported by sensor device that has measurement behavior.
Update the name of a device-
Rename all subsystems at once like newLabel-1, newLabel-2, ... Set to true by default.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
"string value"
New device measurement category-
false
If true, device name will also be updated-
| Type | -Name | -Value | -Description | -
|---|---|---|---|
| - Response Body - | -- (JSON) - | -{
- "execId" : "string value"
-} |
- - - - - | -
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Update device type with new device type+
Update the name of a device and its measurement category+ +
This will set the device attribute core:MeasurementCategory to the set newCategory parameter (See Appendix for details about supported measurement category values). -Access scope : Full enduser API access (enduser/*)
- > Test operation +This operation is only supported by sensor device that has measurement behavior.
Access scope : enduser/*
2
"string value"
New device type+
New device label+
"string value"
New device measurement category+
false
If true, device name will also be updated
| Type | +Name | +Value | +Description | +
|---|---|---|---|
| + Response Body + | ++ (JSON) + | +{
+ "execId" : "string value"
+} |
+ + + + + | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}| GET | +PUT | - Device additional information + Device Type | @@ -70077,26 +72976,26 @@application/json |
| PUT | ++ + + + Device controllable + + + | ++ + + + /setup/devices/{deviceURL}/alternativeControllables/{newControllableName} + + + | +application/json | +
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
} |
||
|---|---|---|---|
| Setup OID | |||
| siteOID | +Site OID | +
Get all equivalent controllables to another one-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get all equivalent controllables to another one-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Check if device firmware is up-to-date-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Check if device supports firmware update feature-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update The device firmware to the next available version-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Device firmware update is completed | +A firmware update started on the given device |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateCompletedEvent"
+ "type" : "DeviceFirmwareUpdateStartedEvent"
} |
|
| deviceURL | -Device URL | +The device address | +
| gatewayId | +The gateway id | |
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -Device firmware update failed | +Gateway firmware update failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateFailedEvent",
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
+ "firmwareType" : "a firmware type",
+ "type" : "GatewayFirmwareUpdateFailedEvent",
"failureType" : "NON_EXECUTING"
} |
Field description | -
| deviceURL | -Device URL | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -72097,26 +75216,30 @@Setup OID |
| siteOID | +Site OID | +
| Description | -Gateway firmware update failed | +Device firmware update is completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
- "firmwareType" : "a firmware type",
- "name" : "GatewayFirmwareUpdateFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceFirmwareUpdateCompletedEvent"
} |
|
| Field description | ||
| deviceURL | +Device URL | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -72134,24 +75262,31 @@Setup OID |
| siteOID | +Site OID | +
| Description | -A firmware update started on the given gateway | +Gateway firmware update is completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "name" : "GatewayFirmwareUpdateStartedEvent"
+ "firmwareType" : "a firmware type",
+ "type" : "GatewayFirmwareUpdateCompletedEvent"
} |
|
| Field description | ||
| gatewayId | -The gateway id | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -72174,25 +75304,31 @@Setup OID |
| siteOID | +Site OID | +
| Description | -A firmware update started on the given device | +Device firmware update failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateStartedEvent"
+ "type" : "DeviceFirmwareUpdateFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| deviceURL | -The device address | -|
| gatewayId | -The gateway id | +Device URL |
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -Gateway firmware update is completed | +A firmware update started on the given gateway |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "firmwareType" : "a firmware type",
- "name" : "GatewayFirmwareUpdateCompletedEvent"
+ "type" : "GatewayFirmwareUpdateStartedEvent"
} |
|
| Field description | ||
| gatewayId | +The gateway id | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -72256,6 +75397,11 @@Setup OID |
| siteOID | +Site OID | +
Get all manufacturer references for the device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update device metadata-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Get a particular state of a requested device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update a device persistent state-
Update the value of a given device state. This operation is only supported on some specific device states (called 'persistent' device states') that may be modified directly from the API.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}Retrieve states of requested device-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get setup definition+
Get setup definition
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
- "creationTime" : 1769503155271,
- "lastUpdateTime" : 1769503155272,
- "label" : "a device label",
+ "label" : "a device response label",
+ "uiClass" : "a ui class",
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "shortcut" : false,
- "controllableName" : "core:StatefulClosableActuator",
+ "shortcut" : true,
+ "controllableName" : "a controllable name",
"metadata" : "some metadata",
+ "creationTime" : 1785140821960,
+ "lastUpdateTime" : 1785140821961,
"definition" : {
"commands" : [ {
"commandName" : "a command name",
@@ -73337,7 +76496,7 @@ Generated events on method call
"name" : "a device state name",
"type" : 1,
"value" : "a device state value",
- "lastUpdateTime" : 120123456793
+ "lastUpdateTime" : 120123456794
} ],
"attributes" : [ {
"name" : "a device attribute name",
@@ -73348,13 +76507,18 @@ Generated events on method call
"name" : "a device manufacturer data name",
"value" : "a device manufacturer data value"
} ],
+ "localDeviceData" : [ {
+ "key" : "a key",
+ "value" : "a local device attribute value",
+ "category" : "a category",
+ "localDeviceOID" : "a local device OID"
+ } ],
"available" : false,
- "enabled" : true,
+ "enabled" : false,
"placeOID" : "a place OID",
+ "oid" : "the device response UUID",
"widget" : "a widget name",
- "type" : 1,
- "oid" : "the device UUID",
- "uiClass" : "a ui class"
+ "type" : 1
} ]Link devices by adding a groupId-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Unlink devices by removing groupId-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Unlink devices by removing groupId-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"controllableName" : "a controllable name",
"label" : "a device updated event label",
"placeOID" : "a place OID",
"metadata" : "some metadata",
- "name" : "DeviceUpdatedEvent"
+ "type" : "DeviceUpdatedEvent"
}Ask the box to refresh all devices availabilities for protocols that support this operation
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}Get all devices urls which have that controllable name-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get all device urls and sort them by their controllables names-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Retrieve devices URLs which are not up-to-date-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update the given devices firmwares to the next available version-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Gateway firmware update is completed | +A firmware update started on the given device |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "firmwareType" : "a firmware type",
- "name" : "GatewayFirmwareUpdateCompletedEvent"
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "type" : "DeviceFirmwareUpdateStartedEvent"
} |
|
| Field description | ||
| deviceURL | +The device address | +|
| gatewayId | +The gateway id | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -74712,24 +77911,31 @@Setup OID |
| siteOID | +Site OID | +
| Description | -A firmware update started on the given gateway | +Gateway firmware update is completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "name" : "GatewayFirmwareUpdateStartedEvent"
+ "firmwareType" : "a firmware type",
+ "type" : "GatewayFirmwareUpdateCompletedEvent"
} |
|
| Field description | ||
| gatewayId | -The gateway id | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -74752,25 +77953,30 @@Setup OID |
| siteOID | +Site OID | +
| Description | -A firmware update started on the given device | +Device firmware update is completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "gatewayId" : "a gateway id",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateStartedEvent"
+ "type" : "DeviceFirmwareUpdateCompletedEvent"
} |
|
| deviceURL | -The device address | -|
| gatewayId | -The gateway id | +Device URL |
| Setup OID | ||
| siteOID | +Site OID | +
| Description | -Gateway firmware update failed | +A firmware update started on the given gateway |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"gatewayId" : "a gateway id",
- "firmwareType" : "a firmware type",
- "name" : "GatewayFirmwareUpdateFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "GatewayFirmwareUpdateStartedEvent"
} |
|
| Field description | ||
| gatewayId | +The gateway id | +|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -74835,6 +78045,11 @@Setup OID |
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateFailedEvent",
+ "type" : "DeviceFirmwareUpdateFailedEvent",
"failureType" : "NON_EXECUTING"
}| Description | -Device firmware update is completed | +Gateway firmware update failed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "name" : "DeviceFirmwareUpdateCompletedEvent"
+ "owningPartners" : [ "some owning partners" ],
+ "gatewayId" : "a gateway id",
+ "firmwareType" : "a firmware type",
+ "type" : "GatewayFirmwareUpdateFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Field description | ||
| deviceURL | -Device URL | -|
| owningPartners | Owning partners of the parent entity (setup, ...)) . only available in event streams | @@ -74916,6 +78135,11 @@Setup OID |
| siteOID | +Site OID | +
Get growing indexes values variations on a given time slot-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
"deviceUrl" : "a device url",
"stateName" : "a state name",
- "from" : 1769533841155,
- "to" : 1769533841155
+ "from" : 1785201548486,
+ "to" : 1785201548486
} ]Ask the box to refresh all or given devices states for protocols supporting that operation
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -One or more states of a device have changed (high-level) | +Devices states could not be refreshed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "deviceStates" : [ {
- "name" : "a device state change item name",
- "type" : 1,
- "value" : "a device state change item value"
- } ],
- "name" : "DeviceStateChangedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "type" : "RefreshAllDevicesStatesFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
||
| deviceStates | -Updated device states | +gatewayId | +Gateway id |
| deviceURL | -Device URL | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | +setupOID | +Setup OID |
| setupOID | -Setup OID | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesCompletedEvent"
+ "type" : "RefreshAllDevicesStatesCompletedEvent"
} |
||
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | |||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
| Description | -Devices states could not be refreshed | +One or more states of a device have changed (high-level) | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "name" : "RefreshAllDevicesStatesFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "deviceStates" : [ {
+ "name" : "a device state change item name",
+ "type" : 1,
+ "value" : "a device state change item value"
+ } ],
+ "type" : "DeviceStateChangedEvent"
} |
||
| gatewayId | -Gateway id | +deviceStates | +Updated device states |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +deviceURL | +Device URL | +
| owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams | +||
| setupOID | +Setup OID | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesFailedEvent",
+ "type" : "RefreshAllDevicesStatesFailedEvent",
"failureType" : "NON_EXECUTING"
} |
Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +|
| setupOID | +Setup OID | +||
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesCompletedEvent"
+ "type" : "RefreshAllDevicesStatesCompletedEvent"
}Ask the box to refresh all states on given device
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -Devices states could not be refreshed | +Refresh all states query for given protocol type is completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesFailedEvent",
- "failureType" : "NON_EXECUTING"
+ "type" : "RefreshAllDevicesStatesCompletedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}| Description | -Refresh all states query for given protocol type is completed | +Devices states could not be refreshed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesCompletedEvent"
+ "type" : "RefreshAllDevicesStatesFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| PUT | ++ + + + LocalDevice localDeviceData + + + | ++ + + + /setup/devices/{deviceURL}/localDeviceData/{key} + + + | +application/json | +
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesFailedEvent",
+ "type" : "RefreshAllDevicesStatesFailedEvent",
"failureType" : "NON_EXECUTING"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesCompletedEvent"
+ "type" : "RefreshAllDevicesStatesCompletedEvent"
}deactivate a module for a gateway-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Return an InteractiveNotification-
This operation returns an InteractiveNotification object to be displayed.
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Complete an interactive notification-
When the user clicks a button (except for cancel), this method should be called with the flag value of the clicked button. The notification state is then changed on the server-side and the notification is moved to history
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Return a collection of interactive notification waiting for validation
This operation returns a collection of InteractiveNotification objects to be displayed one after the other.
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Code | + +Meaning | +
|---|---|
| + 200 + | + ++ The request has succeeded + | +
| GET | ++ + + + Setup interactive notifications history + + + | ++ + + + /setup/interactiveNotifications/history + + + | +application/json | +
+ + + + Local Devices + + + ++ + + |
+ + | + | ||||||||||
+
|
+ ||||||||||||
+
|
+ ||||||||||||
+
|
+ ||||||||||||
+
|
+ ||||||||||||
+
|
+ ||||||||||||
+
|
+ ||||||||||||
+
|
||||||||||||
| Description | -Refresh all states query for given protocol type is completed | +Devices states could not be refreshed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"protocolType" : 1,
- "name" : "RefreshAllDevicesStatesCompletedEvent"
+ "type" : "RefreshAllDevicesStatesFailedEvent",
+ "failureType" : "NON_EXECUTING"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| Description | -Devices states could not be refreshed | -||
|---|---|---|---|
| JSON | -{
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "protocolType" : 1,
- "name" : "RefreshAllDevicesStatesFailedEvent",
- "failureType" : "NON_EXECUTING"
-} |
- ||
| Field name | -Field description | -||
| gatewayId | -Gateway id | +setupOID | +Setup OID |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +siteOID | +Site OID |
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
"deviceStates" : [ {
"name" : "a device state change item name",
"type" : 1,
"value" : "a device state change item value"
} ],
- "name" : "DeviceStateChangedEvent"
+ "type" : "DeviceStateChangedEvent"
} |
||
| Setup OID | |||
| siteOID | +Site OID | +
| Description | +Refresh all states query for given protocol type is completed | +
|---|---|
| JSON | +{
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "protocolType" : 1,
+ "type" : "RefreshAllDevicesStatesCompletedEvent"
+} |
+
| Field name | +Field description | +
| gatewayId | +Gateway id | +
| owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +
| setupOID | +Setup OID | +
| siteOID | +Site OID | +
Deprecated, use the new android firebase infrastructure. Subscribe an Android device to the notification service-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionCreatedEvent"
+ "type" : "PushSubscriptionCreatedEvent"
}Deprecated, use the new android firebase infrastructure. Update an Android device subscription-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Deprecated, use the new android firebase infrastructure. Get the current subscription configuration for a device (Android)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"device" : {
- "creationTime" : 1769503155215,
- "lastUpdateTime" : 1769503155215,
+ "creationTime" : 1785140821910,
+ "lastUpdateTime" : 1785140821910,
"udid" : "a udid",
"model" : "a model",
"version" : "a version",
@@ -88958,7 +94161,7 @@ Generated events on method call
Deprecated, use DELETE on {subscriberOID} instead. Unsubscribe an Android device
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionDeletedEvent"
+ "type" : "PushSubscriptionDeletedEvent"
}Subscribe an Android device to the firebase notification service-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionCreatedEvent"
+ "type" : "PushSubscriptionCreatedEvent"
}Update an Android firebase device subscription-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get the current subscription configuration for a device (Android firebase)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"device" : {
- "creationTime" : 1769503155198,
- "lastUpdateTime" : 1769503155198,
+ "creationTime" : 1785140821912,
+ "lastUpdateTime" : 1785140821912,
"udid" : "a udid",
"model" : "a model",
"version" : "a version",
@@ -89679,7 +94894,7 @@ Generated events on method call
Subscribe an Apple device to the notification service
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionCreatedEvent"
+ "type" : "PushSubscriptionCreatedEvent"
}Update an Apple device subscription-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get the current subscription configuration for a device (Apple)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"device" : {
- "creationTime" : 1769503155213,
- "lastUpdateTime" : 1769503155213,
+ "creationTime" : 1785140821914,
+ "lastUpdateTime" : 1785140821914,
"udid" : "a udid",
"model" : "a model",
"version" : "a version",
@@ -90226,7 +95447,7 @@ Generated events on method call
Deprecated, use DELETE on {subscriberOID} instead. Unsubscribe an Apple device
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionDeletedEvent"
+ "type" : "PushSubscriptionDeletedEvent"
}Get all push devices for connected endUser from functional application id-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Unsubscribe a user from the notification service for authenticated setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionDeletedEvent"
+ "type" : "PushSubscriptionDeletedEvent"
}Unsubscribe a device from the notification service-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "pushSubscriptionOID" : "a push subscription OID",
+ "type" : "PushSubscriptionDeletedEvent"
+}| DELETE | ++ + + + Notifications + + + | ++ + + + /setup/subscribe/notification/all + + + | +application/json | +
| DELETE | -- - - - Notifications - - - | -- - - - /setup/subscribe/notification/all - - - | -application/json | -{
"device" : {
- "creationTime" : 1769503155201,
- "lastUpdateTime" : 1769503155201,
+ "creationTime" : 1785140821916,
+ "lastUpdateTime" : 1785140821916,
"udid" : "a udid",
"model" : "a model",
"version" : "a version",
@@ -92062,7 +97313,7 @@ |
@@ -92159,11 +97410,12 @@
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"pushSubscriptionOID" : "a push subscription OID",
- "name" : "PushSubscriptionDeletedEvent"
+ "type" : "PushSubscriptionDeletedEvent"
} |
||
|---|---|---|---|
| Setup OID | |||
| siteOID | +Site OID | +
Create a secret-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update a secret-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Delete a secret-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update a secret value-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
List secrets-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Fetch an URL for the user's MyTahoma account-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"serviceId" : "a service id",
"url" : "a url",
- "name" : "ExternalServiceURLEvent"
+ "type" : "ExternalServiceURLEvent"
}Get the activated third party model for current setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"thirdPartyModelSetupUsers" : [ {
- "creationTime" : 1769503155472,
- "lastUpdateTime" : 1769503155472,
+ "creationTime" : 1785140822262,
+ "lastUpdateTime" : 1785140822262,
"userId" : "a user id",
"setupOID" : "a setup OID",
"modelType" : 1,
@@ -93398,7 +98661,7 @@
Get the security status of a third party model
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
Unlock security actions of a third party model-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add items to a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Remove items from a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Relocate items to another zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Get the items of a zone-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Add items to a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Relocate items to a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Remove items from a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Remove items from a zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Create zone in user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone created event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneCreatedEvent"
+ "type" : "ZoneCreatedEvent"
}Update zone-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a zone of a user setup-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "creationTime" : 1769503155311,
- "lastUpdateTime" : 1769503155314,
+ "creationTime" : 1785140821999,
+ "lastUpdateTime" : 1785140822003,
"label" : "a zone label",
"type" : 0,
"items" : [ {
@@ -95771,7 +101082,7 @@ Generated events on method call
Update zone
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
Delete a zone from user setup.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "name" : "ZoneDeletedEvent"
+ "type" : "ZoneDeletedEvent"
}Update zone type and label-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"zoneOID" : "a zone OID",
- "type" : 1,
+ "zoneType" : 1,
"label" : "a zone updated event label",
"deviceURLs" : [ "some device URLs" ],
"placeOIDs" : [ "some place OIDs" ],
- "name" : "ZoneUpdatedEvent"
+ "type" : "ZoneUpdatedEvent"
}Get all zones of a user setup
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
- "creationTime" : 1769503155315,
- "lastUpdateTime" : 1769503155315,
+ "creationTime" : 1785140822004,
+ "lastUpdateTime" : 1785140822004,
"label" : "a zone label",
"type" : 0,
"items" : [ {
@@ -96525,7 +101848,7 @@
Create a new setup trigger : see asset-specs for scheduling Intervals composition (exhaustive but non-functional example)
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
}| Description | -A setup trigger could not be created | +A data synchronization sequence between the gateway and the server has completed | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
- "setupTriggerType" : 1,
- "setupTriggerOID" : "a setup trigger OID",
- "setupTriggerId" : "a setup trigger id",
- "name" : "SetupTriggerCreationFailedEvent"
+ "owningPartner" : "an owning partner",
+ "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
+ "type" : "GatewaySynchronizationEndedEvent"
} |
||
| owningPartners | -Owning partners of the parent entity (setup, ...)) . only available in event streams | -||
| setupOID | -Setup OID | +gatewayId | +Gateway id |
| setupTriggerId | -Setup trigger Id | +owningPartner | +Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams |
| setupTriggerOID | -Setup trigger OID | +setupOID | +Setup OID |
| setupTriggerType | -Setup trigger type | +siteOID | +Site OID |
| Description | -A data synchronization sequence between the gateway and the server has completed | +A setup trigger could not be created | |
|---|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartner" : "an owning partner",
- "gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
+ "setupTriggerType" : 1,
+ "setupTriggerOID" : "a setup trigger OID",
+ "setupTriggerId" : "a setup trigger id",
+ "type" : "SetupTriggerCreationFailedEvent"
} |
||
| gatewayId | -Gateway id | +owningPartners | +Owning partners of the parent entity (setup, ...)) . only available in event streams |
| owningPartner | -Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | +setupOID | +Setup OID | +
| setupTriggerId | +Setup trigger Id | +||
| setupTriggerOID | +Setup trigger OID | +||
| setupTriggerType | +Setup trigger type | +||
| siteOID | +Site OID | ||
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"setupTriggerType" : 1,
"setupTriggerOID" : "a setup trigger OID",
"setupTriggerId" : "a setup trigger id",
@@ -96859,34 +102213,36 @@ |
||
| Setup trigger type | |||
| siteOID | +Site OID | +
Update an existing setup trigger : see asset-specs for scheduling Intervals composition (exhaustive but non-functional example)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -A data synchronization sequence between the gateway and the server has started | +A data synchronization sequence between the gateway and the server has completed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
| Description | -A data synchronization sequence between the gateway and the server has completed | +A data synchronization sequence between the gateway and the server has started |
|---|---|---|
| JSON | {
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
} |
|
| Owning partner of the parent entity (gateway, setup group, ...)) . only available in event streams | ||
| setupOID | +Setup OID | +|
| siteOID | +Site OID | +
{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"setupTriggerType" : 1,
"setupTriggerOID" : "a setup trigger OID",
"setupTriggerId" : "a setup trigger id",
@@ -98072,34 +103458,36 @@ Generated events on method call
"mode" : 1,
"sourceDeviceURLs" : [ "some source device URLs" ],
"effects" : [ {
- "id" : "an id",
- "actionGroupOID" : "an action group OID",
- "localActionGroup" : {
- "creationTime" : 1769533841510,
- "lastUpdateTime" : 1769533841511,
- "label" : "a managed action group label",
- "metadata" : "some metadata",
- "shortcut" : true,
- "notificationTypeMask" : 1,
- "notificationCondition" : "ALWAYS",
- "notificationText" : "a notification text",
- "notificationTitle" : "a notification title",
- "targetEmailAddresses" : [ "some target email addresses" ],
- "targetPhoneNumbers" : [ "some target phone numbers" ],
- "targetPushSubscriptions" : [ "some target push subscriptions" ],
- "actions" : [ {
- "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
- "commands" : [ {
- "type" : 1,
- "name" : "a command name",
- "parameters" : [ "some parameters" ],
- "sensitiveParametersIndexes" : [ 1 ],
- "authentication" : "an authentication",
- "delay" : 1,
- "lockLevel" : 13
- } ]
- } ],
- "oid" : "the managed action group UUID"
+ "actionGroupEffect" : {
+ "id" : "an id",
+ "actionGroupOID" : "an action group OID",
+ "localActionGroup" : {
+ "creationTime" : 1785201548778,
+ "lastUpdateTime" : 1785201548778,
+ "label" : "a managed action group label",
+ "metadata" : "some metadata",
+ "shortcut" : true,
+ "notificationTypeMask" : 1,
+ "notificationCondition" : "ALWAYS",
+ "notificationText" : "a notification text",
+ "notificationTitle" : "a notification title",
+ "targetEmailAddresses" : [ "some target email addresses" ],
+ "targetPhoneNumbers" : [ "some target phone numbers" ],
+ "targetPushSubscriptions" : [ "some target push subscriptions" ],
+ "actions" : [ {
+ "deviceURL" : "device URL (<protocol>://<gatewayId>/<deviceAddress>[#<subsystemId>])",
+ "commands" : [ {
+ "type" : 1,
+ "name" : "a command name",
+ "parameters" : [ "some parameters" ],
+ "sensitiveParametersIndexes" : [ 1 ],
+ "authentication" : "an authentication",
+ "delay" : 1,
+ "lockLevel" : 13
+ } ]
+ } ],
+ "oid" : "the managed action group UUID"
+ }
}
} ],
"rootConditionBlock" : {
@@ -98134,7 +103522,7 @@ Generated events on method call
"stopDay" : 6
}
} ],
- "name" : "SetupTriggerUpdatedEvent"
+ "type" : "SetupTriggerUpdatedEvent"
}Test a setup trigger definition, executing its effects : see asset-specs for scheduling Intervals composition (exhaustive but non-functional example)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
test a single discrete trigger effect-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get a setup trigger by type and OID-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
"ifThenSetupTrigger" : {
- "creationTime" : 1769503155415,
- "lastUpdateTime" : 1769503155432,
+ "creationTime" : 1785140822181,
+ "lastUpdateTime" : 1785140822203,
"label" : "an if then setup trigger label",
"serverSide" : true,
"mode" : 1,
@@ -100048,8 +105441,8 @@ Generated events on method call
"id" : "an id",
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155432,
- "lastUpdateTime" : 1769503155432,
+ "creationTime" : 1785140822203,
+ "lastUpdateTime" : 1785140822203,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : false,
@@ -100329,7 +105722,7 @@ Generated events on method call
Delete a setup trigger
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationEndedEvent"
+ "type" : "GatewaySynchronizationEndedEvent"
}{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
- "name" : "GatewaySynchronizationStartedEvent"
+ "type" : "GatewaySynchronizationStartedEvent"
}{
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"setupTriggerType" : 1,
"setupTriggerOID" : "a setup trigger OID",
- "name" : "SetupTriggerDeletedEvent"
+ "type" : "SetupTriggerDeletedEvent"
}Update a setup trigger activation mode-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
| Description | -The scheduling mode of a setup trigger could not be changed | +The scheduling mode of a setup trigger has changed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"setupTriggerType" : 1,
"setupTriggerOID" : "a setup trigger OID",
- "name" : "SetupTriggerModeChangeFailedEvent"
+ "newMode" : 1,
+ "type" : "SetupTriggerModeChangedEvent"
} |
|
| Setup trigger type | ||
| siteOID | +Site OID | +
| Description | -The scheduling mode of a setup trigger has changed | +The scheduling mode of a setup trigger could not be changed |
|---|---|---|
| JSON | {
- "timestamp" : 2,
- "owningPartners" : [ "some owning partners" ],
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
"setupOID" : "a setup OID",
+ "owningPartners" : [ "some owning partners" ],
"setupTriggerType" : 1,
"setupTriggerOID" : "a setup trigger OID",
- "newMode" : 1,
- "name" : "SetupTriggerModeChangedEvent"
+ "type" : "SetupTriggerModeChangeFailedEvent"
} |
|
| Setup trigger type | ||
| siteOID | +Site OID | +
Get a setup trigger status-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get all setup triggers
Per-session rate-limit : 1 calls per 1d period for this particular operation (bulk-load)-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
[ {
"ifThenSetupTrigger" : {
- "creationTime" : 1769503155434,
- "lastUpdateTime" : 1769503155434,
+ "creationTime" : 1785140822206,
+ "lastUpdateTime" : 1785140822207,
"label" : "an if then setup trigger label",
"serverSide" : true,
"mode" : 1,
@@ -101573,8 +107008,8 @@ Generated events on method call
"id" : "an id",
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155434,
- "lastUpdateTime" : 1769503155434,
+ "creationTime" : 1785140822207,
+ "lastUpdateTime" : 1785140822207,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : false,
@@ -101707,7 +107142,7 @@ Generated events on method call
Get all setup triggers of a given type
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
[ {
"ifThenSetupTrigger" : {
- "creationTime" : 1769503155434,
- "lastUpdateTime" : 1769503155434,
+ "creationTime" : 1785140822206,
+ "lastUpdateTime" : 1785140822207,
"label" : "an if then setup trigger label",
"serverSide" : true,
"mode" : 1,
@@ -101817,8 +107252,8 @@ Generated events on method call
"id" : "an id",
"actionGroupOID" : "an action group OID",
"localActionGroup" : {
- "creationTime" : 1769503155434,
- "lastUpdateTime" : 1769503155434,
+ "creationTime" : 1785140822207,
+ "lastUpdateTime" : 1785140822207,
"label" : "a managed action group label",
"metadata" : "some metadata",
"shortcut" : false,
@@ -102098,7 +107533,7 @@ Generated events on method call
Get all setup triggers status
- Access scope : Full enduser API access (enduser/*)
+ Access scope : enduser/*
> Test operation
Get trigger status.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Update trigger status.-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
{
- "timestamp" : 2,
+ "eventTime" : 2,
+ "siteOID" : "a site OID",
+ "setupOID" : "a setup OID",
"owningPartner" : "an owning partner",
"gatewayId" : "A gateway id (ex: 0101-1234-5678)",
"functionType" : 1,
"enabled" : false,
- "name" : "GatewayFunctionChangedEvent"
+ "type" : "GatewayFunctionChangedEvent"
}Get cities for given country code and postcode-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get country cities which names start by a given prefix without secondary zones-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get country cities which names start by a given prefix with options-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get postcode pattern for given country name or code-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*
Get server time and details for a given timezone-
Access scope : Full enduser API access (enduser/*)
Access scope : enduser/*