订阅日程变更事件
POST
/calendar/v4/calendars/{calendar_id}/events/subscription
当前身份必须对日历有reader、writer或owner权限（调用获取日历接口，role字段可查看权限）。
错误码
| 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账户绑定关系没有找到，请检查输入参数是否正常 |
请求参数
Path 参数
返回响应
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/calendar/v4/calendars/feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn/events/subscription' \
--header 'Authorization: Bearer <token>'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {}
}
扫码加入交流群修改于 2025-10-21 06:44:09