Help Center/ Meeting/ Server API Reference/ Meeting Management/ APIs/ Querying Recording File Details
Updated on 2023-12-22 GMT+08:00
Online Debugging
CLI Examples
View PDF

Querying Recording File Details

Description

This API is used to query details about a meeting recording.

Debugging

You can debug this API in API Explorer.

Prototype

Table 1 Prototype

Request Method

GET

Request Address

/v1/mmc/management/conferences/record/files

Transport Protocol

HTTPS

Request Parameters

Table 2 Parameters

Parameter

Mandatory

Type

Location

Description

confUUID

Yes

String

Query

UUID of a meeting, which can be obtained by calling the API for Querying the Recording File List.

userUUID

No

String

Query

UUID of a user.

NOTE:

This parameter will be discarded. Do not use it.

X-Access-Token

Yes

String

Header

Authorization token. Use the value of accessToken in the response to the request for Authenticating an App ID.

X-Authorization-Type

No

String

Header

Whether the request is sent from a third-party portal.

NOTE:

This parameter will be discarded. Do not use it.

X-Site-Id

No

String

Header

ID of the HCS Online site where the authentication is performed.

NOTE:

This parameter will be discarded. Do not use it.

Status Codes

Table 3 Status codes

HTTP Status Code

Description

200

Operation successful.

400

Invalid parameters.

401

Authentication is not performed or fails.

403

Insufficient permissions.

500

Server exception.

Response Parameters

Table 4 Response parameters

Parameter

Type

Description

confUUID

String

Meeting UUID.

confID

String

Meeting ID.

url

String[]

Recording playback URL.

rcdTime

Integer

Recording duration, in seconds.

rcdSize

Integer

Recording file size, in MB.

subject

String

Meeting topic.

scheduserName

String

Name of the meeting scheduler.

startTime

String

Meeting start time.

isDecodeFinish

Boolean

Whether the recording file is transcoded.

decodeEndTime

long

Estimated time when transcoding of a recording file will complete.

available

Boolean

Whether the recording file can be played.

recordAuthType

Integer

Authentication mode for watching or downloading the recording.

  • 0: Users who obtain the link of the recording can watch or download the recording.
  • 1: Only enterprise users can watch or download the recording.
  • 2: Only meeting participants can view and download the recording.

Example Request

GET /v1/mmc/management/conferences/record/files?confUUID=51adf610220411eaaae03f22d33cc26b
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)

Example Response

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

{
    "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's meeting",
    "scheduserName": "user8002",
    "startTime": "2019-12-19 02:07",
    "isDecodeFinish": true,
    "decodeEndTime": 1576721412885,
    "available": true,
    "recordAuthType":2
}

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.

Example cURL Command

curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences/record/files?confUUID=51adf610220411eaaae03f22d33cc26b'
Parent topic: APIs