#  获取公共日历日程列表
**注意事项**：为了更好地提升该接口的安全性与开放性，我们对其进行了升级。请尽快迁移至[新版本>>](https://open.larksuite.com/document/ukTMukTMukTM/uETM3YjLxEzN24SMxcjN)
该接口用于获取公共日历下的日程列表。

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/calendar/v3/shared/calendars/:calendarId/events
HTTP Method | GET

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 路径参数
|参数|类型|必须|说明|
|--|-----|--|----|---|
|calendarId|string|是|日历 ID|请求 URL|
### 请求体
**请求参数说明** :  <br>
|参数|类型|必须|说明|
|--|-----|--|----|---|
|max_results|string|否|一次请求要求返回最大数，该参数不能大于 1000，默认 500|请求参数|
|page_token|string|否|用于标志当次请求从哪页开始|请求参数|
|sync_token|string|否|表示从上次返回的截止页起，返回结果|请求参数|
**page_token && sync_token:**<br>
使用 page_token/sync_token 可以方便开发者以“分页”的形式获取日程列表。

假如当次请求返回的结果未包含最后一个日程，response 中会携带 page_token，代表当前分页；下次请求时带上此 page_token 可以访问下个分页，依此类推。

若 response 中携带了 sync_token，代表当次请求已经是最后分页。若以后还有新增日程，可以通过携带 sync_token 继续访问。

## 响应
### 响应体
**返回参数说明**:<br>
同[获取日程](https://lark-open.bytedance.net/document/ukTMukTMukTM/ucTM14yNxUjL3ETN)
### 响应体示例 
```json
{
    "code": int,
    "msg": string,
    "page_token": string,
    "sync_token": string,
    "data": [
        {
          "id": "0d0880f7-7808-4a4e-b5b3-0bf914af6cdc",
          "summary": "Hellobot4",
          "description": "hellobot4",
          "visibility": "default",
          "start": {
            "time_stamp": 1553853600,
            "date":"2019-01-01",
            "time_zone": "Asia/Shanghai"
          },
          "end": {
            "time_stamp": 1553860800,
            "date":"2019-01-01",
            "time_zone": "Asia/Shanghai"
          },
          "attendees": [
            {
              "open_id": "ou_e0fa9ec21d95d6f6f212ea306ee58193",
              "employee_id":"59e21cd8",
              "optional": true,
              "display_name": "wangfei.fai"
            }
          ]
        }
    ]
}
```
### 错误码

具体可参考：[服务端错误码说明](https://open.larksuite.com/document/ukTMukTMukTM/ugjM14COyUjL4ITN)