分块上传录制文件-完成上传

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

我的收藏

接口描述

描述:
企业 secret 鉴权用户可上传文件到录制文件列表,不支持 OAuth。
触发完成上传,需要等所有分块上传成功后再调用该接口,接口限频200次/分钟。
录制文件上传结果可通过订阅通用 webhook 事件 异步任务结果 获取。录制文件上传场景的 business_code 值为:record.file-upload请参考下面示例中具体键值对的映射含义。
注意:
本接口为限时免费接口。
请求方式:POST
鉴权方式:JWT
接口请求域名:
https://api.meeting.qq.com/v1/files/records/upload-finish


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
是否必须
参数类型
参数描述
operator_id
String
操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。
operator_id_type
Integer
操作人 ID 类型:
1:userid
upload_id
String
上传事务 ID。
speak_number
Integer
上传文件中的发言人数:传具体数值代表几人发言,最多支持12人,其中0代表多人发言。
ai_record
Boolean
自动生成智能转写和智能纪要: true:自动生成(默认) false:不生成

输出参数

参数名称
参数类型
参数描述
job_id
String
任务 ID。


示例

输入示例

POST
https://api.meeting.qq.com/v1/files/records/upload-finish
{
"operator_id": "test",
"operator_id_type": 1,
"upload_id":"11111111",
"speak_number":2,
"ai_record":true
}


输出示例

{
"job_id": "QNLLdhFLAJh9azYd6_xxxxxxxxxP6VbZMdqNiyltVM"
}

webhook 示例

本接口采用公共事件 异步任务结果,当 business_code 值为 record.file-upload 时,对应键值对的映射含义:
{
"event": "common.job-results",
"trace_id": "e7aa65dd-f7e6-4b62-912c-2035173b34a9",
"payload": [
{
"operate_time": 1609313201465,
"business_code": "record.file-upload", // 代表录制文件上传场景唯一标识,用于区分不同场景下返回的键值对含义
"job_id": "xxxxxxxxxx", // 与异步操作关联的唯一id
"job_status": 1, // 异步操作结果 1 成功 2 失败
"error_msg": "", // 异步操作失败的错误信息
"notify_info": { // 推送具体的任务信息
"success": [
[
{
"key": "file_name",
"value": "xxxxx"
},
{
"key": "meeting_record_id",
"value": "xxxx"
},
{
"key": "record_file_id",
"value": "xxxx"
}
]
],
"failed": [
[
{
"key": "error_code",
"value": "xxxx"
},
{
"key": "error_msg",
"value": "xxxx"
},
{
"key": "file_name",
"value": "xxxx"
},
{
"key": "meeting_record_id", //部分失败场景不会返回该键值对
"value": "xxxx"
},
{
"key": "record_file_id", //部分失败场景不会返回该键值对
"value": "xxxx"
}
]
]
}
}
]
}