查询录制列表 - SearchRecordings

描述

该接口用于查询会议录制列表。管理员可以查询本企业内所有的录制，普通用户仅能查询自己创建的会议的录制。不带查询参数时，默认查询权限范围内的录制。

调试

您可以在API Explorer中调试该接口。

URI

GET /v1/mmc/management/record/files

请求参数

表1 参数说明
参数	是否必须	类型	位置	描述
userUUID	否	String	Query	用户的UUID。说明：仅管理员有权限查询本企业其他用户的会议录制；普通账号该字段无效，只能查询自己的。
offset	否	Integer	Query	查询偏移量。默认为0。
limit	否	Integer	Query	查询数量。默认是20，最大500条。
queryAll	否	Boolean	Query	是否查询企业下所有用户的会议录制。 true：查询所有用户的会议录制 false：仅查询管理员自己的会议录制说明：仅对企业管理员生效。
searchKey	否	String	Query	查询条件。会议主题、会议预约人和会议ID等可作为搜索内容。
startDate	是	long	Query	查询的起始时间戳（单位毫秒）。
endDate	是	long	Query	查询的截止时间戳（单位毫秒）。
sortType	否	String	Query	查询结果排序类型。 ASC_StartTIME：按录制开始时间升序排序 DSC_StartTIME：按录制开始时间降序排序
X-Access-Token	是	String	Header	授权令牌。获取“执行App ID鉴权”响应的accessToken。
X-Authorization-Type	否	String	Header	标识是否为第三方portal过来的请求。说明：该参数将废弃，请勿使用。
X-Site-Id	否	String	Header	用于区分到哪个HCSO站点鉴权。说明：该参数将废弃，请勿使用。

状态码

表2 状态码说明
HTTP状态码	描述
200	操作成功。
400	参数异常。
401	未鉴权或鉴权失败。
403	权限受限。
500	服务端异常。

响应参数

表3 响应参数
参数	类型	描述
offset	Integer	查询偏移量。
limit	Integer	每页的记录数。
count	Integer	总记录数。
data	Array of RecordFileInfo objects	录播文件列表。

表4 RecordFileInfo 数据结构
参数	类型	描述
confUUID	String	会议UUID。
confID	String	会议ID。
url	String[]	录播观看地址。
rcdTime	Integer	录制时长（单位秒）。
rcdSize	Integer	录制文件大小（MB）。
subject	String	会议主题。
scheduserName	String	会议预订者名称。
startTime	String	会议开始时间。
isDecodeFinish	Boolean	录制文件是否转码完成。
decodeEndTime	long	录制文件预计转码完成时间。
available	Boolean	录播文件是否可观看。
recordAuthType	Integer	录播观看鉴权方式，在录播类型为:录播、直播+录播时有效。 0：可通过链接观看/下载 1：企业用户可观看/下载 2：与会者可观看/下载

请求消息示例

GET /v1/mmc/management/record/files?startDate=1574092800000&endDate=1576771199999
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 683
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 25b89efb63970d80e715503650157098
Server: api-gateway
X-Request-Id: a9af536f02e45c516513a8248bfe04c3

{
    "offset": 0,
    "limit": 20,
    "count": 1,
    "data": [
        {
            "confUUID": "51adf610220411eaaae03f22d33cc26b",
            "confID": "912049654",
            "url": [
                "https://114.116.237.2/rse/rse/html/play/Mediaxplay.html?rseid=00030&recordId=000301fa-0512-412f-b363-cb9f76063628&token=24e4f6d9850a42365783c88ceb36701bb87f5393a595af82&confID=51adf610220411eaaae03f22d33cc26b&isSecure=true"
            ],
            "rcdTime": 71,
            "rcdSize": 0,
            "subject": "user8002的会议",
            "scheduserName": "user8002",
            "startTime": "2019-12-19 02:07",
            "isDecodeFinish": false,
            "decodeEndTime": 1576721412885,
            "available": true,
            "recordAuthType":2
        }
    ]
}

错误码

当您使用华为云会议服务端API时，如果遇到“MMC”或者“USG”开头的错误码，请参考华为云API错误中心。

CURL命令示例

curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://api.meeting.huaweicloud.com/v1/mmc/management/record/files?startDate=1574092800000&endDate=1576771199999'

父主题：接口参考

上一篇：查询在线会议详情 - ShowOnlineMeetingDetail

下一篇：查询录制详情 - ShowRecordingDetail