Difference between revisions of "Websockets Documentation"

From SecuriWiki
Jump to: navigation, search
(DynamicSceneUpdated)
 
(35 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Category:Almond+ 2014]]
 
[[Category:Almond+ 2014]]
 
[[Category:Almond 2015]]
 
[[Category:Almond 2015]]
Websocket is the protocol for establishing an interaction channel between an external application and Almond. It is also possible to receive event-based notifications. Websocket can be used to control [https://wiki.securifi.com/index.php/Devicelist_Documentation '''smart devices'''] that are paired with Almond and build smart applications around it.
+
[[Category:Almond 3]]
 
+
Websocket is the protocol for establishing an interaction channel between an external application and Almond. It is also possible to receive event-based notifications. Websocket can be used to control [https://wiki.securifi.com/index.php/Devicelist_Documentation '''smart devices'''] that are paired with Almond and build smart applications around it.
<b>Note: WebSocket API new Rules Commands are being updated according to the new firmware R089 and please [https://wiki.securifi.com/index.php/Changelog '''click here'''] to access the old Rules Commands which would work with the old firmware R085.</b>
+
  
 
== Authentication ==
 
== Authentication ==
Line 20: Line 19:
 
Command to get the list of sensors and other smart devices associated with the almond. <br />
 
Command to get the list of sensors and other smart devices associated with the almond. <br />
  
Request
+
Request
 
  {   
 
  {   
 
   "MobileInternalIndex":"<random key>",
 
   "MobileInternalIndex":"<random key>",
Line 26: Line 25:
 
  }
 
  }
  
Response
+
Response
 
  {   
 
  {   
 
   "MobileInternalIndex":"<random key>",
 
   "MobileInternalIndex":"<random key>",
 
   "CommandType":"DeviceList",
 
   "CommandType":"DeviceList",
  "Action":"addAll",
 
 
   "Devices":{   
 
   "Devices":{   
 
       "1":{   
 
       "1":{   
Line 36: Line 34:
 
                 "ID":"1",
 
                 "ID":"1",
 
                 "Name":"ContactSwitch #1",
 
                 "Name":"ContactSwitch #1",
                "AssociationTimestamp":"1462172879",
 
 
                 "Type":"12",
 
                 "Type":"12",
 +
                "FriendlyDeviceType":"ContactSwitch",
 
                 "Location":"Default",
 
                 "Location":"Default",
 
                 "LastActiveEpoch":"1462172879",  
 
                 "LastActiveEpoch":"1462172879",  
                "Manufacturer":"Sercomm Co",
+
                "Manufacturer":"Sercomm Corp.",
 
                 "Version":"16",
 
                 "Version":"16",
                 "Model":"Unknown"
+
                 "Model":"Unknown",
 +
                "DeviceState":"1"
 
         },
 
         },
 
         "DeviceValues":{   
 
         "DeviceValues":{   
 
             "1":{   
 
             "1":{   
 
               "Name":"STATE",
 
               "Name":"STATE",
               "Value":"true"
+
               "Value":"true",
 +
              "Type":"4"
 
             },
 
             },
 
             "2":{   
 
             "2":{   
 
               "Name":"LOW BATTERY",
 
               "Name":"LOW BATTERY",
               "Value":"0"
+
               "Value":"0",
 +
              "Type":"12"
 
             },
 
             },
 
             "3":{   
 
             "3":{   
 
               "Name":"TAMPER",
 
               "Name":"TAMPER",
               "Value":"true"
+
               "Value":"true",
 +
              "Type":"9"
 
             }
 
             }
 
         }
 
         }
Line 63: Line 65:
 
                 "ID":"2",
 
                 "ID":"2",
 
                 "Name":"BinarySwitch #2",
 
                 "Name":"BinarySwitch #2",
 +
                "Type":"1",
 
                 "FriendlyDeviceType":"BinarySwitch",
 
                 "FriendlyDeviceType":"BinarySwitch",
                 "Type":"1",
+
                 "Location":"Default",
                 "ID":"2",
+
                 "LastActiveEpoch":"1462175634",  
                 "Location":"Default"
+
                 "Manufacturer":"Sercomm Corp.",
 +
                "Version":"16",
 +
                "Model":"SZ-BSW01",
 +
                "DeviceState":"1"
 
         },
 
         },
 
         "DeviceValues":{   
 
         "DeviceValues":{   
 
             "1":{   
 
             "1":{   
 
               "Name":"SWITCH BINARY",
 
               "Name":"SWITCH BINARY",
               "Value":"true"
+
               "Value":"true",
 +
              "Type":"1"
 
             }
 
             }
 
         }
 
         }
Line 78: Line 85:
 
  }
 
  }
  
=== Setdeviceindex ===
+
=== Updatedeviceindex ===
Command to set the device index value without timeout.  <br />
+
  
Request
+
Request
+
  "mii":"<random key>",
+
  "cmd":"setdeviceindex",
+
  "devid":"<device id>",
+
  "index":"<deviceindex>",
+
  "value":"<indexvalue>"
+
}
+
 
+
Response<br />
+
Success<br />
+
{
+
  "mii":"<random key>","commandtype":"setdeviceindex","success":"true","data":{"devid":"<deviceid>","index":"<deviceindex>","value":"<indexvalue>"}
+
}<br />
+
Failure<br />
+
 
  {
 
  {
  "mii":"<random key>","commandtype":"setdeviceindex",:"success":"false"}
+
"MobileInternalIndex":"<random key>",
 +
"CommandType":"UpdateDeviceIndex",
 +
"ID":"<device id>",
 +
"Index":"<deviceindex>",
 +
"Value":"<indexvalue>"
 
  }
 
  }
<br />
+
Response<br />
Example<br />
+
  {
In the following example, the value of index 1 is set to ‘true’ for device id 2.<br />
+
  "MobileInternalIndex":"<random key>",
  {
+
  "CommandType":"UpdateDeviceIndex",
  "mii":"jdnbc",
+
  "Success":"true/false"
  "cmd":"setdeviceindex",
+
  "devid":"2",
+
  "index":"1",
+
  "value":"true",
+
 
  }
 
  }
Response <br />
 
{
 
  "mii":"jdnbc","commandtype":"setdeviceindex","success":"true","data":{"devid":"2","index":"1","value":"true"}
 
}<br />
 
 
 
===Getdeviceindex===
 
===Getdeviceindex===
Command to get the value of a device index.
+
Command to get the value of a device index.
Request
+
 +
Request
 
  {   
 
  {   
  "mii":"<random key>",
+
"MobileInternalIndex":"<random key>",
   "cmd":"getdeviceindex",
+
   "CommandType":"GetDeviceIndex",
   "devid":"<deviceid>",
+
   "ID":"<deviceid>",
   "index":"<deviceindex>"
+
   "Index":"<deviceindex>"
 
  }
 
  }
Response<br />
+
Response<br />
Success
+
  {
  {
+
  "MobileInternalIndex":"<random key>",
  "mii":"<random key>","commandtype":"getdeviceindex","success":"true","data":{"devid":"<deviceid>","index":"<deviceindex>","value":"<indexvalue>"}
+
  "CommandType":"GetDeviceIndex",
}
+
  "Success":"true/false",
Failure
+
  "Value":"<indexvalue>"
{
+
  "mii":"<random key>","commandtype":"getdeviceindex","success":"false"
+
}
+
Example
+
In the following example, value of index 1 is retrieved for device id 2.
+
{
+
  "mii":"jdnbc",
+
  "cmd":"getdeviceindex",
+
  "devid":"2",
+
  "index":"1"
+
}
+
Response
+
{
+
  "mii":"jdnbc","commandtype":"getdeviceindex","success":"true","data":{"devid":"2","index":"1","value":"false"}
+
 
  }
 
  }
  
===Editdevicename===
+
===UpdateDeviceName===
 
Command to edit name and location of a device.<br />
 
Command to edit name and location of a device.<br />
 
Request<br />
 
Request<br />
 
  {  
 
  {  
   "mii":"<random key>",
+
   "MobileInternalIndex":"<random key>",
   "cmd":"editdevicename",
+
   "CommandType":"UpdateDeviceName",
   "devid":"6",
+
   "ID":"6",
   "name":"newswitchsss",
+
   "Name":"newswitchsss",
   "location":"default"
+
   "Location":"default"
 
  }
 
  }
Response<br />
+
Response<br />
Success
+
 
  {   
 
  {   
  "mii":"<random key>","commandtype":"editdevicename","success":"true"
+
  "MobileInternalIndex":"<random key>",
}
+
  "CommandType":"UpdateDeviceName",
Failure
+
  "Success":"true/false"
+
  "mii":"<random key>","commandtype":"editdevicename","success":"false"
+
 
  }
 
  }
  
 
===Updatealmondmode===
 
===Updatealmondmode===
Command to change the almond mode.<br />
+
Command to change the almond mode.<br />
Request<br />
+
Request<br />
 
  {
 
  {
 
   "MobileInternalIndex":"<random key>",
 
   "MobileInternalIndex":"<random key>",
Line 174: Line 145:
 
   "EmailId":"<email id>"
 
   "EmailId":"<email id>"
 
  }
 
  }
Response<br />
+
Response<br />
 
  {   
 
  {   
 
   "MobileInternalIndex":"<random key>",
 
   "MobileInternalIndex":"<random key>",
Line 197: Line 168:
 
  {
 
  {
 
         "CommandType": "RuleList",
 
         "CommandType": "RuleList",
        "Action": "addAll",
 
 
         "Rules": {
 
         "Rules": {
 
                 "12": {
 
                 "12": {
Line 453: Line 423:
  
 
Response
 
Response
  {
+
  {
  "MobileInternalIndex":"<random key>",
+
        "CommandType": "ClientList",
  "CommandType":"ClientList",
+
        "MobileInternalIndex":"<random key same as request>",
  "Success":"true",
+
        "Success":"true",
  "Clients":
+
        "Clients": {
    {
+
              "1": {
      "ID":"1",
+
                        "ID":"1",
      "Name":"iphone_4s",
+
                        "Name": "64:bc:0c:80:62:46",
      "Connection":"wireless",
+
                        "Connection": "wired",
      "MAC":"other",
+
                        "MAC": "64:bc:0c:80:62:46",
      "Type":"other",
+
                        "Type": "other",
      "LastKnownIP":"10.2.2.11",
+
                        "LastKnownIP": "10.10.10.97",
      "Active":"false",
+
                        "Active": "false",
      "UseAsPresence":"true",
+
                        "UseAsPresence": "true",
      "LastActiveEpoch":"1433920922",
+
                        "Wait": "6",
      "Wait":"6"
+
                        "LastActiveEpoch": "1459845389",
    },
+
                        "RX": "0",
    {
+
                        "TX": "0",
      "ID":"2",
+
                        "Block": "0/1/2",
      "Name":"buildserver.lan",
+
                        "CanBlock":"true/false",
      "Connection":"wired",
+
                        "Category":"Kids/Others",
      "MAC":"d8:50:e6:54:1b:9c",
+
                        "Schedule": "0,0,0,0,0,0,0",
      "Type":"other",
+
                        "Manufacturer": "LG",
      "LastKnownIP":"10.10.10.1",
+
                        "RSSI": "0",
      "Active":"true",
+
                        "ForceInActive": "0"
      "UseAsPresence":"false",
+
                },
      "LastActiveEpoch":"1433920922",
+
                "2": {
      "Wait":"6"
+
                        "ID":"2",
    }
+
                        "Name": "64:bc:0c:80:62:46",
  ]
+
                        "Connection": "wired",
 +
                        "MAC": "64:bc:0c:80:62:46",
 +
                        "Type": "other",
 +
                        "LastKnownIP": "10.10.10.97",
 +
                        "Active": "false",
 +
                        "UseAsPresence": "true",
 +
                        "Wait": "6",
 +
                        "LastActiveEpoch": "1459845389",
 +
                        "RX": "0",
 +
                        "TX": "0",
 +
                        "Block": "0",
 +
                        "Schedule": "0,0,0,0,0,0,0",
 +
                        "Manufacturer": "LG",
 +
                        "RSSI": "0",
 +
                        "ForceInActive": "0"
 +
                }
 +
        }
 
  }
 
  }
  
Line 512: Line 498:
 
         other
 
         other
  
Use As Presence - true/false<br/>
+
Use as Presence - true/false<br/>
Request<br/>
+
Request<br/>
+
  "MobileInternalIndex":"<random key>",
+
  "CommandType":"UpdateClient",
+
  "Clients":{ 
+
    "ID":"2",
+
    "Name":"device1",
+
    "Connection":"wired",
+
    "MAC":"00:17:88:0a:04:41",
+
    "Type":"tv",
+
    "LastKnownIP":"10.2.2.11",
+
    "Active":"false",
+
    "UseAsPresence":"false",
+
    "Wait":"6"
+
 
+
  }
+
}
+
 
+
Response<br/>
+
Success
+
 
  {
 
  {
  "CommandType":"UpdateClient",
+
        "CommandType":"UpdateClient",
  "MobileInternalIndex":"324",
+
        "Clients":{
  "Success":"true",
+
          "ID": "1",
  "ReasonCode":"0"
+
          "Name": "device1",
 +
          "Connection": "wired",
 +
          "MAC": "1c:75:08:32:2a:6d",
 +
          "Type": "other",
 +
          "LastKnownIP": "10.2.2.11",
 +
          "Active": "false",
 +
          "UseAsPresence": "false",
 +
          "Wait":"6",
 +
          "Block":"0/1/2",
 +
          "Category":"Kids/Others"
 +
        },
 +
        "MobileInternalIndex":"324"
 
  }
 
  }
Faliure
+
Response<br/>
 
  {
 
  {
   "CommandType":"UpdateClient",
+
   "Success":"true/false",
 
   "MobileInternalIndex":"324",
 
   "MobileInternalIndex":"324",
  "Success":"false",
 
 
   "ReasonCode":"0"
 
   "ReasonCode":"0"
 
  }
 
  }
Line 564: Line 541:
 
   "MobileInternalIndex":"324",
 
   "MobileInternalIndex":"324",
 
   "Success":"true",
 
   "Success":"true",
   "ReasonCode":"0"  
+
   "Reason":"0"  
 
  }
 
  }
 
Failure
 
Failure
Line 571: Line 548:
 
   "MobileInternalIndex":"324",
 
   "MobileInternalIndex":"324",
 
   "Success":"false",
 
   "Success":"false",
   "ReasonCode":"0"
+
   "Reason":"0"
 
  }
 
  }
  
Line 597: Line 574:
 
  }
 
  }
 
<br/>
 
<br/>
 +
 
==ScenesCommands==
 
==ScenesCommands==
 
Note:mii(MobileInternalIndex) is a random key that is generated by the client and should be used for matching the received response to the corresponding request. Maximum string length of mii is 32 characters.
 
Note:mii(MobileInternalIndex) is a random key that is generated by the client and should be used for matching the received response to the corresponding request. Maximum string length of mii is 32 characters.
Line 604: Line 582:
 
Command to retrieve the list of existing Scenes.<br/>
 
Command to retrieve the list of existing Scenes.<br/>
 
Request
 
Request
  {  
+
  {
   "MobileInternalIndex":"<random key>",
+
   "CommandType":"DynamicSceneList",
   "CommandType":"DynamicSceneList"
+
   "MobileInternalIndex":"5432857"
 
  }
 
  }
 
 
Response<br/>
 
Response<br/>
 
Note: Active :- Indicates the state of Scene<br/>
 
Note: Active :- Indicates the state of Scene<br/>
  {
+
  {
  "MobileInternalIndex":"<random key>",
+
        "CommandType": "DynamicSceneList",
  "CommandType":"DynamicSceneList",
+
        "MobileInternalIndex":"<same as in request>",
  "Scenes":
+
        "Scenes": {
    {
+
                "1": {
      "ID":"1",
+
                        "ID":"1",
      "Name":"Scene1",
+
                        "Active": "true",
      "LastActiveEpoch":"1433740885",
+
                        "Name": "Scene1022",
      "Active":"false",
+
                        "LastActiveEpoch": "251176214925585",
      "SceneEntryList":[
+
                        "VoiceCompatible":"true",
        {
+
                        "SceneEntryList": [{
          "DeviceID":"2",
+
                                "ID": "2",
          "Index":"2",
+
                                "Index": "1",
          "Value":"true",
+
                                "Value": "false",
          "Valid":"false"
+
                                "Valid": "true"
        },
+
                        }, {
        {
+
                                "ID": "4",
          "DeviceID":"1",
+
                                "Index": "1",
          "Index":"2",
+
                                "Value": "78",
          "Value":"true",
+
                                "Valid": "true"
          "Valid":"false"
+
                        }]
 +
                }
 
         }
 
         }
      ]
 
    },
 
    { 
 
      "ID":"2",
 
      "Name":"Scene2",
 
      "LastActiveEpoch":"0",
 
      "Active":"false",
 
      "SceneEntryList":[ 
 
        { 
 
          "DeviceID":"6",
 
          "Index":"1",
 
          "Value":"true",
 
          "Valid":"false"
 
        },
 
        { 
 
          "DeviceID":"7",
 
          "Index":"1",
 
          "Value":"true",
 
          "Valid":"false"
 
        }
 
      ]
 
    }
 
  ]
 
 
  }
 
  }
 +
 
===AddScene===
 
===AddScene===
 
Command to add a new Scene.<br/>
 
Command to add a new Scene.<br/>
 
Request
 
Request
  {
+
  {
  "CommandType":"AddScene",
+
"CommandType": "AddScene",
  "MobileInternalIndex":"324",
+
"MobileInternalIndex": "324",
  "Scenes":{
+
"Scenes":{
    "Name":"My_created_scene",
+
"Name": "My_created_scene",
    "SceneEntryList":[
+
"SceneEntryList": [
      {  
+
  {
        "DeviceID":"1",
+
"ID": "1",
        "Index":"1",
+
"Index": "1",
        "Value":"false"
+
"Value": "false"
      },
+
},
      {  
+
  {
        "DeviceID":"2",
+
"ID": "2",
        "Index":"2",
+
"Index": "2",
        "Value":"false"
+
"Value": "false"
      }
+
}
    ]
+
]}
  }
+
  }
  }  
+
  
 
Response
 
Response
  {"CommandType":"AddScene","MobileInternalIndex":"324","Success":"true","Reason":"0"}
+
  {
 +
"CommandType":"AddScene",
 +
"MobileInternalIndex":"324",
 +
"ReasonCode":"0",
 +
"Success":"true"
 +
}
  
 
===UpdateScene===
 
===UpdateScene===
 
Command to update an existing Scene<br/>
 
Command to update an existing Scene<br/>
 
Request
 
Request
  {   
+
  {
  "CommandType":"UpdateScene",
+
  "MobileInternalIndex": 1667509461,
  "MobileInternalIndex":"324",
+
"Scenes": {
  "Scenes":{   
+
  "Name": "DADad222d",
    "ID":"15",
+
"ID": 1,
    "Name":"My_created_scene",
+
"SceneEntryList": [{
    "SceneEntryList":[
+
  "ID": 0,
      {   
+
"Value": "home",
        "DeviceID":"1",
+
"Index": 1
        "Index":"1",
+
}, {
        "Value":"false"
+
"ID": 2,
      },
+
"Value": "false",
      {   
+
"Index": 1
        "DeviceID":"2",
+
}, {
        "Index":"2",
+
  "ID": 2,
        "Value":"false"
+
"Value": "true",
      }
+
"Index": 2
    ]
+
}],
  }
+
"VoiceCompatible": false
 +
},"CommandType": "UpdateScene"
 
  }
 
  }
 
 
Response
 
Response
  {"CommandType":"UpdateScene","MobileInternalIndex":"324","Success":"true","Reason":"0"}
+
  {"MobileInternalIndex":"324",
 +
"ReasonCode":"0",
 +
"Success":"true"
 +
}
  
 
===ActivateScene===
 
===ActivateScene===
Line 750: Line 713:
 
==Notification and Event Updates==
 
==Notification and Event Updates==
  
===SensorUpdate===
+
===DynamicIndexUpdated===
When any index value is changed the following update will be received.<br/>
+
If any device index is changed, the following update will be received.  
{"commandtype":"SensorUpdate","data":{"<device id>":{"<index id>":{"index":"<index id>","name":"<index name>","value":"<index value>"}}}}
+
Example
+
{"commandtype":"SensorUpdate","data":{"25":{"3":{"index":"3","name":"TAMPER","value":"false"}}}}
+
  
===DeviceAdded===
+
  {
When a new device is added the following update will be received.
+
  "CommandType":"DynamicIndexUpdated",
  {"commandtype":"DeviceAdded","data":{"<device id>":{"devicename":"<device name>","friendlydevicetype":"<friendly device type name >","devicetype":"<device type id >","deviceid":"<device id >","location":"
+
  "Devices":{
  <location>","devicevalues":{"1":{"index":"<index num>","name":"<index name >","value":"<index val>"},"2":{"index":"<index num>","name":"<index name>","value":"<index val>"},"3":{"index":"<index num>","name":"<index
+
      "<device id>":{  
name>","value":"<index val>"}}}}}
+
        "DeviceValues":{
Example:
+
                "<index id>":{ 
{"commandtype":"DeviceAdded","data":{"27":{"devicename":"ContactSwitch #27","friendlydevicetype":"ContactSwitch","devicetype":"12","deviceid":"27","location":"Default","devicevalues":{"1":  
+
                    "Name":"<index name>",
{"index":"1","name":"STATE","value":"true"},"2":{"index":"2","name":"LOW BATTERY","value":"0"},"3":{"index":"3","name":"TAMPER","value":"true"}}}}}
+
                    "Value":"<index value>"
 +
                }
 +
        }
 +
      }
 +
  }
 +
}
 +
===DynamicDeviceAdded===
 +
Whenever a device is added, the follow update would be received.
 +
 +
 +
  "CommandType":"DynamicDeviceAdded",
 +
  "Devices":{  
 +
      "<device id>":{  
 +
        "Data":{
 +
                  "Name":"<device name>",
 +
                  "Type":"<device type id >",
 +
                  "FriendlyDeviceType":"<friendly device type>",
 +
                  "Location":"<location>",
 +
                  "LastActiveEpoch":"<time stamp>",  
 +
                  "Manufacturer":"<manufacturer name>",
 +
                  "Version":"<version number>",
 +
                  "Model":"<model>",
 +
                  "DeviceState":"<0/1/2>"
 +
                },
 +
        "DeviceValues":{
 +
            "1":{
 +
              "Name":"<index name >",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            },
 +
            "2":{
 +
              "Name":"<index name>",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            },
 +
            "3":{
 +
              "Name":"<index name>",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            }
 +
        }
 +
      }
 +
  }
 +
}
 +
===DynamicDeviceRemoved===
 +
Whenever a device is removed, the following update is received.
 +
 +
 +
  "CommandType":"DynamicDeviceRemoved",
 +
  "Action":"remove",
 +
  "Devices":{
 +
  "25":{
 +
    "Type":"<device type id >"}
 +
  }
 +
}
  
===DeviceRemoved===
+
===DynamicAllDevicesRemoved===
When a device is removed the following update will be received
+
{"commandtype":"DeviceRemoved","data":{"<device id>":{"devtype":"<device type>"}}}
+
Example
+
{"commandtype":"DeviceRemoved","data":{"25":{"devtype":"12"}}}
+
  
===DeviceRemoveAll===
+
Whenever all the devices are removed, the follow update is received.  
When all the devices are removed the following update will be received.
+
{"commandtype":"DeviceRemoveAll"}
+
  
===DeviceUpdated===
+
 
 +
 +
  "CommandType":"DynamicAllDevicesRemoved"
 +
}
 +
 
 +
===DynamicDeviceUpdated===
 
If any device type or index are changed the following update will be received.
 
If any device type or index are changed the following update will be received.
  {"commandtype":"DeviceUpdated","data":{"<device id>":{"devicename":"<device name>","friendlydevicetype":"<friendly device type name >","devicetype":"<device type id >","deviceid":"<device id >","location":"
+
 
  <location>","devicevalues":{"1":{"index":"<index num>","name":"<index name >","value":"<index val>"},"2":{"index":"<index num>","name":"<index name>","value":"<index val>"},"3":{"index":"<index num>","name":"<index
+
  {
  name>","value":"<index val>"}}}}}
+
  "CommandType":"DynamicDeviceUpdated",
Example
+
  "Devices":{
{"commandtype":"DeviceUpdated","data":{"27":{"devicename":"ContactSwitch #27","friendlydevicetype":"ContactSwitch","devicetype":"12","deviceid":"27","location":"Default","devicevalues":{"1":
+
      "<device id>":{
{"index":"1","name":"STATE","value":"true"},"2":{"index":"2","name":"LOW BATTERY","value":"0"},"3":{"index":"3","name":"TAMPER","value":"true"}}}}}
+
        "Data":{
 +
                "Name":"<device name>",
 +
                "Type":"<device type id >",
 +
                "FriendlyDeviceType":"<friendly device type>",
 +
                "Location":"<location>",
 +
                "LastActiveEpoch":"<time stamp>",  
 +
                "Manufacturer":"<manufacturer name>",
 +
                "Version":"<version number>",
 +
                "Model":"<model>",
 +
                "DeviceState":"<0/1/2>"
 +
              },
 +
        "DeviceValues":
 +
            "1":{
 +
              "Name":"<index name >",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            },
 +
            "2":{
 +
              "Name":"<index name>",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            },
 +
            "3":{
 +
              "Name":"<index name>",
 +
              "Value":"<index val>",
 +
              "Type":"<index type>"
 +
            }
 +
        }
 +
        }
 +
  }
 +
}
  
 
===DynamicRuleAdded===
 
===DynamicRuleAdded===
Line 789: Line 832:
  
 
  {
 
  {
         ""CommandType"": ""DynamicRuleAdded"",
+
         "CommandType": "DynamicRuleAdded",
         ""Action"": ""add"",
+
         "Rules": {
        ""Rules"": {
+
                 "12": {
                 ""12"": {
+
                         "Name": "mynewrule",
                         ""Name"": ""mynewrule"",
+
                         "Valid": "true",
                         ""Valid"": ""true"",
+
                         "ID":"12",
                         ""ID"":""12"",
+
                         "Triggers": [{
                         ""Triggers"": [{
+
                                 "Type": "<type of trigger>",
                                 ""Type"": ""<type of trigger>"",
+
                                 "ID": "<device id>",
                                 ""ID"": ""<device id>"",
+
                                 "Index": "<device index>",
                                 ""Index"": ""<device index>"",
+
                                 "Value": "<index value>",
                                 ""Value"": ""<index value>"",
+
                                 "Grouping": "< AND/OR>",
                                 ""Grouping"": ""< AND/OR>"",
+
                                 "Condition": "<condition typet>",
                                 ""Condition"": ""<condition typet>"",
+
                                 "Duration": "<time in sec>",
                                 ""Duration"": ""<time in sec>"",
+
                                 "Valid": "true"
                                 ""Valid"": ""true""
+
 
                         }],
 
                         }],
                         ""Results"": [{
+
                         "Results": [{
                                 ""Type"": ""<type of result>"",
+
                                 "Type": "<type of result>",
                                 ""ID"": ""<device id>"",
+
                                 "ID": "<device id>",
                                 ""Index"": ""<device index>"",
+
                                 "Index": "<device index>",
                                 ""Value"": ""<index value>"",
+
                                 "Value": "<index value>",
                                 ""PreDelay"": ""<time in sec>"",
+
                                 "PreDelay": "<time in sec>",
                                 ""Valid"": ""true""
+
                                 "Valid": "true"
 
                         }, {
 
                         }, {
                                 ""Type"": ""<type of result>"",
+
                                 "Type": "<type of result>",
                                 ""ID"": ""<event id>"",
+
                                 "ID": "<event id>",
                                 ""EventType"": ""<event type>"",
+
                                 "EventType": "<event type>",
                                 ""Value"": ""<event value>"",
+
                                 "Value": "<event value>",
                                 ""PreDelay"": ""<time in sec>"",
+
                                 "PreDelay": "<time in sec>",
                                 ""Valid"": ""true""
+
                                 "Valid": "true"
      }]
+
                        }]
    }
+
                }
  }
+
        }
 
  }
 
  }
  
Line 831: Line 873:
 
When an existing rule is modified the following update is received.
 
When an existing rule is modified the following update is received.
 
  {
 
  {
  "CommandType": "DynamicRuleUpdated",
+
        "CommandType": "DynamicRuleUpdated",
  "Rules": {
+
        "Rules": {
  "ID": "1",
+
                "12": {
  "Name": "123",
+
                      "ID":"12",
  "Valid": "1",
+
                        "Name": "mynewrule",
  "Triggers": [{
+
                        "Valid": "true",
  "Type": "EventTrigger",
+
                        "Triggers": [{
  "EventType": "AlmondModeUpdated",
+
                                "Type": "<type of trigger>",
  "ID": "1",
+
                                "ID": "<device id>",
  "Grouping": "AND",
+
                                "Index": "<device index>",
  "Condition": "eq",
+
                                "Value": "<index value>",
  "Validation": "true",
+
                                "Grouping": "< AND/OR>",
  "Value": "home"
+
                                "Condition": "<condition type ie.eq/le/ge/lt/gt>",
}, {
+
                                "Duration": "<time in sec>",
  "Type": "DeviceTrigger",
+
                                "Valid": "true"
  "ID": "2",
+
                        }],
  "Index": "1",
+
                        "Results": [{
  "Grouping": "AND",
+
                                "Type": "<type of result>",
  "Validation": "true",
+
                                "ID": "<device id>",
  "Condition": "eq",
+
                                "Index": "<device index>",
  "Value": "false"
+
                                "Value": "<index value>",
}],
+
                                "PreDelay": "<time in sec>"
  "Results": [{
+
                        }, {
  "Type": "DeviceResult",
+
                                "Type": "<type of result>",
  "ID": "2",
+
                                "ID": "<event id>",
  "Index": "1",
+
                                "EventType": "<event type>",
  "PreDelay": "0",
+
                                "Value": "<event value>",
  "Validation": "true",
+
                                "PreDelay": "<time in sec>"
  "Value": "false"
+
                        }]
}, {
+
                }
  "Type": "EventResult",
+
        }
  "EventType": "AlmondModeUpdated",
+
  "ID": "1",
+
  "PreDelay": "0",
+
  "Validation": "true",
+
  "Value": "away"
+
}]
+
 
  }
 
  }
}
 
 
 
<br/>
 
<br/>
  
Line 878: Line 912:
 
   
 
   
 
  {
 
  {
         ""CommandType"": ""DynamicRuleRemoved"",
+
         "CommandType": "DynamicRuleRemoved",
         ""Action"": ""remove"",
+
         "Action": "remove",
         ""Rules"": {
+
         "Rules": {
                 ""1"": {}
+
                 "1": {}
 
         }
 
         }
 
  }
 
  }
Line 890: Line 924:
 
When all rules are removed the following update is received.  
 
When all rules are removed the following update is received.  
  
  {"CommandType":"DynamicAllRulesRemoved","Action":"removeAll"}
+
  {"CommandType":"DynamicAllRulesRemoved"}
  
 
<br/>
 
<br/>
  
===AlmondModeUpdated===
+
===DynamicAlmondModeUpdated===
  {"commandtype":"AlmondModeUpdated","data":{"<almond mode >":{"emailid":"<email id>"}}}
+
  {
Example
+
  "CommandType":"DymanicAlmondModeUpdated",
  {"commandtype":"AlmondModeUpdated","data":{"2":{"emailid":"swetha.reddy@securifi.com"}}}
+
  "Mode":"<mode i.e.  2/3>",
 +
  "EmailId":"<email id>"
 +
  }
  
 
===DynamicClientAdded===
 
===DynamicClientAdded===
When a new client is added this update is received.
+
When a new client is added the following update is received.
  {
+
 
  "CommandType":"DynamicClientAdded",
+
  {
  "Clients":{
+
        "CommandType": "DynamicClientAdded",
    "ID":"1",
+
        "Clients": {
    "Name":"my phone",
+
                "1": {
    "Connection":"wired",
+
                        "ID":"1",
    "MAC":"c4:43:6d:c9:ef:05",
+
                        "Name": "64:bc:0c:80:62:46",
    "Type":"tv",
+
                        "Connection": "wired",
    "LastKnownIP":"10.10.10.55",
+
                        "MAC": "64:bc:0c:80:62:46",
    "Active":"false",
+
                        "Type": "other",
    "UseAsPresence":"true",
+
                        "LastKnownIP": "10.10.10.97",
    "Wait":"6"
+
                        "Active": "false",
  }
+
                        "UseAsPresence": "true",
 +
                        "Wait": "6",
 +
                        "LastActiveEpoch": "1459845389",
 +
                        "RX": "0",
 +
                        "TX": "0",
 +
                        "Block": "0/1/2",
 +
                        "CanBlock":"true/false",
 +
                        "Category":"Kids/Others",
 +
                        "Schedule": "0,0,0,0,0,0,0",
 +
                        "Manufacturer": "LG",
 +
                        "RSSI": "0",
 +
                        "ForceInActive": "0"
 +
                }
 +
        }
 
  }
 
  }
  
 
===DynamicClientJoined===
 
===DynamicClientJoined===
When a client joined network this update is received.
+
When a client joined network the following update is received.
  {
+
  {
  "CommandType":"DynamicClientJoined",
+
        "CommandType": "DynamicClientJoined",
  "Clients":{
+
        "Clients": {
    "ID":"1",
+
                "1": {
    "Name":"my phone",
+
                        "ID":"1",
    "Connection":"wired",
+
                        "Name": "64:bc:0c:80:62:46",
    "MAC":"c4:43:6d:c9:ef:05",
+
                        "Connection": "wired",
    "Type":"tv",
+
                        "MAC": "64:bc:0c:80:62:46",
    "LastKnownIP":"10.10.10.55",
+
                        "Type": "other",
    "Active":"false",
+
                        "LastKnownIP": "10.10.10.97",
    "UseAsPresence":"true",
+
                        "Active": "true",
    "Wait":"6"
+
                        "UseAsPresence": "true",
  }
+
                        "Wait": "6",
}  
+
                        "LastActiveEpoch": "1459845389",
 
+
                        "RX": "0",
 +
                        "TX": "0",
 +
                        "Block": "0/1/2",
 +
                        "CanBlock":"true/false",
 +
                        "Category":"Kids/Others",
 +
                        "Schedule": "0,0,0,0,0,0,0",
 +
                        "Manufacturer": "LG",
 +
                        "RSSI": "0",
 +
                        "ForceInActive": "0"
 +
                }
 +
        }
 +
}
  
 
===DynamicClientLeft===
 
===DynamicClientLeft===
When a client leaves the network, following update is received.
+
When a client leaves the network, following update is received.
  {
+
 
  "CommandType":"DynamicClientLeft",
+
  {
  "Clients":{
+
        "CommandType": "DynamicClientLeft",
    "ID":"1",
+
        "Clients": {
    "Name":"my phone",
+
                "1": {
    "Connection":"wired",
+
                        "ID":"1",
    "MAC":"c4:43:6d:c9:ef:05",
+
                        "Name": "64:bc:0c:80:62:46",
    "Type":"tv",
+
                        "Connection": "wired",
    "LastKnownIP":"10.10.10.55",
+
                        "MAC": "64:bc:0c:80:62:46",
    "Active":"false",
+
                        "Type": "other",
    "UseAsPresence":"true",
+
                        "LastKnownIP": "10.10.10.97",
    "Wait":"6"
+
                        "Active": "false",
  }
+
                        "UseAsPresence": "true",
 +
                        "Wait": "6",
 +
                        "LastActiveEpoch": "1459845389",
 +
                        "RX": "0",
 +
                        "TX": "0",
 +
                        "Block": "0/1/2",
 +
                        "CanBlock":"true/false",
 +
                        "Category":"Kids/Others",
 +
                        "Schedule": "0,0,0,0,0,0,0",
 +
                        "Manufacturer": "LG",
 +
                        "RSSI": "0",
 +
                        "ForceInActive": "0"
 +
                }
 +
        }
 
  }
 
  }
  
 
===DynamicClientUpdated===
 
===DynamicClientUpdated===
When a name change or any changes done to a client this update is received.
+
When a name change or any changes done to a client the following update is received.
  
  {
+
  {
  "CommandType":"DynamicClientUpdated",
+
        "CommandType": "DynamicClientUpdated",
  "Clients":{
+
        "Clients": {
    "ID":"1",
+
                "1": {
    "Name":"my phone",
+
                        "ID":"1",
    "Connection":"wired",
+
                        "Name": "64:bc:0c:80:62:46",
    "MAC":"c4:43:6d:c9:ef:05",
+
                        "Connection": "wired",
    "Type":"tv",
+
                        "MAC": "64:bc:0c:80:62:46",
    "LastKnownIP":"10.10.10.55",
+
                        "Type": "other",
    "Active":"false",
+
                        "LastKnownIP": "10.10.10.97",
    "UseAsPresence":"true",
+
                        "Active": "false",
    "Wait":"6"
+
                        "UseAsPresence": "true",
  }
+
                        "Wait": "6",
 +
                        "LastActiveEpoch": "1459845389",
 +
                        "RX": "0",
 +
                        "TX": "0",
 +
                        "Block": "0/1/2",
 +
                        "CanBlock":"true/false",
 +
                        "Category":"Kids/Others",
 +
                        "Schedule": "0,0,0,0,0,0,0",
 +
                        "Manufacturer": "LG",
 +
                        "RSSI": "0",
 +
                        "ForceInActive": "0"
 +
                }
 +
        }
 
  }
 
  }
  
 
===DynamicClientRemoved===
 
===DynamicClientRemoved===
When a client is removed this update is received
+
When a client is removed this update is received
  {"CommandType":"DynamicClientRemoved","ID":"1","MAC":"c4:43:6d:c9:ef:05"}
+
 
 +
  {
 +
        "CommandType": "DynamicClientRemoved",
 +
        "Action": "remove",
 +
        "Clients": {
 +
                "1":{
 +
                        "MAC": "1c:75:08:32:2a:6d"
 +
                      }
 +
        }
 +
}
  
 
===DynamicAllClientsRemoved===
 
===DynamicAllClientsRemoved===
When all the clients are removed this update is received
+
When all the clients are removed this update is received
  {"CommandType":"DynamicAllClientsRemoved"}
+
 +
  {
 +
"CommandType":"DynamicAllClientsRemoved"
 +
}
  
 
===DynamicSceneAdded===
 
===DynamicSceneAdded===
Line 981: Line 1,078:
 
  {
 
  {
 
         "CommandType": "DynamicSceneAdded",
 
         "CommandType": "DynamicSceneAdded",
        "Action": "add",
 
 
         "Scenes": {
 
         "Scenes": {
 
                 "1": {
 
                 "1": {
Line 988: Line 1,084:
 
                         "Name": "Scene1022",
 
                         "Name": "Scene1022",
 
                         "LastActiveEpoch": "251176214925585",
 
                         "LastActiveEpoch": "251176214925585",
 +
                        "VoiceCompatible":"true",
 
                         "SceneEntryList": [{
 
                         "SceneEntryList": [{
 
                                 "ID": "1",
 
                                 "ID": "1",
Line 1,007: Line 1,104:
 
  {
 
  {
 
         "CommandType": "DynamicSceneUpdated",
 
         "CommandType": "DynamicSceneUpdated",
        "Action": "update",
 
 
         "Scenes": {
 
         "Scenes": {
 
                 "1": {
 
                 "1": {
Line 1,014: Line 1,110:
 
                         "Name": "Scene1022",
 
                         "Name": "Scene1022",
 
                         "LastActiveEpoch": "251176214925585",
 
                         "LastActiveEpoch": "251176214925585",
 +
                        "VoiceCompatible":"true",
 
                         "SceneEntryList": [{
 
                         "SceneEntryList": [{
 
                                 "ID": "1",
 
                                 "ID": "1",
Line 1,030: Line 1,127:
  
 
===DynamicSceneActivated===
 
===DynamicSceneActivated===
when any scene is activated this update is received.
+
When any scene is activated the following update is received.
  {  
+
   
  "CommandType":"DynamicSceneActivated",
+
  {
  "Scenes":
+
        "CommandType": "DynamicSceneActivated",
    "ID":"1",
+
        "Action": "update",
    "LastActiveEpoch":"8295685751190847488",
+
        "Scenes": {
    "Active":"true",
+
                "1": {
} }
+
                        "Active": "true",
 +
                        "LastActiveEpoch": "251176214925585"
 +
                }
 +
        }
 +
}
  
 
===DynamicSceneRemoved===
 
===DynamicSceneRemoved===
when any scene is removed this update is received.
+
When any scene is removed the following update is received.
  {
+
  {
  "CommandType":"DynamicSceneRemoved",
+
        "CommandType": "DynamicSceneRemoved",
  "Scenes":
+
        "Action": "remove",
    "ID":"1"
+
        "Scenes": {
  }
+
                "1": {}
 +
        }
 
  }
 
  }
  
 
===DynamicAllScenesRemoved===
 
===DynamicAllScenesRemoved===
when all scenes are removed this update is received.
+
When all scenes are removed the following update is received.
  {"CommandType":"DynamicAllScenesRemoved"}
+
 
 +
  {
 +
        "CommandType": "DynamicAllScenesRemoved"
 +
}

Latest revision as of 14:52, 1 April 2019

Websocket is the protocol for establishing an interaction channel between an external application and Almond. It is also possible to receive event-based notifications. Websocket can be used to control smart devices that are paired with Almond and build smart applications around it.

Authentication

In order to connect to the webserver - first specify a web-interface url, then the portid - 7681 followed by web-interface login password.

<webinterfaceUrl>:<portid>/<Login>/<password>

Example ws://10.10.10.254:7681/root/frank

Device Commands

Note: mii is a random key that is generated by the client and should be used for matching the received response to the corresponding request.
Maximum string length of mii is 32 characters. A unique mii should be used for each request

Devicelist

Command to get the list of sensors and other smart devices associated with the almond.

Request
{  
 "MobileInternalIndex":"<random key>",
 "CommandType":"DeviceList"
}
Response
{  
  "MobileInternalIndex":"<random key>",
  "CommandType":"DeviceList",
  "Devices":{  
     "1":{  
       "Data":{ 
               "ID":"1",
               "Name":"ContactSwitch #1",
               "Type":"12",
               "FriendlyDeviceType":"ContactSwitch",
               "Location":"Default",
               "LastActiveEpoch":"1462172879", 
               "Manufacturer":"Sercomm Corp.",
               "Version":"16",
               "Model":"Unknown",
               "DeviceState":"1"
       },
        "DeviceValues":{  
           "1":{  
              "Name":"STATE",
              "Value":"true",
              "Type":"4"
           },
           "2":{  
              "Name":"LOW BATTERY",
              "Value":"0",
              "Type":"12"
           },
           "3":{  
              "Name":"TAMPER",
              "Value":"true",
              "Type":"9"
           }
        }
     },
     "2":{ 
       "Data":{  
                "ID":"2",
                "Name":"BinarySwitch #2",
                "Type":"1",
                "FriendlyDeviceType":"BinarySwitch",
                "Location":"Default",
                "LastActiveEpoch":"1462175634", 
                "Manufacturer":"Sercomm Corp.",
                "Version":"16",
                "Model":"SZ-BSW01",
                "DeviceState":"1"
        },
        "DeviceValues":{  
           "1":{  
              "Name":"SWITCH BINARY",
              "Value":"true",
              "Type":"1"
           }
        }
     }
  }
}

Updatedeviceindex

Request
{
"MobileInternalIndex":"<random key>",
"CommandType":"UpdateDeviceIndex",
"ID":"<device id>",
"Index":"<deviceindex>",
"Value":"<indexvalue>"
}
Response
{ "MobileInternalIndex":"<random key>", "CommandType":"UpdateDeviceIndex", "Success":"true/false" }

Getdeviceindex

Command to get the value of a device index.

Request
{  
"MobileInternalIndex":"<random key>",
 "CommandType":"GetDeviceIndex",
 "ID":"<deviceid>",
 "Index":"<deviceindex>"
}
Response
{ "MobileInternalIndex":"<random key>", "CommandType":"GetDeviceIndex", "Success":"true/false", "Value":"<indexvalue>" }

UpdateDeviceName

Command to edit name and location of a device.
Request

{ 
 "MobileInternalIndex":"<random key>",
 "CommandType":"UpdateDeviceName",
 "ID":"6",
 "Name":"newswitchsss",
 "Location":"default"
}
Response
{ "MobileInternalIndex":"<random key>", "CommandType":"UpdateDeviceName", "Success":"true/false" }

Updatealmondmode

Command to change the almond mode.
Request
{ "MobileInternalIndex":"<random key>", "CommandType":"UpdateAlmondMode", "Mode":"<mode i.e. 2/3>", "EmailId":"<email id>" } Response
{ "MobileInternalIndex":"<random key>", "CommandType":"UpdateAlmondMode", "Success":"true/false" }


Rules Commands

Note: mii is a random key that is generated by the client and should be used for matching the received response to the corresponding request. Maximum string length of mii is 32 characters. A unique mii should be used for each request.

Ruleslist

Command to get the list of existing rules.

Request:

{
 "CommandType":"RuleList",
  "MobileInternalIndex":"111"
}


Response:

{
       "CommandType": "RuleList",
       "Rules": {
               "12": {
                       "Name": "mynewrule",
                       "Valid": "true",
                       "ID":"12",
                       "Triggers": [{
                               "Type": "<type of trigger>",
                               "ID": "<device id>",
                               "Index": "<device index>",
                               "Value": "<index value>",
                               "Grouping": "< AND/OR>",
                               "Condition": "<condition type ie.eq/le/ge/lt/gt>",
                               "Duration": "


Addrule

Command to create a new rule.
Request

{
   "MobileInternalIndex": "111",
   "CommandType": "AddRule",
   "Name": "rule",      
    "Valid":"true",
   "Triggers": [
       {
           "Type": "<type of trigger>",
           "ID": "<device id>",
           "Index": "<device index>",
           "Value": "<index value>",
           "Grouping": "< AND/OR>",
           "Condition": "<condition type ie.eq/le/ge/lt/gt>",
           "Duration": "<time in sec>",
           "Valid": "true"
       },
       {
           "Type": "<type of trigger>",
           "ID": "<event id>",
           "EventType": "<event type>",
           "value": "<event value>",
           "Grouping": "<AND/OR>",
           "Condition": "<condition type ie.eq/le/ge/lt/gt>",
           "Duration": "<time in sec>",
           "Valid": "true"
       }
   ],
   "Results": [
       {
           "Type": "<type of result>",
           "ID": "<device id>",
           "Index": "<device index>",
           "Value": "<index value>",
           "PreDelay": "<time in sec>",
           "Valid": "true"
       },
       {
           "Type": "<type of result>",
           "ID": "<event id>",
           "EventType": "<event type>",
           "Value": "<event value>",
           "PreDelay": "<time in sec>",
           "Valid": "true"
  }
 ]
}

Response

{  
   "CommandType":"AddRule",
   "Success":"true",
   "MobileInternalIndex":"111",
   "ReasonCode":"1"
}


Updaterule

Command to update an existing rule.
Request

{
   "MobileInternalIndex": "111",
   "CommandType": "UpdateRule",
   "Name": "ruleNAME",       
   "Valid":"true",
   "ID": "2",
   "Triggers": [
       {
           "Type": "<type of trigger>",
           "ID": "<device id>",
           "Index": "<device index>",
           "Value": "<index value>",
           "Grouping": "< AND/OR>",
           "Condition": "<condition type ie.eq/le/ge/lt/gt>",
           "Duration": "<time in sec>",
            "Valid":"true"
       },
       {
           "Type": "<type of trigger>",
           "ID": "<event id>",
           "EventType": "<event type>",
           "Value": "<event value>",
           "Grouping": "<AND/OR>",
           "Condition": "<condition type ie.eq/le/ge/lt/gt>",
           "Duration": "<time in sec>",
            "Valid":"true"
       }
   ],
   "Results": [
       {
           "Type": "<type of result>",
           "ID": "<device id>",
           "Index": "<device index>",
           "Value": "<index value>",
           "PreDelay": "<time in sec>"
       },
       {
           "Type": "<type of result>",
           "ID": "<event id>",
           "EventType": "<event type>",
           "Value": "<event value>",
           "PreDelay": "<time in sec>"
       }
   ]
}


Response

{  
   "CommandType":"UpdateRule",
   "Success":"true",
   "MobileInternalIndex":"111",
   "ReasonCode":"1"
}


Removerule

Command to remove an existing rule.
Request

{
 "CommandType": "RemoveRule",
 "Rules": {
 "ID": "1"
},
 "MobileInternalIndex": "111"
}


Response

{
 "CommandType":"RemoveRule",
 "Success":"true",
 "MobileInternalIndex":"111",
 "ReasonCode":"0"
}



Removeallrules

Command to remove all rules.
Request

{
 "CommandType":"RemoveAllRules",
 "MobileInternalIndex":"111"
}


Response

{
 "CommandType":"RemoveAllRules",
 "Success":"true",
 "MobileInternalIndex":"111",
 "ReasonCode":"0"

}


Validaterule

Command to validate an existing rule.
Request

{
 "CommandType":"ValidateRule",
 "ID":"1",
 "Value":"true"
 "MobileInternalIndex":"111"
}


Response

{
 "CommandType":"ValidateRule",
 "MobileInternalIndex":"111",
 "ReasonCode":"0",
 "Success":"false",
 "Data":{
 "Value":"true",
 "ID":"1"
}
}



ClientList

Command to get clientlist.
Request

{  
 "MobileInternalIndex":"<random key>",
 "CommandType":"ClientList"
}

Response

{
       "CommandType": "ClientList",
       "MobileInternalIndex":"<random key same as request>",
       "Success":"true",
       "Clients": {
              "1": {
                       "ID":"1",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "false",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0/1/2",
                       "CanBlock":"true/false",
                       "Category":"Kids/Others",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               },
               "2": {
                       "ID":"2",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "false",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               }
       }
}

Note - Success Tag in response:
If the Almond is in AP mode or Range Extender mode then Success tag will be set to ‘false’.

UpdateClient

Command to Update the data of a client.
ID - Clientid
Name - name of the client
Connection - wired/wireless

Type - pc
       laptop
       tablet  
       smartphone
       ipod
       ipad
       iphone
       mac
       printer
       router_switch
       hub
       tv
       chromecast
       appleTV
       android_stick
       camera
       nest
       other
Use as Presence - true/false
Request
{ "CommandType":"UpdateClient", "Clients":{ "ID": "1", "Name": "device1", "Connection": "wired", "MAC": "1c:75:08:32:2a:6d", "Type": "other", "LastKnownIP": "10.2.2.11", "Active": "false", "UseAsPresence": "false", "Wait":"6", "Block":"0/1/2", "Category":"Kids/Others" }, "MobileInternalIndex":"324" } Response
{ "Success":"true/false", "MobileInternalIndex":"324", "ReasonCode":"0" }

Remove client

command to remove a client.
Request

{  
 "MobileInternalIndex":"<random key>",
 "CommandType":"RemoveClient",
 "Clients":{  
   "ID":"1",
   "MAC":"1c:75:08:32:2a:6d"
 }
}

Response
Success

{
 "CommandType":"RemoveClient", 
 "MobileInternalIndex":"324",
 "Success":"true",
 "Reason":"0" 
}

Failure

{
 "CommandType":"RemoveClient",
 "MobileInternalIndex":"324",
 "Success":"false",
 "Reason":"0"
}

Removeallclients

Command to remove all clients
Request

{  
 "MobileInternalIndex":"<random key>",
 "CommandType":"RemoveAllClients",
}

Response
Success

{
 "CommandType":"RemoveAllClients",
 "MobileInternalIndex":"324",
 "Success":"true",
 "ReasonCode":"0"
}

Failure

{
 "CommandType":"RemoveAllClients",
 "MobileInternalIndex":"324",
 "Success":"false",
 "ReasonCode":"0"
}


ScenesCommands

Note:mii(MobileInternalIndex) is a random key that is generated by the client and should be used for matching the received response to the corresponding request. Maximum string length of mii is 32 characters. A unique mii should be used for each request

SceneList

Command to retrieve the list of existing Scenes.
Request

{
 "CommandType":"DynamicSceneList",
 "MobileInternalIndex":"5432857"
}

Response
Note: Active :- Indicates the state of Scene

{
       "CommandType": "DynamicSceneList",
       "MobileInternalIndex":"<same as in request>",
       "Scenes": {
               "1": {
                       "ID":"1",
                       "Active": "true",
                       "Name": "Scene1022",
                       "LastActiveEpoch": "251176214925585",
                       "VoiceCompatible":"true",
                       "SceneEntryList": [{
                               "ID": "2",
                               "Index": "1",
                               "Value": "false",
                               "Valid": "true"
                       }, {
                               "ID": "4",
                               "Index": "1",
                               "Value": "78",
                               "Valid": "true"
                       }]
               }
       }
}

AddScene

Command to add a new Scene.
Request

{
"CommandType": "AddScene",
"MobileInternalIndex": "324",
"Scenes":{
"Name": "My_created_scene",
"SceneEntryList": [
{
"ID": "1",
"Index": "1",
"Value": "false"
},
{
"ID": "2",
"Index": "2",
"Value": "false"
}
]}
}

Response

{
"CommandType":"AddScene",
"MobileInternalIndex":"324",
"ReasonCode":"0",
"Success":"true"
}

UpdateScene

Command to update an existing Scene
Request

{
"MobileInternalIndex": 1667509461,
"Scenes": {
"Name": "DADad222d",
"ID": 1,
"SceneEntryList": [{
"ID": 0,
"Value": "home",
"Index": 1
}, {
"ID": 2,
"Value": "false",
"Index": 1
}, {
"ID": 2,
"Value": "true",
"Index": 2
}],
"VoiceCompatible": false
},"CommandType": "UpdateScene"
}

Response

{"MobileInternalIndex":"324",
"ReasonCode":"0",
"Success":"true"
}

ActivateScene

Command to activate a Scene
Request

{  
 "CommandType":"ActivateScene",
 "MobileInternalIndex":"324",
 "Scenes":{  
   "ID":"11"
 }
}

Response

{"CommandType":"ActivateScene","MobileInternalIndex":"324","Success":"true","Reason":"0"}


RemoveScene

Command to remove a Scene
Request

{  
 "CommandType":"RemoveScene",
 "MobileInternalIndex":"324",
 "Scenes":{  
   "ID":"11"
 }
}

Response

{"CommandType":"RemoveScene","MobileInternalIndex":"324","Success":"true","Reason":"0"} 

RemoveAllScenes

Command to remove all Scenes
Request

{  
 "CommandType":"RemoveAllScenes",
 "MobileInternalIndex":"324"
}

Response

{"CommandType":"RemoveAllScenes","MobileInternalIndex":"324","Success":"true","Reason":"0"}

Notification and Event Updates

DynamicIndexUpdated

If any device index is changed, the following update will be received.

{  
  "CommandType":"DynamicIndexUpdated",
  "Devices":{  
     "<device id>":{ 
       "DeviceValues":{ 
                "<index id>":{  
                   "Name":"<index name>",
                   "Value":"<index value>"
                }
       }
     }
  }
}

DynamicDeviceAdded

Whenever a device is added, the follow update would be received. 

{  
  "CommandType":"DynamicDeviceAdded",
  "Devices":{  
     "<device id>":{ 
        "Data":{
                 "Name":"<device name>",
                 "Type":"<device type id >",
                 "FriendlyDeviceType":"<friendly device type>",
                 "Location":"<location>",
                 "LastActiveEpoch":"<time stamp>", 
                 "Manufacturer":"<manufacturer name>",
                 "Version":"<version number>",
                 "Model":"<model>",
                 "DeviceState":"<0/1/2>"
               },
        "DeviceValues":{  
           "1":{  
              "Name":"<index name >",
              "Value":"<index val>",
              "Type":"<index type>"
           },
           "2":{  
              "Name":"<index name>",
              "Value":"<index val>",
              "Type":"<index type>"
           },
           "3":{  
              "Name":"<index name>",
              "Value":"<index val>",
              "Type":"<index type>"
           }
        }
     }
  }
}

DynamicDeviceRemoved

Whenever a device is removed, the following update is received. 

{  
  "CommandType":"DynamicDeviceRemoved",
  "Action":"remove",
 "Devices":{ 
  "25":{
   "Type":"<device type id >"}
  }
}

DynamicAllDevicesRemoved

Whenever all the devices are removed, the follow update is received. 


{  
  "CommandType":"DynamicAllDevicesRemoved"
}

DynamicDeviceUpdated

If any device type or index are changed the following update will be received.

{  
  "CommandType":"DynamicDeviceUpdated",
  "Devices":{  
     "<device id>":{  
       "Data":{
               "Name":"<device name>",
               "Type":"<device type id >",
               "FriendlyDeviceType":"<friendly device type>",
               "Location":"<location>",
               "LastActiveEpoch":"<time stamp>", 
               "Manufacturer":"<manufacturer name>",
               "Version":"<version number>",
               "Model":"<model>",
               "DeviceState":"<0/1/2>"
              },
        "DeviceValues":{  
           "1":{  
              "Name":"<index name >",
              "Value":"<index val>",
              "Type":"<index type>"
           },
           "2":{  
              "Name":"<index name>",
              "Value":"<index val>",
              "Type":"<index type>"
           },
           "3":{  
              "Name":"<index name>",
              "Value":"<index val>",
              "Type":"<index type>"
           }
        }
       }
  }
}

DynamicRuleAdded

When a new rule is added the following update is received.

{
       "CommandType": "DynamicRuleAdded",
       "Rules": {
               "12": {
                       "Name": "mynewrule",
                       "Valid": "true",
                       "ID":"12",
                       "Triggers": [{
                               "Type": "<type of trigger>",
                               "ID": "<device id>",
                               "Index": "<device index>",
                               "Value": "<index value>",
                               "Grouping": "< AND/OR>",
                               "Condition": "<condition typet>",
                               "Duration": "<time in sec>",
                               "Valid": "true"
                       }],
                       "Results": [{
                               "Type": "<type of result>",
                               "ID": "<device id>",
                               "Index": "<device index>",
                               "Value": "<index value>",
                               "PreDelay": "<time in sec>",
                               "Valid": "true"
                       }, {
                               "Type": "<type of result>",
                               "ID": "<event id>",
                               "EventType": "<event type>",
                               "Value": "<event value>",
                               "PreDelay": "<time in sec>",
                               "Valid": "true"
                       }]
               }
       }
}


DynamicRuleUpdated

When an existing rule is modified the following update is received.

{
       "CommandType": "DynamicRuleUpdated",
       "Rules": {
               "12": {
                      "ID":"12",
                       "Name": "mynewrule",
                       "Valid": "true",
                       "Triggers": [{
                               "Type": "<type of trigger>",
                               "ID": "<device id>",
                               "Index": "<device index>",
                               "Value": "<index value>",
                               "Grouping": "< AND/OR>",
                               "Condition": "<condition type ie.eq/le/ge/lt/gt>",
                               "Duration": "<time in sec>",
                               "Valid": "true"
                       }],
                       "Results": [{
                               "Type": "<type of result>",
                               "ID": "<device id>",
                               "Index": "<device index>",
                               "Value": "<index value>",
                               "PreDelay": "<time in sec>"
                       }, {
                               "Type": "<type of result>",
                               "ID": "<event id>",
                               "EventType": "<event type>",
                               "Value": "<event value>",
                               "PreDelay": "<time in sec>"
                       }]
               }
       }
}


DynamicRuleRemoved

When a rule is removed the following update is received.

{
       "CommandType": "DynamicRuleRemoved",
       "Action": "remove",
       "Rules": {
               "1": {}
       }
}


DynamicAllRulesRemoved

When all rules are removed the following update is received.

{"CommandType":"DynamicAllRulesRemoved"}


DynamicAlmondModeUpdated

{
  "CommandType":"DymanicAlmondModeUpdated",
  "Mode":"<mode i.e.  2/3>",
  "EmailId":"<email id>"
}

DynamicClientAdded

When a new client is added the following update is received.

{
       "CommandType": "DynamicClientAdded",
       "Clients": {
               "1": {
                       "ID":"1",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "false",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0/1/2",
                       "CanBlock":"true/false",
                       "Category":"Kids/Others",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               }
       }
}

DynamicClientJoined

When a client joined network the following update is received.
{
       "CommandType": "DynamicClientJoined",
       "Clients": {
               "1": {
                       "ID":"1",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "true",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0/1/2",
                       "CanBlock":"true/false",
                       "Category":"Kids/Others",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               }
       }
}

DynamicClientLeft

When a client leaves the network, following update is received.
{
       "CommandType": "DynamicClientLeft",
       "Clients": {
               "1": {
                       "ID":"1",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "false",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0/1/2",
                       "CanBlock":"true/false",
                       "Category":"Kids/Others",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               }
       }
}

DynamicClientUpdated

When a name change or any changes done to a client the following update is received.

{
       "CommandType": "DynamicClientUpdated",
       "Clients": {
               "1": {
                       "ID":"1",
                       "Name": "64:bc:0c:80:62:46",
                       "Connection": "wired",
                       "MAC": "64:bc:0c:80:62:46",
                       "Type": "other",
                       "LastKnownIP": "10.10.10.97",
                       "Active": "false",
                       "UseAsPresence": "true",
                       "Wait": "6",
                       "LastActiveEpoch": "1459845389",
                       "RX": "0",
                       "TX": "0",
                       "Block": "0/1/2",
                       "CanBlock":"true/false",
                       "Category":"Kids/Others",
                       "Schedule": "0,0,0,0,0,0,0",
                       "Manufacturer": "LG",
                       "RSSI": "0",
                       "ForceInActive": "0"
               }
       }
}

DynamicClientRemoved

When a client is removed this update is received
{
       "CommandType": "DynamicClientRemoved",
       "Action": "remove",
       "Clients": {
               "1":{
                       "MAC": "1c:75:08:32:2a:6d"
                      }
       }
}

DynamicAllClientsRemoved

When all the clients are removed this update is received

{
"CommandType":"DynamicAllClientsRemoved"
}

DynamicSceneAdded

When a new scene is added the following update is received.
{
       "CommandType": "DynamicSceneAdded",
       "Scenes": {
               "1": {
                       "ID":"1",
                       "Active": "true",
                       "Name": "Scene1022",
                       "LastActiveEpoch": "251176214925585",
                       "VoiceCompatible":"true",
                       "SceneEntryList": [{
                               "ID": "1",
                               "Index": "1",
                               "Value": "false",
                               "Valid": "true"
                       }, {
                               "ID": "4",
                               "Index": "1",
                               "Value": "78",
                               "Valid": "false"
                       }]
        }
       }
}

DynamicSceneUpdated

when any changes are made to an existing scene the following update is received.

{
       "CommandType": "DynamicSceneUpdated",
       "Scenes": {
               "1": {
                      "ID":"1",
                       "Active": "true",
                       "Name": "Scene1022",
                       "LastActiveEpoch": "251176214925585",
                       "VoiceCompatible":"true",
                       "SceneEntryList": [{
                               "ID": "1",
                               "Index": "1",
                               "Value": "false",
                               "Valid": "true"
                       }, {
                               "ID": "4",
                               "Index": "1",
                               "Value": "78",
                               "Valid": "true"
                       }]
               }
       }
}

DynamicSceneActivated

When any scene is activated the following update is received.

{
       "CommandType": "DynamicSceneActivated",
       "Action": "update",
       "Scenes": {
               "1": {
                       "Active": "true",
                       "LastActiveEpoch": "251176214925585"
               }
       }

}

DynamicSceneRemoved

When any scene is removed the following update is received.
{
       "CommandType": "DynamicSceneRemoved",
       "Action": "remove",
       "Scenes": {
               "1": {}
       }
}

DynamicAllScenesRemoved

When all scenes are removed the following update is received.
{
       "CommandType": "DynamicAllScenesRemoved"
}