# 简介

本教程介绍如何使用飞书开放平台通讯录开放能力，完成对部门的增删改查操作，并监听员工的入职、离职事件。通过本教程你可以快速了解如何使用 OpenAPI 操作通讯录，以及处理员工入职、离职事件。

## 流程简介

本文涉及的操作流程如下图所示：

![image.png](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/63ec92fade6b108e3b1774ee0ab8d0af_orJ4Yredsc.png?lazyload=true&width=733&height=208)

## 实现效果

- 通过运行示例代码实现对部门的增删改查操作。
  <md-video src="//sf3-cn.feishucdn.com/obj/open-platform-opendoc/d4c55cf332b19d0fce6f0884be9801e6_VUPo90vXk5.mp4" />
<br>
- 通过事件订阅的方式监听员工入职、离职事件。
    <md-video src="//sf3-cn.feishucdn.com/obj/open-platform-opendoc/158ccc3e0b0b14e8d1a49876430ac0c4_gIyuMOi1QE.mp4" />

## 使用到的API列表

### 通讯录

**[方法 (API)](https://open.feishu.cn/document/ukTMukTMukTM/uITNz4iM1MjLyUzM)** | 权限要求 | **[访问凭证](https://open.feishu.cn/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)（选择其一）**
---|---|---
[创建部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/create)<br>`POST` /open-apis/contact/v3/departments<br>> 用于向通讯录中创建部门 | 更新通讯录(contact:contact) | `tenant_access_token`<br>`user_access_token`
[获取子部门列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/children)<br>`GET` /open-apis/contact/v3/departments/:department_id/children<br>> 通过部门ID获取部门的子部门列表 | 以应用身份读取通讯录(contact:contact:readonly_as_app) | `tenant_access_token`<br>`user_access_token`
[获取单个部门信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/get)<br>`GET` /open-apis/contact/v3/departments/:department_id<br>> 该接口用于向通讯录获取单个部门信息 | 以应用身份读取通讯录(contact:contact:readonly_as_app) | `tenant_access_token`<br>`user_access_token`
[修改部门部分信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/patch)<br>`PATCH` /open-apis/contact/v3/departments/:department_id<br>> 该接口用于更新通讯录中部门的信息 | 以应用身份读取通讯录(contact:contact:readonly_as_app) | `tenant_access_token`<br>`user_access_token`

### 事件

**[事件](https://open.feishu.cn/document/ukTMukTMukTM/uUTNz4SN1MjL1UzM)** | 权限要求
---|---
[员工入职](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/events/created)<br>`contact.user.created_v3`<br>> 通过该事件订阅员工入职 | 以应用身份读取通讯录(contact:contact:readonly_as_app)
[员工离职](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/user/events/deleted)<br>`contact.user.deleted_v3`<br>> 通过该事件订阅员工离职 | 以应用身份读取通讯录(contact:contact:readonly_as_app)