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/ Controle de reunião/ APIs/ Obtenção de um token de controle de reunião
Atualizado em 2023-08-02 GMT+08:00

Obtenção de um token de controle de reunião

Descrição

Esta API é usada para obter o token de autorização de controle de reunião de uma reunião em andamento. (Para uma reunião que não foi iniciada, esta API falha ao ser chamada.) Um token é válido por meia hora.

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/control/conferences/token

Protocolo de transporte

HTTPS

Parâmetros de solicitação

Tabela 2 Parâmetros

Parâmetro

Obrigatório

Tipo

Localização

Descrição

conferenceID

Sim

String

Consulta

ID da reunião.

X-Conference-Authorization

Não

String

Cabeçalho

Se este parâmetro for transportado, a mensagem é uma mensagem de keep alive. Se a sessão tiver expirado e a solicitação contiver uma senha, a reautenticação será realizada e um novo ID de sessão será retornado.

Este campo de cabeçalho é codificado usando BASE64.

X-Password

Sim

String

Cabeçalho

Senha do anfitrião.

O valor é obtido a partir da resposta para criar a reunião.

No cenário keep alive do token de controle de reunião, a senha da reunião não precisa ser transportada.

X-Login-Type

Sim

Integer

Cabeçalho

Tipo de solicitação.

  • 1: o valor é fixado em 1.

X-Nonce

Não

String

Cabeçalho

Nonce de token temporário de um usuário.

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.

500

Exceção do servidor.

Parâmetros de resposta

Tabela 4 Parâmetros de resposta

Parâmetro

Tipo

Descrição

data

data object

Detalhes do token.

addressToken

String

Token temporário para consultar o diretório empresarial.

gloablPublicIP

String

Endereço IP externo da região global do serviço de reunião.

Tabela 5 Estrutura de dados data

Parâmetro

Tipo

Descrição

token

String

Token de controle de reunião.

tmpWsToken

String

Token para configurar uma conexão WebSocket. Este parâmetro é obrigatório quando a conexão WebSocket é bem-sucedida.

wsURL

String

URL para configurar uma conexão WebSocket.

role

Integer

Papéis do participante. Valores enumerados:

  • 0: anfitrião.
  • 1: convidado.

expireTime

long

Hora UTC quando a sessão expira, em milissegundos.

userID

String

ID do usuário quem agenda a reunião.

orgID

String

ID da empresa à qual a reunião pertence.

participantID

String

ID do site retornado após um terminal ingressar na reunião.

confTokenExpireTime

Integer

Hora em que o token de controle de reunião expira, em segundos.

vmrCurrentConfID

String

ID da sala de reunião na nuvem usada para realizar a reunião.

supportNotifyType

Array of strings

Tipo de mensagens de WebSocket a serem enviadas.

Exemplo de solicitação

GET /v1/mmc/control/conferences/token?conferenceID=914083901
Connection: keep-alive
X-Password: *******
X-Login-Type: 1
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: 337
Connection: keep-alive
Expires: 0
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: 630c3bc684928cfa780860fe6a14f38f
Server: api-gateway
X-Request-Id: d689482097c019094f8aa41e57e52e8e

{
    "data": {
        "token": "stb15afe94b97a5cd7f152d5308c420dbdce85beda4a3b39f26",
        "tmpWsToken": "stba0a69f40a78e50f3789e72386f7da84809fbc86a1400bea5",
        "wsURL": "wss://119.3.200.83:443",
        "role": 1,
        "expireTime": 1576651143250,
        "userID": "ff808081699b56cb0169be103500012b",
        "orgID": "15659",
        "confTokenExpireTime": 1800,
        "vmrCurrentConfID": "914083901",
        "supportNotifyType": [
            "INCREMENT"
        ]
    },
    "addressToken": "stbWdPZ2ooVesQTWqZESu7AjVlH9Pv4O1KcQ",
    "gloablPublicIP": "c.meeting.huaweicloud.com"
}

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-Login-Type: 1' -H 'X-Password: ******' 'https://api.meeting.huaweicloud.com/v1/mmc/control/conferences/token?conferenceID=914083901'