Get device group list
HTTP Request URL: http(s)://api.thingboot.com/{AppID}/group/list/?sign={sign}&ts={ts}
About the sign and ts definition
Or
MQTT Publish Topic: api/{AppID}/group/list
The returned results are also received on the same topic.
Request parameters
| Name | Required | Type | Description |
|---|---|---|---|
| format | No | string | Output format:
When "tree", output tree-structured data;
When "list" or no value is passed, output list-structured data; |
| page_index | No | int | Page number, default 1 |
| page_size | No | int | Default is 10 items, but can be set to 20, 30, or 50. |
Return results
| Name | Type | Description |
|---|---|---|
| id | int | Group ID, unique to this workstation (console), but not unique across multiple workstations. |
| title | string | Group Name |
| parent | int | Parent group ID; when it is 0, it indicates a first-level group. |
| device | string | "count" refers to the number of devices in the current group.
"total" refers to the sum of the number of devices in the current group and its subordinate groups. |
| remark | string | Remark |
Return example