查询会议室日程主题和会议详情
调用该接口使用日程的 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 URL | https://open.feishu.cn/open-apis/meeting_room/summary/batch_get |
| HTTP Method | POST |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 | calendar:room 管理会议室信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
| Content-Type | string | 是 | 固定值:"application/json; charset=utf-8" |
请求体
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| EventUids | - | 是 | 需要查询的日程 Uid 和 Original time 列表。 |
| ∟uid | string | 是 | 日程的唯一 ID。 |
| ∟original_time | int | 是 | 日程实例原始时间。非重复性日程和重复性日程,此处传 0;重复性日程的例外日程,需要传入对应的 original_time 值(时间戳类型)。 |
请求体示例
json
{
"EventUids":[
{
"uid":"a04dbea1-86b9-4372-aa8d-64ebe801be2a",
"original_time":0
},
{
"uid":"d7a44c9b-7ae0-4a97-bf80-b4f050cedffa",
"original_time":0
}
]
}响应
响应体
| 参数 | 参数类型 | 说明 |
|---|---|---|
| code | int | 返回码,非 0 表示失败。 |
| msg | string | 返回码的描述,success 表示成功,其他为错误提示信息。 |
| data | - | 返回信息。 |
| ∟EventInfos | - | 查询到的日程信息。 |
| ∟∟uid | string | 日程的唯一 ID。 |
| ∟∟original_time | int | 日程实例原始时间。非重复性日程和重复性日程,此处为 0;重复性日程的例外日程,此处为对应的 original_time 值(时间戳类型)。 |
| ∟∟summary | string | 日程主题。 |
| ∟∟vchat | vhcat | 视频会议信息。 |
| ∟∟∟vc_type | string | 视频会议类型。 可选值有: - vc:飞书视频会议。取该类型时,vchat 内的其他字段均无效。- third_party:第三方链接视频会议。取该类型时,仅生效 vchat 内的 icon_type、description、meeting_url 字段。- no_meeting:无视频会议。取该类型时,vchat 内的其他字段均无效。- lark_live:飞书直播。该值用于客户端,只读参数。- unknown:未知类型。该值用于客户端做兼容使用,只读参数。 |
| ∟∟∟icon_type | string | 第三方视频会议 icon 类型。 可选值有: - vc:飞书视频会议 icon- live:直播视频会议 icon - default:默认 icon |
| ∟∟∟description | string | 第三方视频会议文案。 |
| ∟∟∟meeting_url | string | 视频会议 URL。 |
| ∟ErrorEventUids | - | 没有查询到的日程信息。 |
| ∟∟uid | string | 日程的唯一 ID。 |
| ∟∟original_time | int | 日程实例原始时间。非重复性日程和重复性日程,此处为 0;重复性日程的例外日程,此处为对应的 original_time 值(时间戳类型)。 |
| ∟∟error_msg | string | 错误信息。 |
响应体示例
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": ""
}错误码
可前往查阅通用错误码。
