会议室业务域概述
会议室介绍
会议室 API 基于 WPS 会议室功能开放了对会议室、层级、预约、权限等资源的操作与查询能力。你能以应用或用户的身份调用会议室 API 来实现多种功能。例如：
- 设置会议室层级结构、创建管理会议室
- 配置会议室预约规则、使用限制
- 查询会议室预约、更新预约状态、提前释放会议室预约
- 设置会议室白名单、黑名单
- 订阅会议室事件
资源关系说明：
- 会议室层级：组织会议室的层级结构，可自定义管理；例如可按楼层，也可按区域等维度划分。
- 会议室：企业的线下会议场地资源，包含名称、位置、容量等信息。每个会议室归属于某个层级。
- 会议室设置：会议室的配置参数，如预约规则、提前预约时长、是否需要审批等。
- 会议室预约：会议室的预订记录，记录预约时间、预约人、预约状态等信息。
- 会议室白名单：白名单用户在预定会议室时，不会受到预约时间段，最大可预约时间，会议室审批限制。
- 会议室黑名单：黑名单用户将无法使用部分功能，目前支持限制其 预约会议室 的功能。
会议室层级组织会议室资源。每个会议室有自己的会议室设置，并可产生多个会议室预约记录。通过会议室白名单和会议室黑名单管理用户的预约权限。
业务模块
会议室
创建、查询、更新和删除会议室，批量查询会议室详情，根据条件搜索会议室。
会议室层级
按照楼层、区域等维度组织会议室资源。支持创建、查询、更新、删除会议室层级，批量获取层级详情，多级层级组织。
会议室设置
配置会议室的预约规则、使用限制等参数。支持批量查询会议室设置和更新会议室的配置参数。
会议室预约
管理会议室的预订信息。支持批量查询会议室预约信息，更新会议室预约状态，提前释放已预约的会议室。
会议室白名单
白名单用户在预定会议室时，不会受到预约时间段、最大可预约时间、会议室审批限制。支持创建、查询、删除白名单用户。
会议室黑名单
黑名单用户将无法使用部分功能，目前支持限制其预约会议室的功能。支持创建、查询、删除黑名单用户。
事件订阅
支持订阅以下事件：
- 会议室变更：会议室的创建、更新、删除等状态变化
- 会议室层级变更：会议室层级的创建、更新、删除等变化
- 会议室预定变更：会议室预定的创建、更新、取消等状态变化
典型应用场景
1. 会议室数据同步到内部系统
企业内部系统（如办公平台、智慧园区系统等）需要获取最新的会议室信息：
- 首次同步：通过查询会议室层级列表接口获取层级结构，通过查询会议室列表接口批量获取所有会议室信息
- 增量同步：订阅会议室变更和层级变更事件，实时接收会议室的创建、更新、删除等变化
- 使用场景：企业大屏展示、智能导览系统、资产管理系统等需要实时会议室数据的场景
2. 会议室预约审批系统
企业对重要会议室实行审批制度，通过开放接口实现审批流程：
- 用户通过日历预订需要审批的会议室，预约状态为"审批中"
- 审批系统通过批量查询会议室预约接口获取待审批的预约记录
- 审批通过后，调用更新会议室预约状态接口将预约状态改为"成功"；拒绝则改为"失败"
- 会议结束后，可通过提前释放会议室接口提前释放未使用的会议室
3. 会议室使用权限管控
通过白名单和黑名单实现会议室的精细化权限管理：
- 高级会议室（如董事会会议室）：创建白名单用户，只有白名单用户可以预约，且不受预约时间、审批等限制
- 限制特定用户：将违规使用会议室的用户加入黑名单，限制其预约会议室的功能
- 按部门分配资源：为不同部门的专用会议室设置对应的白名单，实现会议室资源的合理分配
- 动态权限管理：通过获取白名单/黑名单列表接口，实时查询和调整权限配置