查询主日历信息

获取当前身份的主日历信息。

错误码

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账户绑定关系没有找到，请检查输入参数是否正常

{ "code": 0, "msg": "success", "data": { "calendars": [ { "calendar": { "calendar_id": "feishu.cn_xxxxxxxxxx@group.calendar.feishu.cn", "summary": "测试日历", "description": "使用开放接口创建日历", "permissions": "private", "color": -1, "type": "shared", "summary_alias": "日历备注名", "is_deleted": false, "is_third_party": false, "role": "owner" }, "user_id": "ou_xxxxxx" } ] } }

请求参数

Query 参数

user_id_type

string

可选

用户 ID 类型示例值："open_id" 可选值有： open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？ user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？默认值：open_id 当值为 user_id，字段权限要求：获取用户 user ID

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

calendars

array [object {2}]

主日历列表

必需

查询主日历信息

错误码#

请求参数

返回响应

错误码