Skip to content

获取录制文件

获取一个会议的录制文件。

注意事项

  • 会议结束后并且收到了录制完成的事件方可获取录制文件。

  • 请求头 Authorization 参数不同 Token 说明:

    • 使用 user_access_token 时,只有会议归属人有权限获取录制文件。会议归属人是指预约会议时,请求参数传入的归属人(owner_id)。

    • 使用 tenant_access_token 时,可获取租户范围下的录制文件。

  • 录制时间太短(小于 5s)有可能无法生成录制文件。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/vc/v1/meetings/:meeting_id/recording
HTTP MethodGET
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用vc:record:readonly 获取会议录制信息

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
meeting_idstring会议ID(视频会议的唯一标识,视频会议开始后才会产生)
示例值:"6911188411932033028"

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ recordingmeeting.recording录制文件数据
    └ urlstring录制文件URL
    └ durationstring录制总时长(单位msec)

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "recording": {
            "url": "https://meetings.feishu.cn/minutes/obcn37dxcftoc3656rgyejm7",
            "duration": "30000"
        }
    }
}

错误码

HTTP状态码错误码描述排查建议
500121001internal error服务器内部错误,如果重试无效可联系管理员
400121002not support暂不支持该功能
400121003param error参数错误,检查参数的取值范围(请按照上面字段说明自查)
404121004data not exist请求的数据不存在
403121005no permission无权限进行该操作,建议检查token类型、操作者身份以及资源的归属
400122001meeting status unexpected会议状态不正确(例如:当会议不在进行中时,无法调用开始录制接口)
404122002meeting not exist所操作的会议不存在
400124002record processing录制文件生成中

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