获取设备所在群组

更新时间:2024-06-29 02:09:02下载pdf

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

接口描述

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

接口地址

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

请求参数

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

返回参数

参数名类型说明
resultJsonObject返回群组数据结果。
successBooleanAPI 调用是否成功。
  • true:调用成功。
  • false:调用失败。
tLong时间戳。
tidString链路 ID。

result 说明

参数名类型说明
group_idLong群组 ID。
group_nameString群组名称。
space_idString群组所属空间的 ID。
icon_urlString群组 Icon 信息,入参产品对应图片。
create_timeLong群组创建时间。
update_timeLong群组更新时间。

请求示例

GET: /v2.1/cloud/thing/group/device/vdevo17059963185****

返回示例

{
    "tid": "cb7281bf021c11efbe7a366d87620758",
    "result": [
        {
            "icon_url": "https://images.tuyacn.com/smart/solution/142004/67397664844****.png",
            "create_time": 1713944884506,
            "group_name": "testUpdateGroup****",
            "update_time": 1713948182799,
            "group_id": "1393****",
            "space_id": "16702****"
        }
    ],
    "t": 1713950817007,
    "success": true
}

错误码

参考 错误码

调用频率限制

参考 调用频率限制