获取日程列表
GET
/open-apis/calendar/v4/calendars/{calendar_id}/events
自建应用商店应用
错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 190001 | unexpected head in request | 检查calendar id是否填写正确 |
| 400 | 190002 | invalid parameters in request | 无效的请求参数，检查请求参数字段名称、传参类型是否正确，是否有相应资源权限，相应资源是否已删除 |
| 500 | 190003 | internal service error | 内部服务错误，请联系相关业务方oncall人员 |
| 429 | 190004 | method rate limited | 稍后再试，适当减小请求qps |
| 429 | 190005 | app rate limited | 稍后再试，适当减小请求qps |
| 403 | 190006 | wrong unit for app tenant | 请求错误，检查应用App ID和App Secret是否正确，无法解决请联系开放平台oncall解决 |
| 404 | 190007 | app bot_id not found | bot id没有找到，检查一下是否开启机器人能力[开发者后台>应用功能>机器人]，若仍没有解决，请联系开放平台oncall解决 |
| 400 | 190008 | page_token or sync_token expired | page_token或者sync_token已过期，请置空token再重试 |
| 400 | 190009 | sync token cannot be used with other request restrictions | sync token不可与其他有冲突参数一起使用，请检查请求参数 |
| 429 | 190010 | current operation rate limited | 当前操作被限流；限流原因：一般为公用资源并发抢占失败；解决办法：适当降低当前操作频率，然后重试 |
| 404 | 191000 | calendar not found | 日历没有找到，检查日历ID是否正确 |
| 400 | 191001 | invalid calendar_id | 无效的calendar id，检查日历id是否正确 |
| 403 | 191002 | no calendar access_role | 没有日历的访问权限，确保calendar id正确 |
| 403 | 191003 | calendar is deleted | 日历已经被删除，检查日历id是否正确 |
| 403 | 191004 | invalid calendar type | 日历类型错误，检查日历类型 |
| 400 | 191005 | subscribe calendars count rich limit | 订阅日历数量已达上限，请清理日历再重试 |
| 400 | 191006 | subscribe target calendar is not allowed | 不允许订阅（其他租户、私密）日历，查看日历类型 |
| 400 | 191007 | target calendar is already unsubscribed | 目标日历已经取消订阅，检查calendar id是否正确 |
| 404 | 192000 | acl not found | 没有相应acl，确保acl存在 |
| 400 | 193000 | invalid event_id | event id无效，检查event id |
| 404 | 193001 | event not found | 确保event id正确 |
| 403 | 193002 | no permission to operate event | 确保有日历编辑权限 |
| 403 | 193003 | event is deleted | 日程已经被删除，确认event id是否正确 |
| 404 | 194000 | attendee not found | 没有找到参与人 |
| 403 | 194001 | no permission to list event attendees | 检查calendar id是否是组织者日历或者是否有查看参与人权限 |
| 403 | 194002 | no permission to create event attendees | 检查calendar id是否是组织者日历或者是否有邀请参与人权限 |
| 403 | 194003 | no permission to delete event attendees | 检查calendar id是否是组织者日历 |
| 400 | 194004 | invalid attendee type | 检查参与人类型是否正确 |
| 403 | 195000 | no permission to delete timeoff event | 检查请假日程是否是该应用创建的 |
| 404 | 195100 | user is dismiss or not exist in the tenant | 当前身份或指定用户已经离职或者不在该租户 |
| 403 | 195101 | user is not supper administrator | 当前身份不是该租户超级管理员 |
| 400 | 195102 | exchange_binding_id invalid | exchange_binding_id无效，请检查id有效性 |
| 404 | 195103 | exchange account binding is not found | exchange账户绑定关系没有找到，请检查输入参数是否正常 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.feishu.cn/open-apis/calendar/v4/calendars/feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn/events' \
--header 'Authorization;'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"has_more": false,
"page_token": "ListCalendarsPageToken_1632452910_1632539310",
"sync_token": "ListCalendarsSyncToken_1632452910",
"items": [
{
"event_id": "00592a0e-7edf-4678-bc9d-1b77383ef08e_0",
"organizer_calendar_id": "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn",
"summary": "日程标题",
"description": "日程描述",
"start_time": {
"date": "2018-09-01",
"timestamp": "1602504000",
"timezone": "Asia/Shanghai"
},
"end_time": {
"date": "2018-09-01",
"timestamp": "1602504000",
"timezone": "Asia/Shanghai"
},
"vchat": {
"vc_type": "third_party",
"icon_type": "vc",
"description": "发起视频会议",
"meeting_url": "https://example.com"
},
"visibility": "default",
"attendee_ability": "can_see_others",
"free_busy_status": "busy",
"location": {
"name": "地点名称",
"address": "地点地址",
"latitude": 1.100000023841858,
"longitude": 2.200000047683716
},
"color": -1,
"reminders": [
{
"minutes": 5
}
],
"recurrence": "FREQ=DAILY;INTERVAL=1",
"status": "confirmed",
"is_exception": false,
"recurring_event_id": "1cd45aaa-fa70-4195-80b7-c93b2e208f45",
"create_time": "1602504000",
"schemas": [
{
"ui_name": "ForwardIcon",
"ui_status": "hide",
"app_link": "https://applink.feishu.cn/client/calendar/event/detail?calendarId=xxxxxx&key=xxxxxx&originalTime=xxxxxx&startTime=xxxxxx"
}
]
}
]
}
}请求参数
Path 参数
calendar_id
必需
示例值:
feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn
Query 参数
page_size
string
可选
示例值:
50
anchor_time
string
可选
示例值:
1609430400
page_token
string
可选
示例值:
ListCalendarsPageToken_1632452910_1632539310
sync_token
string
可选
示例值:
ListCalendarsSyncToken_1632452910
start_time
string
可选
示例值:
1631777271
end_time
string
可选
示例值:
1631777271
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
返回响应
扫码加入交流群修改于 2023-01-28 03:40:15