查询群组状态

更新时间：2024-06-29 02:33:36下载pdf

本文介绍查询群组状态的 API。

接口描述

根据群组 ID，查询群组状态，返回群组下任意一个设备的状态。

接口地址

GET: /v2.1/cloud/thing/group/{group_id}/status-set

请求参数

参数名	类型	参数位置	是否必填	说明
group_id	Long	path	true	群组 ID。

返回参数

参数名	类型	说明
result	JsonObject	返回群组数据结果。
success	Boolean	API 调用是否成功。 `true`：调用成功。 `false`：调用失败。
t	Long	时间戳。
tid	String	链路 ID。

result 说明

参数名	类型	说明
code	String	指令码。
type	String	指令类型。
value	String	指令当前值。

请求示例

GET: /v2.1/cloud/thing/group/1393****/status-set

返回示例

{
    "tid": "1e90681f022611efbe7a366d87620758",
    "result": [
        {
            "code": "work_mode",
            "type": "enum",
            "value": "music"
        },
        {
            "code": "switch_led",
            "type": "bool",
            "value": "true"
        }
    ],
    "t": 1713954823138,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇查询群组任务进度