Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Meeting/ Referência de API do servidor/ Gerenciamento de reunião/ APIs/ Consulta da lista de reuniões em andamento
Atualizado em 2023-08-02 GMT+08:00

Consulta da lista de reuniões em andamento

Descrição

Esta API é usada para consultar todas as reuniões em andamento no domínio de gerenciamento de um administrador ou consultar todas as reuniões em andamento gerenciadas por um usuário comum. Se nenhum parâmetro de consulta não for especificado, as reuniões em andamento dentro do escopo de permissões serão consultadas por padrão. Os registros da reunião são classificados por hora de início em ordem crescente.

Depuração

Você pode depurar essa API no API Explorer.

Protótipo

Tabela 1 Protótipo

Método de solicitação

GET

Endereço de solicitação

/v1/mmc/management/conferences/online

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

userUUID

Não

String

Consulta

UUID de um usuário.

NOTA:

Somente os administradores têm as permissões para consultar o UUID de todos os usuários na mesma empresa. Usuários comuns só podem consultar seu próprio UUID.

offset

Não

Integer

Consulta

Índice de registro para retornar. O valor deve ser superior ou igual a 0. Valor padrão: 0.

limit

Não

Integer

Consulta

Número de registros a serem devolvidos. Valor padrão: 20. Valor máximo: 500.

queryAll

Não

Boolean

Consulta

Se deve consultar registros de reunião de todos os usuários em sua empresa.

Este parâmetro é válido apenas quando a conta de início de sessão é uma conta de administrador empresarial.

Se o valor for definido como true, o parâmetro userUUID será inválido.

Valor padrão: false.

searchKey

Não

String

Consulta

Cadeia de palavra-chave usada para consulta. O tópico da reunião, o usuário que agenda a reunião e o ID da reunião podem ser usados como palavras-chave.

X-Access-Token

Sim

String

Cabeçalho

Token de autorização. Use o valor de accessToken na resposta à solicitação de Autenticação de um ID de aplicação.

X-Authorization-Type

Não

String

Cabeçalho

Se a solicitação é enviada de um portal de terceiros.

X-Site-Id

Não

String

Cabeçalho

ID do site do HCS on-line onde a autenticação é realizada.

Códigos de status

Tabela 3 Códigos de status

Código de status HTTP

Descrição

200

Operação bem-sucedida.

400

Parâmetros inválidos.

401

A autenticação não é executada ou falha.

403

Permissões insuficientes.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

offset

Integer

Índice de registro.

limit

Integer

Número de registros em cada página.

count

Integer

Número total de registros.

data

Array of ConferenceInfo objects

Lista de reuniões.

Exemplo de solicitação

GET /v1/mmc/management/conferences/online
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)

Exemplo de resposta

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

{
    "data": [
        {
            "conferenceID": "914083136",
            "mediaTypes": "Voice,Data,Video",
            "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": {
                "prolongLength": 15,
                "isGuestFreePwd": false,
                "isSendNotify": true,
                "isSendSms": true,
                "isAutoMute": true,
                "isSendCalendar": true,
                "callInRestriction": 0,
                "allowGuestStartConf": true,
                "isHardTerminalAutoMute": true,
                "enableWaitingRoom": true
            },
            "vmrFlag": 0,
            "scheduleVmr": false,
            "isHasRecordFile": false,
            "partAttendeeInfo": [
                {
                    "phone": "+991116003815",
                    "name": "user01",
                    "type": "normal"
                }
            ],
            "terminlCount": 0,
            "normalCount": 1,
            "deptName": "wangyue",
            "confUUID": "050c7898216811eaa6958bf3bb9ac167"
        }
    ],
    "offset": 0,
    "limit": 20,
    "count": 1
}

Códigos de erro

Se um código de erro começando com MMC ou USG for retornado quando você usar essa API, corrija a falha seguindo as instruções fornecidas no Centro de erros da API da Huawei Cloud.

Exemplo de comando cURL

curl -k -i -X GET -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' https://api.meeting.huaweicloud.com/v1/mmc/management/conferences/online