# 批量查询会议室预约



**标签**：`会议室预约` 


## 请求说明
| 字段          | 值                  |
|--------------|---------------------|
| **<div style="white-space: nowrap;">请求地址</div>**  | https://openapi.wps.cn/v7/meeting_room_bookings/batch_get          |
| **<div style="white-space: nowrap;">HTTP 方法</div>** | `POST`    |
| **<div style="white-space: nowrap;">接口描述</div>**  | 批量查询会议室预约 |
| **<div style="white-space: nowrap;">签名方式</div>**  | [KSO-1](https://open.wps.cn/documents/app-integration-dev/wps365/server/api-description/signature-description) |
| **<div style="white-space: nowrap;">限频策略</div>** | 无 |
| **<div style="white-space: nowrap;">权限要求</div>** | <div><div>查询会议室(应用授权) `kso.meeting_rooms.read`</div><div style="margin-top: 5px;"></div><div>查询和管理会议室(应用授权) `kso.meeting_rooms.readwrite`</div></div> |


## 请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|-------|------|------|-------|-------|
| <div style="white-space: nowrap;">X-Kso-Id-Type</div> | `string` | 否 | 类型<br>  * **internal** - 内部<br>  * **external** - 外部<br> | `internal`, `external` 







## 请求体(Body)
**请求体格式:** `application/json`
<OpenapiRenderTable  dataSource='[{"key":"end_time","name":"end_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>结束时间 Unix时间戳 秒数</p>\n","children":[]},{"key":"include_deleted","name":"include_deleted","deprecated":false,"type":"boolean","required":"否","enum":[],"xEnum":[],"description":"<p>是否包含已删除的预约，默认不包含(false)</p>\n","children":[]},{"key":"page_size","name":"page_size","deprecated":false,"type":"integer","required":"否","enum":[],"xEnum":[],"description":"<p>每页数量，默认20</p>\n","children":[]},{"key":"page_token","name":"page_token","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>分页凭证</p>\n","children":[]},{"key":"results","name":"results","deprecated":false,"type":"array[string]","required":"否","enum":["success","failed","approving"],"xEnum":["success","failed","approving"],"description":"-","children":[]},{"key":"room_ids","name":"room_ids","deprecated":false,"type":"array[string]","required":"否","enum":[],"xEnum":[],"description":"<p>会议室id列表（和room_level_id二选一）</p>\n","children":[]},{"key":"room_level_id","name":"room_level_id","deprecated":false,"type":"string","required":"否","enum":[],"xEnum":[],"description":"<p>会议室层级id（和room_ids二选一）</p>\n","children":[]},{"key":"start_time","name":"start_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>开始时间 Unix时间戳 秒数</p>\n","children":[]}]' />

## 请求体示例
```json
{
  "end_time": 0,
  "include_deleted": true,
  "page_size": 0,
  "page_token": "string",
  "results": [
    "string"
  ],
  "room_ids": [
    "string"
  ],
  "room_level_id": "string",
  "start_time": 0
}
```

## 响应体(Response)
**HTTP状态码:** `200`<br/>
**响应体格式:** `application/json`
<OpenapiRenderTable hideHeaderKeys='required' dataSource='[{"key":"data","name":"data","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"-","children":[{"key":"data.items","name":"items","deprecated":false,"type":"array[object]","required":"是","enum":[],"xEnum":[],"description":"<p>预约信息列表</p>\n","children":[{"key":"data.items.items.accept_count","name":"accept_count","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>接受邀约人数</p>\n","children":[]},{"key":"data.items.items.calendar_id","name":"calendar_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>日历id</p>\n","children":[]},{"key":"data.items.items.create_time","name":"create_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>预约日程的创建时间 Unix时间戳 毫秒级</p>\n","children":[]},{"key":"data.items.items.delete_time","name":"delete_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>删除时间 Unix时间戳 毫秒级，表示预约被删除的时间</p>\n","children":[]},{"key":"data.items.items.dept_name","name":"dept_name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>预定人所属部门名称</p>\n","children":[]},{"key":"data.items.items.end_time","name":"end_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>预约结束时间 Unix时间戳 毫秒级</p>\n","children":[]},{"key":"data.items.items.event_id","name":"event_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>日程id</p>\n","children":[]},{"key":"data.items.items.fail_reason","name":"fail_reason","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>预约会议室失败原因，当result为failed时有效</p>\n","children":[]},{"key":"data.items.items.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>会议室预约id</p>\n","children":[]},{"key":"data.items.items.invite_count","name":"invite_count","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>邀约人数</p>\n","children":[]},{"key":"data.items.items.is_recurring","name":"is_recurring","deprecated":false,"type":"boolean","required":"是","enum":[],"xEnum":[],"description":"<p>是否重复日程，true表示是重复日程</p>\n","children":[]},{"key":"data.items.items.result","name":"result","deprecated":false,"type":"string","required":"是","enum":["success","failed","approving"],"xEnum":["success","failed","approving"],"description":"<p>会议室预约结果:<br></p>\n<ul>\n<li>success:预约成功<br></li>\n<li>failed:预约失败<br></li>\n<li>approving:审批中<br></li>\n</ul>\n","children":[]},{"key":"data.items.items.room_id","name":"room_id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>会议室id</p>\n","children":[]},{"key":"data.items.items.room_name","name":"room_name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>会议室名称</p>\n","children":[]},{"key":"data.items.items.sign_in_status","name":"sign_in_status","deprecated":false,"type":"string","required":"是","enum":["wait","success","release",""],"xEnum":["wait","success","release","empty"],"description":"<p>会议室签到状态:<br></p>\n<ul>\n<li>wait:未签到<br></li>\n<li>success:已签到<br></li>\n<li>release:未签到释放<br></li>\n<li>为空:无需签到<br></li>\n</ul>\n","children":[]},{"key":"data.items.items.sign_time","name":"sign_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>会议室签到时间 Unix时间戳 毫秒级</p>\n","children":[]},{"key":"data.items.items.start_time","name":"start_time","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"<p>预约开始时间，最大查询时长14天 Unix时间戳 毫秒级</p>\n","children":[]},{"key":"data.items.items.summary","name":"summary","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>主题</p>\n","children":[]},{"key":"data.items.items.user","name":"user","deprecated":false,"type":"object","required":"是","enum":[],"xEnum":[],"description":"<p>预约人信息</p>\n","children":[{"key":"data.items.items.user.id","name":"id","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>用户id</p>\n","children":[]},{"key":"data.items.items.user.user_name","name":"user_name","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>用户姓名</p>\n","children":[]}]}]},{"key":"data.next_page_token","name":"next_page_token","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>下一页凭证，该参数不存在或为空串时表示没有下一页</p>\n","children":[]}]},{"key":"code","name":"code","deprecated":false,"type":"integer","required":"是","enum":[],"xEnum":[],"description":"-","children":[]},{"key":"msg","name":"msg","deprecated":false,"type":"string","required":"是","enum":[],"xEnum":[],"description":"<p>人可阅读的文本信息，可能会按不同的语言或地区返回不同的文本信息。</p>\n","children":[]}]' />

## 响应体示例
```json
{
  "data": {
    "items": [
      {
        "accept_count": 0,
        "calendar_id": "string",
        "create_time": 0,
        "delete_time": 0,
        "dept_name": "string",
        "end_time": 0,
        "event_id": "string",
        "fail_reason": "string",
        "id": "string",
        "invite_count": 0,
        "is_recurring": true,
        "result": "success",
        "room_id": "string",
        "room_name": "string",
        "sign_in_status": "wait",
        "sign_time": 0,
        "start_time": 0,
        "summary": "string",
        "user": {
          "id": "string",
          "user_name": "string"
        }
      }
    ],
    "next_page_token": "string"
  },
  "code": 0,
  "msg": "string"
}
```