查询会议录制列表

最近更新时间:2024-08-01 14:47:31

我的收藏

接口描述

描述:
获取用户云录制记录,根据用户 ID、会议 ID、会议 code 进行查询,支持根据时间区间分页获取。
企业 secret 鉴权用户可获取该用户所属企业下的会议录制列表,OAuth2.0 鉴权用户只能获取该企业下 OAuth2.0 应用的会议录制列表。
当您想实时监测会议录制相关状况时,您可以通过订阅 录制管理 中的相关事件,接收事件通知。
当前同一场会议的不同录制文件共用分享链接。
请求方法:GET
接口请求域名:
https://api.meeting.qq.com/v1/records?page_size={page_size}&page={page}&meeting_id={meeting_id}&meeting_code={meeting_code}&userid={userid}&start_time={start_time}&end_time={end_time}


输入参数

以下请求参数列表仅列出了接口请求参数,HTTP 请求头公共参数请参见签名验证章节的 公共参数说明
参数名称
必选
参数类型
参数描述
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,仅会议创建者、企业超级管理员或有企业录制管理权限的用户可调用。当会议 ID 和会议 code 均为空时,表示查询用户所有会议的录制列表(企业内部请使用企业唯一用户标识;OAuth2.0 鉴权用户请使用 openId)。
企业唯一用户标识说明
1:企业对接 SSO 时使用的员工唯一标识 ID。
2:企业调用创建用户接口时传递的 userid 参数。
meeting_id
String
会议 ID,不为空时优先根据会议 ID 查询。
meeting_code
String
会议 code,当 meeting_id 为空且 meeting_code 不为空时根据会议 code 查询。
start_time
Integer
查询起始时间戳,UNIX 时间戳(单位秒)。
说明:时间区间不允许超过31天。
end_time
Integer
查询结束时间戳,UNIX 时间戳(单位秒)。
说明:时间区间不允许超过31天。
page_size
Integer
分页大小,默认值为10,最大为20。
page
Integer
页码,从1开始,默认值为1。
media_set_type
Number
会议类型:
0:全部
1:公网会议
2:专网会议
query_record_type
Integer
录制文件类型,默认为 1:
0:全部
1:云录制
2:上传录制

输出参数

参数名称
必选
参数类型
参数描述
total_count
Integer
分页查询返回数据总数。
current_size
Integer
分页查询返回单页数据条数。
current_page
Integer
分页查询返回当前页码。
total_page
Integer
分页查询返回分页总数。
record_meetings
RecordMeeting 对象列表
会议录制列表。

RecordMeeting 对象

参数名称
必选
参数类型
参数描述
meeting_record_id
String
会议录制 ID。
meeting_id
String
会议 ID。
meeting_code
String
会议 code。
media_set_type
Number
会议类型:
1:公网会议
2:专网会议
host_user_id
String
会议创建者 ID。
media_start_time
Integer
会议开始时间,UNIX 时间戳(单位毫秒)。
subject
String
会议主题。
state
Integer
录制状态:
1:录制中
2:转码中
3:转码完成
当状态为转码完成才会返回录制文件列表。
record_type
Integer
返回的录制文件类型。
0:云录制文件
2:上传录制文件
record_files
RecordFile 对象数组
录制文件列表。

RecordFile 对象

参数名称
必选
参数类型
参数描述
record_file_id
String
录制文件 ID。
record_start_time
Number
开始录制时间,UNIX 时间戳(单位毫秒)。
record_end_time
Number
结束录制时间,UNIX 时间戳(单位毫秒)。
record_size
Number
文件大小(单位字节)。
sharing_state
Integer
共享状态,是否开启共享。
0:未开启
1:开启
当开启共享时返回访问权限、访问密码、共享链接有效期、是否允许下载。
sharing_url
String
共享链接,开启共享时返回。
required_same_corp
Bool
仅企业用户可查看,开启共享时返回。
required_participant
Bool
仅参会成员可查看,开启共享时返回。
password
String
访问密码,开启共享时返回。
sharing_expire
Number
共享链接有效期(单位毫秒),当未开启共享时,返回0表示永久有效;开启共享时返回。
allow_download
Bool
是否允许下载,开启共享时返回。

错误码列表

状态码
错误码
错误描述
400
9042
无权限进行该操作,建议检查操作者身份或资源归属。
400
190004
参数非法,请对照接口文档检查您的参数。
400
500014
账号无权限。
400
200001
API 请求头缺失必填字段。
400
190301
请求重放错误,请求头里的 X-TC-Timestamp 和 X-TC-Nonce 每次请求时需重新生成,不能使用和过去五分钟内相同的 timestamp 和 nonce。
500
202004
OAuth 鉴权时查询 secret 信息失败。
500
190310
每分钟总接口调用次数超过限制。
500
960000
网络错误,请稍后重试。
500
50055
查询会议异常。
500
28
服务错误,请稍后重试。
500
41
网络超时。
500
190001
存在未注册的用户。

示例

输入示例

GET https://api.meeting.qq.com/v1/records?meeting_code=423111111&userid=testUser&start_time=1602950400&end_time=1603123200


输出示例

{
    "total_count":1,
    "current_size":10,
    "current_page":1,
    "total_page":1,
    "record_meetings":[
        {
            "meeting_record_id":"1318080818611111111",
            "meeting_id":"1360800130111111111",
            "meeting_code":"423111111",
            "host_user_id":"testUser",
            "media_start_time":1603089930093,
            "subject":"testUser的快速会议",
"state":3,
"record_type":0,
            "record_files":[
                {
                    "record_file_id":1318080818611111111,
                    "record_start_time":1603089930577,
                    "record_end_time":1603089967213,
                    "record_size":604081,
                    "sharing_state":1,
                    "required_same_corp":false,
                    "required_participant":false,
                    "password":"cK3wAsfw",
                    "sharing_expire":0,
                    "allow_download":false
                }
            ]
        }
    ]
}