接口描述
描述:查询单个云录制的详情信息,包括录制文件和录制转写,并可获取播放地址和下载地址。企业 secret 鉴权用户可获取该用户所属企业下的单个录制列表,OAuth2.0 鉴权用户只能获取该企业下 OAuth2.0 应用的单个录制列表。
请求方式:GET
接口请求域名:
https://api.meeting.qq.com/v1/addresses/{record_file_id}?userid={userid}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
record_file_id | 是 | String | 录制文件 ID,列表接口返回的 record_file_id。 |
operator_id | 否 | String | 操作者 ID。operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 说明:userid 字段和 operator_id 字段二者必填一项。若两者都填,以 operator_id 字段为准。 |
operator_id_type | 否 | Integer | 操作者 ID 的类型: 3:rooms_id 说明:当前仅支持 rooms_id。如操作者为企业内 userid 或 openId,请使用 userid 字段。 |
userid | 否 | String | 操作者 ID,仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。 企业唯一用户标识说明: 1:企业对接 SSO 时使用的员工唯一标识 ID。 2:企业调用创建用户接口时传递的 userid 参数。 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
record_file_id | 是 | String | 录制文件 ID。 |
meeting_id | 是 | String | 会议 ID。 |
meeting_code | 是 | String | 会议 code。 |
view_address | 否 | String | 播放地址。 |
download_address | 否 | String | 录制文件下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
download_address_file_type | 否 | String | 下载视频文件格式,例如:mp4。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
audio_address | 否 | String | 音频下载地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
audio_address_file_type | 否 | String | 下载音频文件格式,例如:m4a。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
meeting_summary | 否 | MeetingSummary 对象数组 | 录制转写文件列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
ai_meeting_transcripts | 否 | MeetingTranscripts 对象数组 | 录制转写文件(智能优化版)列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
ai_minutes | 否 | Minutes 对象数组 | 智能纪要列表。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
MeetingSummary 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
download_address | 否 | String | 录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
file_type | 否 | String | 下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
MeetingTranscripts 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
download_address | 否 | String | 录制转写文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
file_type | 否 | String | 下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
Minutes 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
download_address | 否 | String | 智能纪要文件下载文件地址,链接有效期为5分钟。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
file_type | 否 | String | 下载文件类型,例如:txt、pdf、docx。OAuth 鉴权方式下,账号类型为个人免费版、企微创建免费企业时,该值返回为空。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
400 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
400 | 500014 | 账号无权限。 |
500 | 190001 | 存在未注册的用户。 |
500 | 960000 | 网络错误,请稍后重试。 |
500 | 190310 | 每分钟总接口调用次数超过限制。 |
500 | 4051 | 录制文件已经被删除。 |
500 | 4049 | 查询单条记录失败,不存在的记录。 |
500 | 41 | 网络超时。 |
500 | 403 | 没有资源操作权限。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/addresses/1318080811111111111?userid=user_test
输出示例
{"meeting_id":"1318080811111111111","meeting_code":"423411111","record_file_id":"1318080811111111111","view_address":"https://yunluzhi-brucetest...","download_address":"https://yunluzhi-brucetest...","download_address_file_type":"mp4","audio_address":"https://yunluzhi-brucetest...","audio_address_file_type":"m4a","meeting_summary":[{"download_address":"https://yunluzhi-brucetest...","file_type":"txt"}],"ai_meeting_transcripts":[{"download_address":"https://yunluzhi-brucetest...","file_type":"txt"}],"ai_minutes":[{"download_address":"https://yunluzhi-brucetest...","file_type":"txt"}]}