Skip to content

查询会议室日程主题和会议详情

调用该接口使用日程的 Uid 和 Original time 查询会议室日程主题与详情。

Note 日程 ID(event_id)格式为 <Uid>_<Original time>,因此你可以通过 event_id 获取日程的 Uid 和 Original time。例如,日程 ID 为 c32537e6-e0a8-4506-b42f-47440655cdb4_0 ,则 Uid 为 c32537e6-e0a8-4506-b42f-47440655cdb4、Original time 为 0

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/meeting_room/summary/batch_get
HTTP MethodPOST
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用calendar:room 管理会议室信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

参数参数类型必须说明
EventUids-需要查询的日程 Uid 和 Original time 列表。
∟uidstring日程的唯一 ID。
∟original_timeint日程实例原始时间。非重复性日程和重复性日程,此处传 0;重复性日程的例外日程,需要传入对应的 original_time 值(时间戳类型)。

请求体示例

json
{
	"EventUids":[
		{
			"uid":"a04dbea1-86b9-4372-aa8d-64ebe801be2a",
			"original_time":0
		},
        {
			"uid":"d7a44c9b-7ae0-4a97-bf80-b4f050cedffa",
			"original_time":0
		}
	]
}

响应

响应体

参数参数类型说明
codeint返回码,非 0 表示失败。
msgstring返回码的描述,success 表示成功,其他为错误提示信息。
data-返回信息。
∟EventInfos-查询到的日程信息。
∟∟uidstring日程的唯一 ID。
∟∟original_timeint日程实例原始时间。非重复性日程和重复性日程,此处为 0;重复性日程的例外日程,此处为对应的 original_time 值(时间戳类型)。
∟∟summarystring日程主题。
∟∟vchatvhcat视频会议信息。
∟∟∟vc_typestring视频会议类型。
可选值有:
- vc:飞书视频会议。取该类型时,vchat 内的其他字段均无效。
- third_party:第三方链接视频会议。取该类型时,仅生效 vchat 内的 icon_type、description、meeting_url 字段。
- no_meeting:无视频会议。取该类型时,vchat 内的其他字段均无效。
- lark_live:飞书直播。该值用于客户端,只读参数。
- unknown:未知类型。该值用于客户端做兼容使用,只读参数。
∟∟∟icon_typestring第三方视频会议 icon 类型。
可选值有:
- vc:飞书视频会议 icon
- live:直播视频会议 icon
- default:默认 icon
∟∟∟descriptionstring第三方视频会议文案。
∟∟∟meeting_urlstring视频会议 URL。
∟ErrorEventUids-没有查询到的日程信息。
∟∟uidstring日程的唯一 ID。
∟∟original_timeint日程实例原始时间。非重复性日程和重复性日程,此处为 0;重复性日程的例外日程,此处为对应的 original_time 值(时间戳类型)。
∟∟error_msgstring错误信息。

响应体示例

json
{
    "code": 0,
    "data": {
        "ErrorEventUids": [],
        "EventInfos": [
            {
                "original_time": 0,
                "summary": "test",
                "uid": "a04dbea1-86b9-4372-aa8d-64ebe801be2a",
                "vchat": {
                    "meeting_url": "https://vc.feishu.cn/j/935314044",
                    "vc_type": "vc"
                }
            },
            {
                "original_time": 0,
                "summary": "日程",
                "uid": "d7a44c9b-7ae0-4a97-bf80-b4f050cedffa",
                "vchat": {
                    "meeting_url": "https://vc.feishu.cn/j/777110140",
                    "vc_type": "vc"
                }
            }
        ]
    },
    "msg": ""
}

错误码

可前往查阅通用错误码

内容来源:飞书开放平台 · 自动爬取整理