修改部门信息

通过该事件订阅部门更新。old_object只展示被更新字段的原始值。应用身份访问通讯录的权限为历史版本，不推荐申请。

只有当应用拥有被改动字段的数据权限时，才会接收到事件。具体的数据权限与字段的关系请参考应用权限，或查看事件体参数列表的字段描述。

事件

基本
事件类型	contact.department.updated_v3
支持的应用类型	自建应用商店应用
权限要求开启任一权限即可	以应用身份读取通讯录以应用身份访问通讯录历史版本
字段权限要求	该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请获取部门基础信息获取部门组织架构信息以应用身份读取通讯录以应用身份访问通讯录历史版本读取通讯录历史版本
推送方式	Webhook

事件体

名称收起子列表	类型	描述
schema	string	事件模式
header	event_header	事件头
event_id	string	事件 ID
event_type	string	事件类型
create_time	string	事件创建时间戳（单位：毫秒）
token	string	事件 Token
app_id	string	应用 ID
tenant_key	string	租户 Key
event	-	-
object	department_event	更新后信息
name	string	部门名称数据校验规则：最小长度：`1` 字符字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
parent_department_id	string	父部门的部门open_department_id 部门相关ID概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
department_id	string	本部门的department_id 部门相关ID概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
open_department_id	string	部门的open_department_id 部门相关ID概念
leader_user_id	string	部门主管用户open_id 用户相关的 ID 概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
chat_id	string	部门群ID字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
order	int	部门的排序字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
status	department_status	部门状态字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
is_deleted	boolean	是否被删除
leaders	departmentLeader[]	部门负责人
leaderType	int	负责人类型可选值有：`1`：主负责人`2`：副负责人
leaderID	string	负责人ID字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
old_object	department_event	更新前信息
name	string	部门名称数据校验规则：最小长度：`1` 字符字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
parent_department_id	string	父部门的部门open_department_id 部门相关ID概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
department_id	string	本部门的department_id 部门相关ID概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
open_department_id	string	部门的open_department_id 部门相关ID概念
leader_user_id	string	部门主管用户open_id 用户相关的 ID 概念字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
chat_id	string	部门群ID字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
order	int	部门的排序字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本
status	department_status	部门状态字段权限要求（满足任一）：以应用身份读取通讯录获取部门基础信息以应用身份访问通讯录历史版本读取通讯录历史版本
is_deleted	boolean	是否被删除
leaders	departmentLeader[]	部门负责人
leaderType	int	负责人类型可选值有：`1`：主负责人`2`：副负责人
leaderID	string	负责人ID字段权限要求（满足任一）：以应用身份读取通讯录获取部门组织架构信息以应用身份访问通讯录历史版本读取通讯录历史版本

事件体示例

{
    "schema": "2.0",
    "header": {
        "event_id": "5e3702a84e847582be8db7fb73283c02",
        "event_type": "contact.department.updated_v3",
        "create_time": "1608725989000",
        "token": "rvaYgkND1GOiu5MM0E1rncYC6PLtF7JV",
        "app_id": "cli_9f5343c580712544",
        "tenant_key": "2ca1d211f64f6438"
    },
    "event": {
        "object": {
            "name": "测试部门",
            "parent_department_id": "jkfsd89782",
            "department_id": "yd7sa8yf2j",
            "open_department_id": "od_j10j52hjksd9g0isdfg43",
            "leader_user_id": "ou_3j1kh45jk18fgh23hf",
            "chat_id": "oc_uiy325uy23bnv48gdf",
            "order": 100,
            "status": {
                "is_deleted": false
            },
            "leaders": [
                {
                    "leaderType": 1,
                    "leaderID": "ou_7dab8a3d3cdcc9da365777c7ad535d62"
                }
            ]
        },
        "old_object": {
            "name": "测试部门",
            "parent_department_id": "jkfsd89782",
            "department_id": "yd7sa8yf2j",
            "open_department_id": "od_j10j52hjksd9g0isdfg43",
            "leader_user_id": "ou_3j1kh45jk18fgh23hf",
            "chat_id": "oc_uiy325uy23bnv48gdf",
            "order": 100,
            "status": {
                "is_deleted": false
            },
            "leaders": [
                {
                    "leaderType": 1,
                    "leaderID": "ou_7dab8a3d3cdcc9da365777c7ad535d62"
                }
            ]
        }
    }
}

事件#

事件体#

事件体示例#

事件

事件体

事件体示例