# 获取父部门信息

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

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

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/departments/parents
HTTP Method | POST
接口频率限制 | [100 次/分钟](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取部门组织架构信息(corehr:department.organize:read)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 查询参数

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

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
department_id_list | string\[\] | 是 | 部门 ID 列表，一次性最多传入 100 个部门 ID<br>- 调用[【创建部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/department/create)[【搜索部门】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search)等接口可以返回部门ID<br>**示例值**：["6893014062142064111"]<br>**数据校验规则**：<br>- 长度范围：`1` ～ `100`

### 请求体示例
```json
{
    "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（若查询的是一级部门，则该字段不展示）<br>- 可通过[批量查询部门V2](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/batch_get) 或者[搜索部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/department/search) 获取详情
active | boolean | 是否启用
is_root | boolean | 是否根部门

### 响应体示例
```json
{
    "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 | 接口超时，可以选择重试。如果无法解决可联系 [技术支持](https://applink.feishu.cn/TLJpeNdW)
429 | 1161604 | QPS over limit | 接口请求次数超过接口频率限制，可尝试降低请求频率