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

更新时间:2023-06-15 06:09:35

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

接口描述

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

接口地址

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

请求参数

body 说明

参数名类型参数位置是否必填说明
spaceIdStringbodytrue空间 ID
topCategoryCodeStringbodyfalse一级品类。
  • dgzm
  • zm
  • djd
  • xjd
  • cfdq
  • jjaf
  • hjjk
  • sxj
  • wgzk
  • jnny
  • jyyl
  • gny
  • qt

返回参数

参数名类型说明
deviceIdString设备 ID
deviceNameString设备名称
topCategoryCodeString产品所属大级分类
secondCategoryString产品所属二级分类
thirdCategoryString产品所属三级分类
capabilitylong设备能力
devicePowerdouble设备功率
installTimelong设备安装时间
activeTimelong设备活跃时间
productIdString产品 ID
spaceIdString设备所属空间 ID
spaceNameString设备所属空间名称
pointIdString设备所在点位 ID
ownerIdString所属设备家庭组 ID
iconString设备图标
uuidString设备 UUID
uidString用户 ID
modelString产品型号
macStringMAC 地址
dpsObject[]功能点列表
deviceExtObject设备扩展信息

请求示例

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
}

错误码

参考 错误码