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
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
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.
|
X-Nonce |
Não |
String |
Cabeçalho |
Nonce de token temporário de um usuário. |
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
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. |
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:
|
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'