---
title: "获取分组详情信息"
method: POST
path: "/api/v1/things/group/info/read"
tags: ["things/group/info", "thingsGroupInfo"]
---

# 获取分组详情信息

`POST /api/v1/things/group/info/read`

## Request body

- GroupInfoReadReq
  - `id` integer, required — id
  - `purpose` string — 用途 不填默认为default
  - `withChildren` boolean
  - `withDevices` boolean — true 时返回 devices 设备核心信息

## Response `200`

A successful response.

- object
  - `code` integer
  - `data` GroupInfo
    - `areaID` string — 区域ID
    - `children` GroupInfo[]
    - `createdTime` string — 创建时间
    - `desc` string — 分组描述
    - `deviceCount` integer — 设备数量统计
    - `devices` DeviceCore[] — withDevices=true 时返回分组下设备核心信息
      - `deviceName` string, required — 设备名称
      - `productID` string, required — 产品ID
      - `productName` string
    - `files` object — key 是用途, value是文件的路径,
    - `id` integer — 分组ID
    - `idPath` string — 分组ID路径
    - `isLeaf` integer
    - `name` string — 分组名称
    - `parentID` integer — 父组ID
    - `productID` string — 产品ID
    - `productName` string — 产品ID
    - `projectID` string — 项目ID
    - `purpose` string — 用途 不填默认为default
    - `tags` Tag[] — 分组tag
      - `key` string, required
      - `value` string, required
  - `msg` string

## Changes

- **2026-03-27** `b9582d0ab6af` — 1 breaking, 1 info
  - added required request body
  - added the media type `application/json` for the response with the status `200`
- **2025-03-14** `e87dbcac5d9e` — 2 breaking
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/unitedrhino/apis/things-api/changes/api/v1/things/group/info/read/post.md)

---

[API](https://skmtc.dev/unitedrhino/apis/things-api.md) · [All operations](https://skmtc.dev/unitedrhino/apis/things-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unitedrhino/things-api/revisions/f3bdeb916389/schema)