Get Device Group

Last Updated on : 2024-06-29 01:11:08download

Based on the device ID, get all the groups that include the specified device ID.

API address

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

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	path	true	The device ID.

Return parameter

Parameter name	Type	Description
result	JSON	The list of returned data.
success	Boolean	Indicates whether the operation is successful. Valid values: `true`: The operation succeeded. `false`: The operation failed.
t	Long	The timestamp.
tid	String	The link ID.

Description of result

Parameter name	Type	Description
id	Long	The ID of the specified group.
name	String	The name of the specified group.
pv	String	The version number of the specified MQTT protocol.
time	Long	The time when a group is created.
type	Integer	The type of the specified group. Valid values: `0`: Devices that can be directly connected to the cloud. `1`：Devices that cannot be directly connected to the cloud, but can only be connected to the cloud through gateways.
uid	String	The ID of a user in the specified group.
category	String	The category code of the specified device.
dev_id	String	The device ID.
group_type	Integer	The protocol type applicable to the specified group. Valid values: `0`: Wi-Fi `1`: Bluetooth low energy `2`: Zigbee `3`: Bluetooth mesh
icon_url	String	The picture of the specified group. A product picture is used by default. Currently, you cannot change the product picture.
local_key	String	The `localKey` used for the MQTT connection.
owner_id	String	The ID of the space to which the specified group belongs.
product_id	String	The ID of a product in the group.

Request example

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

Return example

{
    "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": "Test****",
            "id": "1285****",
            "time": 1677117998,
            "category": "dj",
            "group_key": ""
        }
    ],
    "t": 1677118877539,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.