分块上传录制文件-预上传

最近更新时间:2024-07-08 11:48:52

我的收藏

接口描述

描述:
企业 secret 鉴权用户可上传文件到录制文件列表,不支持 OAuth。
适用于上传大于20MB的大文件场景,初始化分块上传,成功执行后返回上传事务 ID 和分块策略,用于后续上传分块请求,接口限频200次/分钟。
请求方式:POST
鉴权方式:JWT
接口请求域名:
https://api.meeting.qq.com/v1/files/records/upload-prepare


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
是否必须
参数类型
参数描述
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
operator_id_type
Integer
操作人 ID 类型:
1:userid
file_name
String
文件名+后缀,最多支持30个字符,base64 编码。
file_type
String
文件类型,支持以下枚举值:
voice:音频,最大 500M,支持上传 m4a、aiff、wma、ogg、aac、amr、wav、mp3 格式。
video:视频,最大 4GB,支持上传 mp4、flv、mov、ogg、avi、wmv、m4v、3gp、mpeg 格式。
file_size
Integer
文件大小(以字节为单位)需确保和实际文件大小相等。

输出参数

参数名称
参数类型
参数描述
upload_id
String
上传事务 ID。
block_size
Integer
分块大小策略(以字节为单位)。
block_num
Integer
分块数量。

示例

输入示例

POST
https://api.meeting.qq.com/v1/files/records/upload-prepare

{
"operator_id": "test",
"operator_id_type": 1,
"file_name":"xxxxxx.mp4",
"file_type":"video",
"file_size":11111
}

输出示例

{
"upload_id": "11111111111",
"block_size": 123,
"block_num":11
}