资源介绍

资源定义

飞书某个企业里的组织架构树上的一个节点。

字段说明

名称	类型	描述
department_id	string	标识租户内一个唯一的部门，支持自定义或默认生成。详细说明参见部门ID说明示例值："h121921"数据校验规则：最大长度：`64` 字符正则校验：`^[a-zA-Z0-9][a-zA-Z0-9_\-@.]{0,63}$`；且不以`od-`开头
open_department_id	string	在某个应用中标识一个部门，同一个 `department_id` 在不同应用中的 `open_department_id` 不相同。详细说明参见部门ID说明示例值："od-4e6ac4d14bcd5071a37a39de902c7141"
name	string	部门名称示例值："DemoName"数据校验规则：最小长度：`1` 字符字段权限要求（满足任一）：获取部门基础信息以应用身份读取通讯录
i18n_name	department_i18n_name	国际化的部门名称字段权限要求（满足任一）：获取部门基础信息以应用身份读取通讯录
∟ zh_cn	string	部门的中文名示例值："Demo名称"
∟ ja_jp	string	部门的日文名示例值："デモ名"
∟ en_us	string	部门的英文名示例值："Demo Name"
parent_department_id	string	父部门的ID。创建根部门，该参数值为 “0”示例值："od-4e6ac4d14bcd5071a37a39de902c7141"
leader_user_id	string	部门主管用户ID示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"
order	string	部门的排序，即部门在其同级部门的展示顺序示例值："100"字段权限要求（满足任一）：获取部门组织架构信息以应用身份读取通讯录
unit_ids	string[]	部门单位自定义ID列表，当前只支持一个示例值：custom_unit_id字段权限要求（满足任一）：获取部门组织架构信息以应用身份读取通讯录
create_group_chat	boolean	是否创建部门群，默认不创建示例值：false

数据示例

{
    "department_id": "h121921",
    "open_department_id": "od-4e6ac4d14bcd5071a37a39de902c7141",
    "name": "DemoName",
    "i18n_name": {
        "zh_cn": "Demo名称",
        "ja_jp": "デモ名",
        "en_us": "Demo Name"
    },
    "parent_department_id": "od-4e6ac4d14bcd5071a37a39de902c7141",    
    "leader_user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62",
    "order": "100",
    "unit_ids": [
        "custom_unit_id"
    ],
    "create_group_chat": false
}

部门 ID 说明

department_id

department_id 用来标识租户内一个唯一的部门，支持在创建部门时自定义。若不自定义则由系统默认生成唯一的 department_id。

已经创建的部门，不允许修改 department_id。

你可以将你企业内部系统已有的部门唯一标识写入到飞书的部门 ID 中，由此实现飞书部门 ID 和内部系统部门 ID 的一致性，节省跨系统调用的映射成本。

open_department_id

open_department_id 用来在具体某个应用中标识一个部门，同一个department_id 在不同应用中的 open_department_id 不相同。

自定义 department_id

在创建部门时，通过 department_id 参数写入自定义部门ID，数据校验规则为：

最大长度：64 字符

正则校验：^[a-zA-Z0-9][a-zA-Z0-9_\-@.]{0,63}$

获取 department_id

获取建议

如果你的部门 ID 是由你自主定义的，建议本地维护一份部门 ID List，以方便自己查阅使用。

如果你没有维护部门 ID 数据，可以寻求租户管理员帮助，由管理员在租户管理后台查询部门ID。

租户管理员查询部门 ID 方法

拥有“成员和部门”管理权限的租户管理员，可查询其管理范围内的部门ID。

方法1：单个查询部门 ID

操作路径：企业管理后台中组织架构/成员与部门，点击左侧部门树中的某个部门右侧“...”，进入编辑抽屉

方法2：批量导出部门 ID

操作路径：企业管理后台中组织架构/成员与部门/管理部门/批量导入

资源定义#

字段说明#

数据示例#

部门 ID 说明#

department_id#

open_department_id#

自定义 department_id#

获取 department_id#

获取建议#

租户管理员查询部门 ID 方法#

方法1：单个查询部门 ID#

方法2：批量导出部门 ID#