获取设备所在群组

更新时间:2024-06-28 23:48:06下载pdf

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
device_idStringpathtrue设备 ID。

返回参数

参数名类型说明
resultJSON接口的返回数据集。
successBoolean操作是否成功。
  • true:操作成功。
  • false:操作失败。
tLong时间戳。
tidString链路 ID。

result 说明

参数名类型说明
idLong群组 ID。
nameString群组的名称数据。
pvStringMQTT 的协议版本。
timeLong群组创建时间。
typeInteger群组的分组类型。
  • 0:直连云设备。
  • 1:非直连云设备,需要通过网关设备连云的设备。
uidString群组所属的用户 ID。
categoryString设备品类 code。
dev_idString设备 ID。
group_typeInteger群组所属的协议类型。
  • 0:Wi-Fi
  • 1:蓝牙低功耗
  • 2:Zigbee
  • 3:蓝牙 mesh
icon_urlString群组的图片信息,默认是产品的图片。目前不支持更改。
local_keyStringMQTT 对应的 localKey
owner_idString群组所属的空间 ID 数据。
product_idString群组的产品 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
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制