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.
Atualizado em 2023-08-02 GMT+08:00

Consulta da lista de reuniões

Descrição

  • Esta API é usada para consultar todas as reuniões históricas no domínio de gerenciamento de um administrador ou consultar todas as reuniões históricas gerenciadas por um usuário comum. Se nenhum parâmetro de consulta for transportado, as reuniões em andamento e as reuniões que não foram iniciadas serão consultadas por padrão.
  • Você pode consultar apenas reuniões em andamento e próximas. Para obter detalhes sobre como consultar reuniões históricas, consulte Consulta da lista de reuniões históricas.

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

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 usuários que tenham reuniões agendadas. Somente os administradores têm as permissões para consultar o UUID de todos os usuários na mesma empresa. Outros usuários 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. O valor padrão é 20 e o valor máximo é 500, que é definido pelo servidor do Huawei Cloud Meeting.

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 logon é 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 valor pode conter de 1 a 128 caracteres.

queryConfMode

Não

String

Consulta

  • ADAY: os registros do dia anterior serão consultados.
  • AWEEK: os registros da semana anterior serão consultados.
  • AMONTH: os registros do mês anterior serão consultados.
  • ALL: todos os registros serão consultados.

sortType

Não

String

Consulta

  • ASC_StartTIME: os registros são classificados por hora de início em ordem crescente.
  • DSC_StartTIME: os registros são classificados por hora de início em ordem decrescente.

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
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: 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 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