获取设备所在群组

更新时间：2023-11-23 06:22:10下载pdf

本文介绍获取设备所在群组的 API。

接口描述

根据设备 ID，获取设备 ID 所在的所有群组。

接口地址

GET: /v2.0/cloud/thing/group/device/{device_id}

请求参数

参数名	类型	参数位置	是否必填	说明
device_id	String	path	true	设备 ID。

返回参数

参数名	类型	说明
result	JSON	接口的返回数据集。
success	Boolean	操作是否成功。 `true`：操作成功。 `false`：操作失败。
t	Long	时间戳。
tid	String	链路 ID。

result 说明

参数名	类型	说明
id	Long	群组 ID。
name	String	群组的名称数据。
pv	String	MQTT 的协议版本。
time	Long	群组创建时间。
type	Integer	群组的分组类型。 `0`：直连云设备。 `1`：非直连云设备，需要通过网关设备连云的设备。
uid	String	群组所属的用户 ID。
category	String	设备品类 code。
dev_id	String	设备 ID。
group_type	Integer	群组所属的协议类型。 `0`：Wi-Fi `1`：蓝牙低功耗 `2`：Zigbee `3`：蓝牙 mesh
icon_url	String	群组的图片信息，默认是产品的图片。目前不支持更改。
local_key	String	MQTT 对应的 `localKey`。
owner_id	String	群组所属的空间 ID 数据。
product_id	String	群组的产品 ID。

请求示例

GET: /v2.0/cloud/thing/group/device/1285**************

返回示例

{
    "tid": "be27314ab32011edaa2fba12a1143bd9",
    "result": [
        {
            "icon_url": "https://images.tuyacn.com/smart/solution/15001/66ba22c327bfbf3d_co***.png",
            "standard": false,
            "dp_name": {
                "1": "",
                "9": ""
            },
            "local_key": "360f7d71088c*****",
            "dps": {
                "1": false,
                "9": 0
            },
            "owner_id": "251****",
            "pv": "2.2",
            "device_num": 1,
            "group_type": 0,
            "type": 0,
            "dev_id": "v2h3k1hkj1k****",
            "uid": "ay159910362****",
            "product_id": "fqi9xq***",
            "name": "测试****",
            "id": "1285****",
            "time": 1677117998,
            "category": "dj",
            "group_key": ""
        }
    ],
    "t": 1677118877539,
    "success": true
}

错误码

参考错误码。

调用频率限制

参考调用频率限制。

上一篇删除设备

下一篇查询群组属性