云服务 API 参考行业场景垂直行业解决方案商用照明 SaaS 基础服务照明自定义群组管理获取空间下可加入群组的设备列表

获取空间下可加入群组的设备列表

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

本文介绍获取空间下可加入群组的设备列表的 API。

接口描述

获取空间下可加入群组的设备列表，可通过一级品类过滤。

接口地址

GET: /v1.0/iot-02/lighting/groups/package/devices

请求参数

body 说明

参数名	类型	参数位置	是否必填	说明
spaceId	String	body	true	空间 ID
topCategoryCode	String	body	false	一级品类。 dgzm zm djd xjd cfdq jjaf hjjk sxj wgzk jnny jyyl gny qt

返回参数

参数名	类型	说明
deviceId	String	设备 ID
deviceName	String	设备名称
topCategoryCode	String	产品所属大级分类
secondCategory	String	产品所属二级分类
thirdCategory	String	产品所属三级分类
capability	long	设备能力
devicePower	double	设备功率
installTime	long	设备安装时间
activeTime	long	设备活跃时间
productId	String	产品 ID
spaceId	String	设备所属空间 ID
spaceName	String	设备所属空间名称
pointId	String	设备所在点位 ID
ownerId	String	所属设备家庭组 ID
icon	String	设备图标
uuid	String	设备 UUID
uid	String	用户 ID
model	String	产品型号
mac	String	MAC 地址
dps	Object[]	功能点列表
deviceExt	Object	设备扩展信息

请求示例

GET: /v1.0/iot-02/lighting/groups/package/devices

{
  "spaceId": "1468869242681139200",
  "topCategoryCode": "zm"
}

返回示例

{
    "result": [
        {
            "thirdCategory": "wf_ble_xdd",
            "productId": "sxa3tjzapeal****",
            "secondCategory": "xdd",
            "dps": [
            ],
            "installTime": 1639377489574,
            "ownerId": "4536****",
            "deviceId": "vdevo16393774893****",
            "deviceName": "床头灯",
            "spaceId": "146886924268113****",
            "pointId": "147028651497700****",
            "topCategoryCode": "zm",
            "devicePower": 0
        },
        {
            "thirdCategory": "wf_ble_xdd",
            "productId": "wobsckg5p6os****",
            "secondCategory": "xdd",
            "dps": [
            ],
            "installTime": 1639377505821,
            "ownerId": "4536****",
            "deviceId": "vdevo16393775054****",
            "deviceName": "灯具1-vdevo",
            "spaceId": "146886924268113****",
            "pointId": "147028651497700****",
            "topCategoryCode": "zm",
            "devicePower": 0
        },
        {
            "thirdCategory": "wf_ble_xdd",
            "productId": "1uqqknvmyljd****",
            "secondCategory": "xdd",
            "dps": [
            ],
            "installTime": 1639378351108,
            "ownerId": "4536****",
            "deviceId": "vdevo16393783507****",
            "deviceName": "灯具3-vdevo",
            "spaceId": "14688692426811****",
            "pointId": "14702865149770****",
            "topCategoryCode": "zm",
            "devicePower": 0
        }
    ],
    "t": 1640662390741,
    "success": true
}

错误码

参考错误码。

上一篇单个自定义群组详情

下一篇获取自定义群组列表