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