说明:
账户级接口属于仅账户管理员可以使用的接口,是重量级接口,查询的信息量比较大,访问限制:10次/min。
接口描述
描述:获取账户的云录制记录,根据企业 ID 进行查询,支持根据时间区间分页获取。暂不支持 OAuth2.0 鉴权访问。
请求方式:GET
自建应用权限点:查看企业录制,管理企业录制。
接口操作者权限点:需具备录制管理的查看/编辑权限,可登录 管理后台 通过如下路径查看:账户管理 > 录制管理 > 查看/编辑权限。
接口请求域名:
https://api.meeting.qq.com/v1/corp/records?start_time={start_time}&end_time={end_time}&page_size={page_size}&page={page}&operator_id={operator_id}&operator_id_type={operator_id_type}
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
page_size | 否 | Integer | 分页大小,默认10,最大20。 |
page | 否 | Integer | 页码,从1开始,默认1。 |
start_time | 是 | Integer | 查询起始时间戳,UNIX 时间戳(单位秒);说明:时间区间不允许超过31天。 |
end_time | 是 | Integer | 查询结束时间戳,UNIX 时间戳(单位秒);说明:时间区间不允许超过31天。 |
query_record_type | 否 | Integer | 录制文件类型,默认为 1。 0:全部 1:云录制 2:上传录制 |
operator_id | 是 | String | 操作者 ID。 |
operator_id_type | 是 | Integer | 操作者 ID 类型。 1:userid |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
total_count | 是 | Integer | 分页查询返回数据总数。 |
current_size | 是 | Integer | 分页查询返回单页数据条数。 |
current_page | 是 | Integer | 分页查询返回当前页码。 |
total_page | 是 | Integer | 分页查询返回分页总数。 |
record_meetings | 否 | RecordMeetings 对象数组 | 会议录制列表。 |
RecordMeetings 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_record_id | 是 | String | 会议录制 ID。 |
meeting_id | 是 | String | 会议 ID。 |
meeting_code | 是 | String | 会议 code。 |
userid | 是 | String | 会议创建者用户 ID。 |
media_start_time | 是 | Number | 会议开始时间,UNIX 时间戳(单位毫秒)。 |
subject | 是 | String | 会议主题。 |
state | 是 | Integer | 录制状态: 1:录制中 2:转码中 3:转码完成 当状态为转码完成才会返回录制文件列表。 |
record_type | 是 | Integer | 返回的录制文件类型。 0:云录制 2:上传录制 |
record_files | 否 | RecordFiles 对象数组 | 录制文件列表。 |
RecordFiles 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
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表示永久有效。 |
view_address | 否 | String | 播放地址,开启共享时返回。 |
allow_download | 否 | bool | 是否允许下载,开启共享时返回。 |
download_address | 否 | String | 下载地址,过期时间6小时,允许下载和开启共享时返回。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
500 | 41 | 网络超时。 |
400 | 500014 | 账号无权限。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/corp/records?start_time=1611072000&end_time=1613750400&page_size=10&page=1&operator_id=KM4Ss4Th09ogUw1JiK&operator_id_type=1
输出示例
{"total_count": 2,"current_size": 10,"current_page": 1,"total_page": 1,"record_meetings": [{"meeting_record_id": "1362742106631111111","meeting_id": "6249027861881211111","meeting_code": "29858611111","media_start_time": 1613738006000,"subject": "test的快速会议","userid":"test","state": 3,"record_type":0,"record_files": [{"record_file_id": "1362742106635911111","record_start_time": 1613738011389,"record_end_time": 1613743058603,"record_size": 480236476,"sharing_state": 1,"sharing_url": "https://pre.txmeeting.tencent.com/user-center/shared-record-info?id=20bccca4-7bb5-4507-9b24-03111fd78515","required_same_corp": false,"required_participant": true,"password": "HHz4yo6d","sharing_expire": 0,"view_address":"https://.....","allow_download": false}]},{"meeting_record_id": "1362741760987500000","meeting_id": "18113044044021111111","meeting_code": "130156111","media_start_time": 1613737924000,"subject": "test的快速会议","userid":"test","state": 3,"record_type":0,"record_files": [{"record_file_id": "1362231760987501111","record_start_time": 1613737928980,"record_end_time": 1613737944556,"record_size": 1075029,"sharing_state": 1,"sharing_url": "https://pre.txmeeting.tencent.com/user-center/shared-record-info?id=fg25a7ef-326f-4a28-853c-4721dc6e0eb7","required_same_corp": false,"required_participant": true,"password": "Hwqbwpk8","sharing_expire": 0,"allow_download": true,"download_address": "https://yunluzhi-pre-az-1258344699.file.myqcloud.com/cos/1410212767/1362741760987504640/13627244760987504641/TM-20210219203204-130156700-recording-1.mp4?token=eJxsj1GTmjAURv9LngvchJAAM33orl3XXdStsnT1xUGCGgoJQpBCt_-901anL30938y95_xAcbS207redVKgEHVS7JRWWY4-_F0yI7VCIZroXpU6Fe8nY-o2dJyhU2U3nqRVN7mVjhYmnu9SyoLAPsgyt6vhnJW6E3amKyfTrYMpAMGEM-5glxFOMWcQ-NwDyij8h2EnnlsECAaCAwIuAWphF7DHOIDV5JluhFRHC9tVTd_x1bgV33ZpXf-p-ffyOpqhzlGIVp_vl6vJbDG9YVn9xphh1wcfuH-7JY8oRNWza-Yvl6UR8nB6gmBb7vdbwR-oSu699cp7GIPMlM3EFWcxFZ4s346TPtoUbwnphEthPfTTBzOqxIlVO3obPy285LVoe6Z6UnyK7i50Ulss8gc-NZBtOt_qZHhY4itvZEecZ_7okL-doCuaUyiSaxcGSvg5fiH4cL09O9Ojsm0K5d0PWruHjVTz_Xssm36UHkze3MBIw7qOfvwIAAP__vu2VQQ"}]}]}