Get IoT Device Properties for Imou Cameras - Imou Open Platform
getIotDeviceProperties: Obtain the property value specified in the things data model
Function details
Obtain the property value specified in the things data model
Request address
https://openapi-[DataCenter].easy4ip.com/openapi/getIotDeviceProperties
Incoming parameter description
| Parameter name | Parameter type | Required or not | Default value | Legal value | Parameter description |
|---|---|---|---|---|---|
| token | String | yes | Administrator or sub-account accessToken | ||
| productId | String | yes | Refers to the productId returned by the listDeviceDetailsByIds and listDeviceDetailsByPage interfaces. If the productId field returned by the list has a value, it indicates that the device is an IoT device and supports calling IoT things data model Interface | unique id of product | |
| deviceId | String | yes | Device serial number | ||
| subDeviceId | String | Refers to the subDeviceId returned by the listDeviceDetailsByIds and listDeviceDetailsByPage interfaces. If the productId field returned by the list has a value, it indicates that the device is an IoT device and supports calling IoT things data model Interface | Sub device serial number, mandatory when querying the properties of sub devices | ||
| properties | [String] | yes | View the properties supported by the device through getProductModel | The set of ref values for properties in the things data model |
Sample input
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"58386675a58cf164d64c1944fd33a516",
"time":1603366491,
"nonce":"7aed0429-1a92-4a51-b8b0-cfebb60dcc85"
},
"id":"a25f887f-33f0-44ef-9ed3-f60f83193482",
"params":{
"token":"At_00000xxxxxxxxxxxxxxxxxx",
"productId": "W8ql32289",
"deviceId": "TESTQWERXXXX",
"properties": ["3301","3302"]
}
}
Return data field description
| Field name | Field type | Field description |
|---|---|---|
| productId | String | nique id of product |
| deviceId | String | Device serial number |
| name | String | Device name |
| properties | [array] | The set of values for properties |
| status | String | device status,online/offline |
Sample output
{
"result": {
"msg": "Operation is successful.",
"code": "0",
"data": {
"productId": "W8ql32289",
"deviceId": "TESTQWERXXXX",
"name": "RASD",
"properties": {
"3301": 1,
"3302": 2
},
"status": "online"
}
},
"id": "a25f887f-33f0-44ef-9ed3-f60f83193482"
}
