获取父部门信息

该接口用来递归获取部门的父部门信息，并按照由子到父的顺序返回有权限的父部门信息列表。

Warning: 延迟说明：该接口返回的数据延迟 10s内，即：直接部门上级或者上上级部门发生变化后，10s后才能查询到最新数据。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/departments/parents
HTTP Method	POST
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	corehr:department.organize:read 获取部门组织架构信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

查询参数

名称	类型	必填	描述
department_id_type	string	否	此次调用中使用的部门 ID 类型 示例值：open_department_id 可选值有： - open_department_id: 【飞书】用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 相同。 - department_id: 【飞书】用来标识租户内一个唯一的部门。 - people_corehr_department_id: 【飞书人事】用来标识「飞书人事」中的部门。 默认值：open_department_id

请求体

名称	类型	必填	描述
department_id_list	string\[\]	是	部门 ID 列表，一次性最多传入 100 个部门 ID - 调用【创建部门】【搜索部门】等接口可以返回部门ID 示例值：["6893014062142064111"] 数据校验规则： - 长度范围：1 ～ 100

请求体示例

{
    "department_id_list": [
        "6893014062142064111"
    ]
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	department_parents\[\]	父部门查询结果
└ department_id	string	部门 ID
└ parent_department_list	department_parent_info\[\]	父部门列表，部门按照至底向上的顺序返回
└ department_id	string	部门 ID
└ department_name	i18n\[\]	部门名称
└ lang	string	语言，中文用zh-CN，英文用en-US
└ value	string	内容
└ parent_department_id	string	上级部门 ID（若查询的是一级部门，则该字段不展示） - 可通过批量查询部门V2 或者搜索部门信息 获取详情
└ active	boolean	是否启用
└ is_root	boolean	是否根部门

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "department_id": "6893014062142064111",
                "parent_department_list": [
                    {
                        "department_id": "4719456877659520852",
                        "department_name": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ],
                        "parent_department_id": "4719456877659520111",
                        "active": true,
                        "is_root": true
                    }
                ]
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160102	参数错误	校验传参是否正确
403	1160103	鉴权失败	对当前查询部门没有权限（部门可见权限）
503	1161204	Requset timeout	接口超时，可以选择重试。如果无法解决可联系 技术支持
429	1161604	QPS over limit	接口请求次数超过接口频率限制，可尝试降低请求频率