# 步骤三：获取部门信息

飞书的通讯录 OpenAPI 提供了丰富的部门查询方式，本章节主要介绍如何通过[搜索部门](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/search)获取部门信息。关于通讯录 OpenAPI 的详细介绍，参见[通讯录概述](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/resources)。
该 OpenAPI 通过用户访问凭证（user_access_token）进行鉴权，因此需要注意，如果管理员在后台配置了某一部门的可见范围，且当前登录的用户不在可见范围内，则无法通过该 OpenAPI 搜索到该部门。

## 操作步骤

1. 打开[API调试台](https://open.feishu.cn/api-explorer)工具。

2. 在左侧 **API 列表**，选择 **通讯录** > **部门** > **搜索部门**。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/9252ba7dc6f6fa76d70e4fd66d2a8453_te0euNaVor.png?height=1412&lazyload=true&maxWidth=600&width=2878)

3. 完成以下参数配置，并点击 **开始调试**。

- **请求头**：**Authorization** 默认已配置了用户访问凭证 **user_access_token**。
    - **查询参数**：本示例中，保持默认配置即可。
    - **请求体**：通过`query`参数设置部门关键词。例如，研发部，示例 JSON 配置如下。

```
        {
           "query": "研发部"
        }
        ```

调用成功的回显信息如下图所示。你需要获取并保存其中的`department_id`、`open_department_id`参数信息，后续用于向指定部门批量发送消息。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/9fa937ec6b896ac699b672ebdbcf63b6_ncF5TJyXdh.png?height=1420&lazyload=true&maxWidth=600&width=2882)