The basic information of device can be queried by the AIOT API, such as
- name: device name
- model: device type
- firmwareVersion: device firmware version
- chipVersion: device chip version
- state: whether device is offline
The detail of API definition takes the information is suject to the AIOT Open Platform website.
| Key | Value |
|---|---|
| API | /open/device/query |
| description | query the device information |
| header | { "Appid": "xxx", "Appkey": "xxx", "Openid": "xxx", "Access-Token": "xxx" } |
| payload | { "openId": "xxx", " did ": "xxx" } |
| response | { "code": 0 (errorcode), "result": {"did": "xxx", "model": "xxx", "name": "xxx", "firmwareVersion": "xxx", "chipVersion": "xxx", "isOnline": 1 }}} |
| Key | Value |
|---|---|
| API | /open/device/query/user |
| description | query the device information of the specified user |
| header | { "Appid": "xxx", "Appkey": "xxx", "Openid": "xxx", "Access-Token": "xxx" } |
| payload | { "openId": "xxx" } |
| response | { result: [{bindDate: "2017-06-10", bindTime: "00:40:26", name: "xxx", odel: "xxx", isOnline: 1, firmwareVersion: "xxx", did: "xxx", parentId: "xxx"}], code: 0 } |
| Key | Value |
|---|---|
| API | /open/device/query/position/private |
| description | query the device information at the specified position |
| header | { "Appid": "xxx", "Appkey": "xxx", "Openid": "xxx", "Access-Token": "xxx" } |
| payload | { openId: "xxx", positionType: "room", positionId: "xxx" } |
| response | { result: [{ positionType: "xx", chipVersion: "xxx", latitude: "xxx", isOnline: 1, parentId: "xxx", positionId: "xxx", name: "xxx", model: "xxx", firmwareVersion: "xxx", did: "xxx", longitude: "xxx" } ], code: 0 } |
Parameter Description as follows:
- did: device id
- openId: user id
- Appid: third-party application appId
- Appkey: third-party application appKey
- Access-Token: User token
- state: device online / offline status, 0 - offline, 1 - online
- errorcode: error code, see attachment