云服务 API 参考行业场景垂直行业解决方案商用照明 SaaS 基础服务商照设备管理获取设备列表

获取设备列表

更新时间：2023-06-21 07:13:02

本文介绍获取设备列表的 API。

接口描述

获取设备信息列表。

接口地址

GET: /v1.0/illumination/devices

请求参数

参数名	类型	参数位置	是否必填	说明
projectId	String	uri	false	项目 ID。
roomId	String	uri	true	房间 ID。
roomType	Integer	uri	true	房间类型。
page	Integer	uri	false	当前页码。
pageSize	Integer	uri	false	每页记录数量。
deviceStatus	List《String》	uri	true	设备状态。

返回参数

参数名	类型	说明
total	int	返回的总条数。
list	DeviceBasicVO[]	设备信息列表。

请求示例

GET: /v1.0/illumination/devices

{
  "pageSize": "10",
  "page": "1",
  "projectId": "1323671234234",
  "roomId": "152372223482",
}

返回示例

{
    "tid": "f2919c24fbac11ed876d16e5066b4061",
    "result": {
        "list": [
            {
                "switchInfo": [
                ],
                "masterGroupJoinStatus": 2,
                "deviceStatuses": [
                    "normal"
                ],
                "industryPurpose": {
                },
                "installTime": 1681962468804,
                "switchStatus": false,
                "ownerId": "59457509",
                "deviceId": "6c4794741ec4f88c993***",
                "deviceName": "网关测试",
                "uuid": "a651b293c892b***",
                "roomId": "1559640253681***",
                "deviceStatus": "normal",
                "capability": "zigbee/wifi",
                "pointId": "",
                "devicePurpose": {
                },
                "deviceMac": "",
                "currentBrightness": 0,
                "model": "",
                "id": 2114488,
                "deviceType": "gateway",
                "deviceTypeValue": 1,
                "productId": "wpr7snzwzxbsy***",
                "deviceSaasId": "sa43837415438329***",
                "categoryCode": "wf_zig_wg2",
                "roomName": "测试",
                "topCategory": "wgzk",
                "online": true,
                "devicePower": 0,
                "category": "wg2",
                "projectId": "1541976932755718***",
                "properties": [
                    {
                        "dpName": "报警静音",
                        "dpId": 4,
                        "mode": "rw",
                        "dpValueStd": "false",
                        "propertyDetail": {
                            "type": "bool"
                        },
                        "dpCode": "switch_alarm_sound",
                        "property": {
                            "range": [
                            ]
                        }
                    }
                ]
            }
        ],
        "total": 1
    },
    "t": 1685095574507,
    "success": true
}

错误码

参考错误码。