查看日程忙闲

查看指定用户或会议室在某时间段内的忙闲状态，时间区间不超过 7 天。

通过 WPS 365 官方 OpenAPI（v7）管理通讯录与组织、云文档、多维表/智能表格、消息、会议、日历、邮件、待办、审批与事件订阅；官方机器契约为 open.wps.cn 发布的 OpenAPI 3.0.0（827 个 Endpoint / 3,119 个 Schema）。企业数据为私有业务数据，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。

请求

operationId: calendarFreeBusyList
服务器: https://openapi.wps.cn
认证: app, delegated

请求参数

`start_time`

querystringdatetime必填

开始时间（RFC3339）。

2026-08-16T00:00:00.000Z

`end_time`

querystringdatetime必填

结束时间（RFC3339）。

2026-08-16T00:00:00.000Z

`user_ids`

queryarray

user ids。

`room_ids`

queryarray

room ids。

`X-Kso-Id-Type`

headerid_type

响应

`200`

list_free_busy_resp_bodyapplication/json

请求成功。

字段: data

`default`

unknownapplication/json

上游服务返回该状态。

{
  "data": {
    "items": {
      "busy_times": {},
      "room_id": "example-id-0123456789",
      "user_id": "example-id-0123456789"
    }
  }
}