文档中心

TRAE CN

部门管理

获取单个父部门下的子部门

获取单个父部门下的子部门。可选择只返回直属的一级子部门，或所有后代部门。

所需权限

departments:read

请求说明

请求参数

请求头参数

Header 参数	是否必填	描述
Authorization	是	固定取值为 Bearer {access_token}。关于如何获取访问令牌，参考鉴权。

路径参数

参数	类型	是否必填	默认值	描述
id	string	是	-	父部门 ID。"0" 表示企业根部门。部门 ID 可以通过 ”按关键词搜索部门“ 接口获取。

查询参数

参数	类型	是否必填	默认值	描述
recursive	bool	否	false	是否递归返回子部门。 true：返回全部后代部门 false / 省略：仅返回直属的一级子部门
page	int	否	1	需返回的页数。
page_size	int	否	100	每页返回的子部门数量。取值范围：[1, 500]。

响应参数

该接口独有的响应参数如下，参数位于 data 中。通用响应参数参考此文档。

参数	类型	描述
items	array	子部门列表。
items[].department_id	string	子部门的 ID。
items[].parent_department_id	string	子部门所属的父部门的真实 ID，根部门为 "0"。提示：递归查询时，对于更深层级的子部门，该参数返回的值可能不等于请求路径中的 id。
items[].name	string	子部门的名称。
items[].full_path	string	子部门的完整归属路径。各级部门名称以 / 分隔。
items[].depth	int	子部门的层级深度。根部门为 0。

示例

请求示例

响应示例

错误码

若该接口的请求返回错误码，参考错误码文档进行排查。

最近更新时间：2026.10.10 17:34:32

这个页面对您有帮助吗？

有用

无用