说明文档
切换说明
设备API
设备信息API
注:请先查看:API接口调用说明
设备列表
- Request Url
{api_url}/device/findPage
Request Method
POST
Request Body
字段 | 值描述 | 必填 |
---|---|---|
pageIndex | 分页的页码,从1开始 | 是 |
pageSize | 每页显示数据条数 | 是 |
pdid | 产品id | 否(与pdidList二选一) |
pdidList | 产品id列表 | 否(与pdid二选一) |
deviceSn | 设备sn | 否 |
示例:
{ "pageIndex": 1, "pageSize": 10, "pdid": "", "pdidList": ["abc","efg"], "deviceSn": "" }
- Response Body
字段 | 值描述 |
---|---|
pdid | 产品id |
deviceSn | 设备sn |
parentDeviceSn | 父设备sn |
activation | 是否激活,0:未激活,1:激活 |
activationDate | 激活时间 |
enabled | 启用禁用,启用:0,禁用:1 |
offline | 离线状态, 0:在线, 1:离线 |
createDate | 创建时间 |
updateDate | 修改时间 |
示例:
{ "status": 0, "description": "成功", "payload": { "pageIndex": 1, "pageSize": 10, "total": 1, "data": [ { "pdid": "", "deviceSn": "xxx", "parentDeviceSn": "xxx", "activation": 1, "activationDate": "2020-10-23 09:59:52", "enabled": 0, "offline": 1, "createDate": "2020-09-30 14:24:54", "updateDate": "2020-09-30 14:24:54" } ] } }
获取设备信息
- Request Url
{api_url}/device/get
Request Method
POST
Request Body
字段 | 值描述 | 必填 |
---|---|---|
deviceSn | 设备sn | 是 |
示例:
{ "deviceSn": "xxx" }
- Response Body
字段 | 值描述 |
---|---|
pdid | 产品id |
deviceSn | 设备sn |
parentDeviceSn | 父设备sn |
activation | 是否激活,0:未激活,1:激活 |
activationDate | 激活时间 |
enabled | 启用禁用,启用:0,禁用:1 |
offline | 离线状态, 0:在线, 1:离线 |
createDate | 创建时间 |
updateDate | 修改时间 |
示例:
{ "status": 0, "description": "成功", "payload": { "pdid": "", "deviceSn": "xxx", "parentDeviceSn": "xxx", "activation": 1, "activationDate": "2020-10-23 09:59:52", "enabled": 0, "offline": 1, "createDate": "2020-09-30 14:24:54", "updateDate": "2020-09-30 14:24:54" } }
获取设备的服务属性
- Request Url
{api_url}/device/service/propts
Request Method
POST
Request Body
字段 | 值描述 | 必填 |
---|---|---|
pdid | 产品id | 是 |
deviceSn | 设备sn | 是 |
sid | 服务定义id | 是 |
示例:
{ "pdid": "", "deviceSn": "xxx", "sid": 1 }
- Response Body
字段 | 值描述 |
---|---|
key | 属性pid,即示例中的 "0"、"1" |
value | 属性值 |
updateDate | 属性更新时间 |
示例:
{ "status": 0, "description": "成功", "payload": { "0": { "value": 123, "updateDate": "2020-12-12 16:14:27" }, "1": { "value": "1.1.1", "updateDate": "2020-12-12 16:14:27" } } }