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.

Nesta página

Descrição
Depuração
Protótipo
Parâmetros de solicitação
Códigos de status
Parâmetros de resposta
Exemplo de solicitação
Exemplo de resposta
Códigos de erro
Exemplo de comando cURL

Mostrar todos

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

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

Atualizado em 2023-08-02 GMT+08:00

Ver PDF

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'

Tópico principal: APIs

Tópico anterior: APIs

Próximo tópico: Consulta de detalhes da reunião em tempo real

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar