# 创建部门
创建通讯录部门时发送该事件给订阅应用。
- 只有当应用拥有删除部门的父部门权限时才会接收到事件。
- 只有当应用被改动字段的数据权限时,才会接收到事件。
# 事件
| 基本 | |
|---|---|
| 事件类型 | contact.department.created |
| 支持的应用类型 | 自建应用 |
| 权限要求 开启任一权限即可 | 以应用身份读取通讯录 |
| 字段权限要求 | 该接口返回体中存在下列敏感字段,仅当开启对应的权限后才会返回;如果无需获取这些字段,则不建议申请: 获取部门基础信息 获取部门组织架构信息 以应用身份读取通讯录 |
# 事件体
| 名称 | 类型 | 描述 |
|---|---|---|
| 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 | - | - |
| ∟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.created",
"create_time": "1662444442165",
"token": "8c8cc37f29b34defb4bc9912167747a4",
"app_id": "bli_sm8pxsvuwjsudhta",
"tenant_key": "e33ed0f6204318233nR9"
},
"event": {
"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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21