Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Gestión de reuniones/ APIs/ Consulta de la lista de archivos de grabación
Actualización más reciente 2023-01-31 GMT+08:00

Consulta de la lista de archivos de grabación

Descripción

Esta API se utiliza para consultar todos los archivos de grabación en el dominio de gestión de un administrador o consultar todos los archivos de grabación administrados por un usuario común. Si no se incluye ningún parámetro de consulta, los archivos de grabación dentro del ámbito de permisos se consultan de forma predeterminada.

Depuración

Puede depurar esta API en Explorador de API.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Direccion de solicitud

/v1/mmc/management/record/files

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

userUUID

No

String

Query

UUID de los usuarios que programan reuniones. Solo los administradores tienen los permisos para consultar el UUID de todos los usuarios de la misma empresa. Los usuarios comunes solo pueden consultar su propio UUID.

El valor predeterminado es el UUID de la cuenta de inicio de sesión.

offset

No

Integer

Query

Índice de página que se va a devolver.

Valor predeterminado: 0.

limit

No

Integer

Query

Número de registros a devolver. Valor predeterminado: 20. Valor máximo: 100.

queryAll

No

Boolean

Query

Si desea consultar las grabaciones de reuniones de todos los usuarios de su empresa.
NOTA:
  • Este parámetro sólo es válido cuando la cuenta de inicio de sesión es una cuenta de administrador de empresa.
  • Si el valor está establecido en true, el parámetro userUUID no es válido.

searchKey

No

String

Query

El tema de la reunión, el usuario que programa la reunión y el ID de la reunión se pueden utilizar como palabras clave.

startDate

long

Query

Hora de inicio de la consulta, en milisegundos.

endDate

long

Query

Hora de finalización de la consulta, en milisegundos.

sortType

No

String

Query

  • ASC_StartTIME Los registros se ordenan por hora de inicio en orden ascendente.
  • DSC_StartTIME: Los registros se ordenan por hora de inicio en orden descendente.

X-Access-Token

String

Header

Token de autorización. Utilice el valor de accessToken en la respuesta a la solicitud de Autenticación de un ID de aplicación.

X-Authorization-Type

No

String

Header

Si la solicitud se envía desde un portal de terceros.

X-Site-Id

No

String

Header

ID del sitio HCS Online donde se realiza la autenticación.

Códigos de estado

Tabla 3 Códigos de estado

Código de estado de HTTP

Descripción

200

Operación exitosa.

400

Parámetros no válidos

401

La autenticación no se realiza o falla.

403

Permisos insuficientes.

500

Excepción del servidor.

Parámetros de respuesta

Tabla 4 Parámetros de respuesta

Parámetro

Tipo

Descripción

offset

Integer

Índice de registro.

limit

Integer

Número de registros en cada página.

count

Integer

Número total de registros.

data

Array of RecordFileInfo objects

Lista de archivos de grabación.

Tabla 5 Estructura de datos de RecordFileInfo

Parámetro

Tipo

Descripción

confUUID

String

Reunión del UUID.

confID

String

ID de reunción

url

String[]

URL para ver el archivo de grabación.

rcdTime

Integer

Duración de la grabación, en segundos.

rcdSize

Integer

Tamaño del archivo de grabación, en MB.

subject

String

Tema de la reunión.

scheduserName

String

Usuario que programa la reunión.

startTime

String

Hora de inicio de la reunión.

isDecodeFinish

Boolean

Si el archivo de grabación es transcodificado.

decodeEndTime

long

Tiempo estimado cuando se completará la transcodificación de un archivo de grabación.

available

Boolean

Si se puede reproducir el archivo de grabación.

recordAuthType

Integer

Modo de autenticación de grabación. Este parámetro solo es válido cuando recordType está establecido en 2 o 3.

  • 0: Los usuarios que obtengan el enlace de la grabación pueden ver o descargar la grabación.
  • 1: Solo los usuarios empresariales pueden ver o descargar la grabación.
  • 2: Solo los participantes de la reunión pueden ver y descargar la grabación.

Solicitud de ejemplo

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)

Ejemplo de respuesta

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

Códigos de error

Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en el Centro de errores de la API de Huawei Cloud.

Ejemplo de comando 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'