# 会议室业务域概述

## 会议室介绍

会议室 API 基于 WPS 会议室功能开放了对会议室、层级、预约、权限等资源的操作与查询能力。你能以应用或用户的身份调用会议室 API 来实现多种功能。例如：

- 设置会议室层级结构、创建管理会议室
- 配置会议室预约规则、使用限制
- 查询会议室预约、更新预约状态、提前释放会议室预约
- 设置会议室白名单、黑名单
- 订阅会议室事件

**资源关系说明：**

- **会议室层级**：组织会议室的层级结构，可自定义管理；例如可按楼层，也可按区域等维度划分。
- **会议室**：企业的线下会议场地资源，包含名称、位置、容量等信息。每个会议室归属于某个层级。
- **会议室设置**：会议室的配置参数，如预约规则、提前预约时长、是否需要审批等。
- **会议室预约**：会议室的预订记录，记录预约时间、预约人、预约状态等信息。
- **会议室白名单**：白名单用户在预定会议室时，不会受到预约时间段，最大可预约时间，会议室审批限制。
- **会议室黑名单**：黑名单用户将无法使用部分功能，目前支持限制其 预约会议室 的功能。

**会议室层级**组织**会议室**资源。每个**会议室**有自己的**会议室设置**，并可产生多个**会议室预约**记录。通过**会议室白名单**和**会议室黑名单**管理用户的预约权限。

<img src="https://cloudcdn.qwps.cn/open/_img/712484cb79.png" alt="会议室业务域资源关系图" />

## 业务模块

### 会议室

创建、查询、更新和删除会议室，批量查询会议室详情，根据条件搜索会议室。

[查看会议室详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room/introduce)

### 会议室层级

按照楼层、区域等维度组织会议室资源。支持创建、查询、更新、删除会议室层级，批量获取层级详情，多级层级组织。

[查看会议室层级详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room-level/introduce)

### 会议室设置

配置会议室的预约规则、使用限制等参数。支持批量查询会议室设置和更新会议室的配置参数。

[查看会议室设置详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room-setting/introduce)

### 会议室预约

管理会议室的预订信息。支持批量查询会议室预约信息，更新会议室预约状态，提前释放已预约的会议室。

[查看会议室预约详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room-booking/introduce)

### 会议室白名单

白名单用户在预定会议室时，不会受到预约时间段、最大可预约时间、会议室审批限制。支持创建、查询、删除白名单用户。

[查看会议室白名单详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room-privileged-user/introduce)

### 会议室黑名单

黑名单用户将无法使用部分功能，目前支持限制其预约会议室的功能。支持创建、查询、删除黑名单用户。

[查看会议室黑名单详细文档 →](/app-integration-dev/wps365/server/meeting-room/meeting-room-banned-user/introduce)

### 事件订阅

支持订阅以下事件：

- **会议室变更**：会议室的创建、更新、删除等状态变化
- **会议室层级变更**：会议室层级的创建、更新、删除等变化
- **会议室预定变更**：会议室预定的创建、更新、取消等状态变化

## 典型应用场景

### 1. 会议室数据同步到内部系统

企业内部系统（如办公平台、智慧园区系统等）需要获取最新的会议室信息：
- 首次同步：通过查询会议室层级列表接口获取层级结构，通过查询会议室列表接口批量获取所有会议室信息
- 增量同步：订阅会议室变更和层级变更事件，实时接收会议室的创建、更新、删除等变化
- 使用场景：企业大屏展示、智能导览系统、资产管理系统等需要实时会议室数据的场景

### 2. 会议室预约审批系统

企业对重要会议室实行审批制度，通过开放接口实现审批流程：
- 用户通过日历预订需要审批的会议室，预约状态为"审批中"
- 审批系统通过批量查询会议室预约接口获取待审批的预约记录
- 审批通过后，调用更新会议室预约状态接口将预约状态改为"成功"；拒绝则改为"失败"
- 会议结束后，可通过提前释放会议室接口提前释放未使用的会议室

### 3. 会议室使用权限管控

通过白名单和黑名单实现会议室的精细化权限管理：
- 高级会议室（如董事会会议室）：创建白名单用户，只有白名单用户可以预约，且不受预约时间、审批等限制
- 限制特定用户：将违规使用会议室的用户加入黑名单，限制其预约会议室的功能
- 按部门分配资源：为不同部门的专用会议室设置对应的白名单，实现会议室资源的合理分配
- 动态权限管理：通过获取白名单/黑名单列表接口，实时查询和调整权限配置