预约会议

创建一个会议预约。
支持预约最近30天内的会议（到期时间距离当前时间不超过30天），预约到期后会议号将被释放，如需继续使用可通过"更新预约"接口进行续期；预约会议时可配置参会人在会中的权限，以达到控制会议的目的

错误码

HTTP状态码	错误码	描述	排查建议
500	121001	internal error	服务器内部错误，如果重试无效可联系管理员
400	121002	not support	暂不支持该功能
400	121003	param error	参数错误，检查参数的取值范围（请按照上面字段说明自查）
400	123002	record param error	录制参数错误，1v1呼叫暂不支持自动录制
400	123003	assign host exceed max limit 10	指定主持人数量超过最大限制，上限10
400	123004	assign host error	指定主持人错误，检查id是否合法

curl --location --request POST 'https://open.feishu.cn/open-apis/vc/v1/reserves/apply?user_id_type=open_id' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "end_time": "1608888867", "owner_id": "ou_3ec3f6a28a0d08c45d895276e8e5e19b", "meeting_settings": { "topic": "my meeting", "action_permissions": [ { "permission": 1, "permission_checkers": [ { "check_field": 1, "check_mode": 1, "check_list": [ "ou_3ec3f6a28a0d08c45d895276e8e5e19b" ] } ] } ], "meeting_initial_type": 1, "call_setting": { "callee": { "id": "ou_3ec3f6a28a0d08c45d895276e8e5e19b", "user_type": 1, "pstn_sip_info": { "nickname": "dodo", "main_address": "+86-02187654321" } } }, "auto_record": true, "assign_host_list": [ { "user_type": 1, "id": "ou_3ec3f6a28a0d08c45d895276e8e5e19b" } ] } }'

{ "code": 0, "msg": "success", "data": { "reserve": { "id": "6911188411934973028", "meeting_no": "112000358", "url": "https://vc.feishu.cn/j/337736498", "app_link": "https://applink.feishu.cn/client/videochat/open?source=openplatform&action=join&idtype=reservationid&id={?}&preview={?}&mic={?}&speaker={?}&camera={?}", "live_link": "https://meetings.feishu.cn/s/1gub381l4gglv", "end_time": "1608883322" } } }

请求参数

Query 参数

user_id_type

必需

用户ID类型，可用值：【open_id，union_id，user_id】，默认值：open_id

示例值:

open_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

Body 参数application/json

end_time

string

必需

预约到期时间（unix时间，单位sec），多人会议必填示例值："1608888867"

meeting_settings

object

会议设置

必需

topic

string

可选

会议主题示例值："my meeting"

action_permissions

array [object {2}]

可选

会议权限配置列表，如果存在相同的权限配置项则它们之间为"逻辑或"的关系（即有一个为true则拥有该权限）

meeting_initial_type

integer

可选

会议初始类型示例值：1 可选值有： 1：多人会议 2：1v1呼叫

call_setting

object

1v1呼叫相关参数

可选

auto_record

boolean

可选

使用飞书视频会议时，是否开启自动录制，默认false 示例值：true

assign_host_list

array [object {2}]

指定主持人列表

可选

owner_id

string

可选

指定会议归属人，使用tenant_access_token时生效且必传，使用user_access_token时不生效，必须指定为同租户下的合法lark用户示例值："ou_3ec3f6a28a0d08c45d895276e8e5e19b"

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

reserve

object

预约数据

必需

错误码#

请求参数

返回响应

错误码