获取用户组

适用版本>=v7.0.2505a.20250515
接口说明：获取用户组

请求说明

请求地址	配置域名+/openapi+`/v7/groups/{group_id}`
请求方法	GET
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	查询和管理用户组（应用授权） `kso.group.readwrite` 查询用户组（应用授权）`kso.group.read` 查询和管理用户组（用户授权） `kso.group.readwrite` 查询用户组（用户授权）`kso.group.read`

Header	参数类型	是否必填	说明
X-Kso-Date	string	是	RFC1123 格式的日期，例: `Wed, 23 Jan 2013 06:43:08 GMT`
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：`Bearer {access_token}`

路径参数（Path）

名称	类型	是否必填	说明
group_id	string	是	用户组id

查询参数（Query）

名称	参数类型	是否必填	说明
with_member_total	boolean	否	`true`：返回用户组成员数量 `false`：不返回用户组成员数量默认为：false

响应体（Response）

名称	类型	说明
code	integer	code
detail	string	detail
msg	string	msg
data	object	用户组信息
∟ avatar	string	头像
∟ company_id	string	企业ID
∟ creator_id	string	创建者ID 创建时即确定，不被修改
∟ ctime	int64	创建时间
∟ dept_id	string	关联部门ID, 默认 0
∟ description	string	描述介绍
∟ id	string	组ID
∟ member_total	string	成员数量
∟ mtime	int64	更新时间
∟ name	string	名称
∟ mail	string	邮箱
∟ owner_id	string	拥有者ID
∟ source	string	创建用户组的业务方来源
∟ status	string	状态，`enable`：正常;`recycled`：回收站;`deleted`：删除;
∟ type	string	用户组类型，`normal`：普通用户组;`dept`：部门用户组;`whole`：全员用户组;

响应体示例

json

{
  "data": {
    "avatar": "string",
    "company_id": "string",
    "creator_id": "string",
    "ctime": 1,
    "dept_id": "string",
    "description": "string",
    "id": "string",
    "member_total": 0,
    "mtime": 1,
    "name": "string",
    "mail": "string",
    "owner_id": "string",
    "source": "string",
    "status": "enable",
    "type": "normal"
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}