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.
Actualización más reciente 2023-01-31 GMT+08:00

Consulta de la lista de reuniones

Descripción

  • Esta API se utiliza para consultar todas las reuniones en el dominio de administración de un administrador o para consultar todas las reuniones administradas por un usuario común. Si no se incluye ningún parámetro de consulta, las reuniones en curso y las reuniones que no se han iniciado se consultan de forma predeterminada.
  • Solo puede consultar reuniones en curso y próximas. Para obtener más información sobre cómo consultar reuniones históricas, consulte Consulta de la lista de reuniones históricas.

Depuración

Puede depurar esta API en API Explorer.

Prototipo

Tabla 1 Prototipo

Método de solicitud

GET

Dirección de solicitud

/v1/mmc/management/conferences

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 han programado reuniones. Solo los administradores tienen los permisos para consultar el UUID de todos los usuarios de la misma empresa. Otros usuarios solo pueden consultar su propio UUID.

offset

No

Integer

Query

Índice de registro que se va a devolver. El valor debe ser superior o igual a 0. Valor predeterminado: 0.

limit

No

Integer

Query

Número de registros a devolver. El valor predeterminado es 20 y el valor máximo es 500, que está definido por el servidor de Huawei Cloud Meeting.

queryAll

No

Boolean

Query

Si desea consultar los registros de reuniones de todos los usuarios de su empresa.

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 se establece en true, el parámetro de userUUID no es válido.

Valor predeterminado: false.

searchKey

No

String

Query

Cadena de palabra clave utilizada para la consulta. El valor puede contener de 1 a 128 caracteres.

queryConfMode

No

String

Query

  • ADAY: Se consultarán los registros del día anterior.
  • AWEEK: Los registros de la semana anterior serán consultados.
  • AMONTH: Se consultarán los registros del mes anterior.
  • ALL: Todos los registros serán consultados.

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 web de 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 invá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 ConferenceInfo objects

Lista de reuniones.

Ejemplo de solicitud

GET /v1/mmc/management/conferences
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: 2450
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 6fba0eff9f832b463580fb06c5b0ff9c
Server: api-gateway
X-Request-Id: ac9f75ec3c97c823f128526a924532b2

{
    "data": [
        {
            "conferenceID": "914083136",
            "mediaTypes": "Data,Video,Voice",
            "subject": "user01's meeting",
            "size": 1,
            "timeZoneID": "56",
            "startTime": "2019-12-18 07:28",
            "endTime": "2019-12-18 09:28",
            "conferenceState": "Created",
            "accessNumber": "+991117",
            "language": "zh-CN",
            "passwordEntry": [
                {
                    "conferenceRole": "chair",
                    "password": "157599"
                },
                {
                    "conferenceRole": "general",
                    "password": "582397"
                }
            ],
            "userUUID": "ff808081699b56cb0169be103500012b",
            "scheduserName": "user8002",
            "multiStreamFlag": 1,
            "conferenceType": 0,
            "confType": "IMMEDIATELY",
            "isAutoMute": 1,
            "isAutoRecord": 0,
            "chairJoinUri": "https://c.meeting.huaweicloud.com/#/j/914083136/6a30b8b5a325105da031442627828e496f91021ece36405f",
            "guestJoinUri": "https://c.meeting.huaweicloud.com/#/j/914083136/9505dc3349228b1ce0db8165590cc977bcff89785130fe0d",
            "recordType": 0,
            "recordAuxStream": 0,
            "confConfigInfo": {
                "isSendNotify": true,
                "isSendSms": true,
                "isAutoMute": true
            },
            "vmrFlag": 0,
            "scheduleVmr": false,
            "isHasRecordFile": false,
            "partAttendeeInfo": [
                {
                    "phone": "+991116003815",
                    "name": "user01",
                    "role": 0,
                    "isMute": 0,
                    "type": "normal"
                }
            ],
            "terminlCount": 0,
            "normalCount": 1,
            "deptName": "wangyue",
            "confUUID": "050c7898216811eaa6958bf3bb9ac167"
        }
    ],
    "offset": 0,
    "limit": 20,
    "count": 1
}

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 enCentro 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/conferences