# 修改部门信息

通过该事件订阅部门更新。

  • 只有当应用拥有删除部门的父部门权限时才会接收到事件。
  • 只有当应用被改动字段的数据权限时,才会接收到事件。

# 事件

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

# 事件体

名称 类型 描述
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 - -
 ∟new_object department_content 变更否的信息
  ∟name string 部门名称
字段权限要求(满足任一)
获取部门基础信息
  ∟parent_department_id string 父部门的ID
字段权限要求(满足任一)
获取部门组织架构信息
  ∟department_id string 本部门的自定义部门ID
字段权限要求(满足任一)
获取部门基础信息
  ∟leader_user_id string 部门主管用户ID
字段权限要求(满足任一)
获取用户 user_id
  ∟order int 部门的排序,即部门在其同级部门的展示顺序
  ∟member_count int 部门下用户的个数
  ∟status object 部门状态
字段权限要求(满足任一)
获取部门基础信息
   ∟ is_deleted boolean 是否已删除
 ∟old_object department_content 变更前的信息
  ∟name string 部门名称
字段权限要求(满足任一)
获取部门基础信息
  ∟parent_department_id string 父部门的ID
字段权限要求(满足任一)
获取部门组织架构信息
  ∟department_id string 本部门的自定义部门ID
字段权限要求(满足任一)
获取部门基础信息
  ∟leader_user_id string 部门主管用户ID
字段权限要求(满足任一)
获取用户 user_id
  ∟order int 部门的排序,即部门在其同级部门的展示顺序
  ∟member_count int 部门下用户的个数
  ∟status object 部门状态
字段权限要求(满足任一)
获取部门基础信息
   ∟ is_deleted boolean 是否已删除

# 事件体示例

{
  "header": {
    "event_id": "bbcce6e9-6ba4-4031-9b3c-8e610f3e0b73",
    "event_type": "contact.department.updated",
    "create_time": "1662444442165",
    "token": "8c8cc37f29b34defb4bc9912167747a4",
    "app_id": "bli_sm8pxsvuwjsudhta",
    "tenant_key": "e33ed0f6204318233nR9"
  },
  "event": {
    "new_object": {
      "department_id": "0104",
      "name": "公共资源",
      "parent_department_id": "01",
      "leader_user_id": "13637",
      "order": 0,
      "member_count": 4,
      "status": {
        "is_deleted": false
      }
    },
    "old_object": {
      "department_id": "0104",
      "name": "公共资源",
      "parent_department_id": "01",
      "leader_user_id": "13637",
      "order": 0,
      "member_count": 4,
      "status": {
        "is_deleted": false
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
最后更新于 : 8/16/2024, 10:52:48 AM