简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

创建自定义群组

更新时间:2022-09-07 08:38:02下载pdf

本文介绍创建自定义群组的 API。

接口描述

创建自定义群组,默认归属到空间所在家庭组。

接口地址

POST: /v1.0/iot-02/lighting/groups/package

请求参数

body 说明

参数名类型参数位置是否必填说明
spaceIdStringbodytrue空间 ID
nameStringbodytrue群组名称
deviceIdsString[]bodytrue设备 ID 列表
ownerIdStringbodyfalse家庭组 ID
groupConfigsStringbodyfalse群组扩展参数

返回参数

参数名类型说明
groupPackageIdString大群组 ID
taskIdString设备状态数量,如果返回 null,不用展示耗时操作,直接完成任务
expiredSecondslong任务过期剩余秒数,如果返回 null,不用展示耗时操作,直接完成任务
groupIdslong[]设备群组 ID 列表

请求示例

POST: /v1.0/iot-02/lighting/groups/package
{
  "spaceId": "146886924268113****",
  "name": "自定义群组123467",
  "deviceIds": [
    "vdevo16393774893****",
    "vdevo16393775054****"
  ],
  "ownerId": "45360622",
  "groupConfigs": "test"
}

返回示例

{
    "result": {
        "groupIds": [
            12089569,
            12089570
        ],
        "expiredSeconds": 14,
        "groupPackageId": "147566148209509****",
        "taskId": "147566148214961****"
    },
    "t": 1640660088966,
    "success": true
}

错误码

参考 错误码