Obtención de un token de control de reuniones
Descripción
Esta API se utiliza para obtener el token de autorización de control de reunión de una reunión en curso. (Para una reunión que no ha comenzado, esta API no puede ser llamada.) Un token es válido durante media hora.
Depuración
Puede depurar esta API en Explorador de API.
Prototipo
Método de solicitud |
GET |
---|---|
Dirección de solicitud |
/v1/mmc/control/conferences/token |
Protocolo de transporte |
HTTPS |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Localización |
Descripción |
---|---|---|---|---|
conferenceID |
Sí |
String |
Query |
ID de reunción. |
X-Conference-Authorization |
No |
String |
Header |
Si se lleva este parámetro, el mensaje es un mensaje de mantenimiento. Si la sesión ha expirado y la solicitud contiene una contraseña, se realiza una nueva autenticación y se devuelve un nuevo ID de sesión. Este campo de cabecera se codifica usando BASE64. |
X-Password |
Sí |
String |
Header |
Contraseña de host. El valor se obtiene de la respuesta para crear la reunión. En el escenario de mantenimiento activo del token de control de reunión, no es necesario llevar la contraseña de reunión. |
X-Login-Type |
Sí |
Integer |
Header |
Tipo de solicitud.
|
X-Nonce |
No |
String |
Header |
Token de nonce temporal de un usuario. |
Códigos de estado
Código de estado de HTTP |
Descripción |
---|---|
200 |
Operación exitosa. |
400 |
Parámetros no válidos |
500 |
Excepción del servidor. |
Parámetros de respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
data |
data object |
Detalles del token. |
addressToken |
String |
Token temporal para consultar el directorio corporativo. |
gloablPublicIP |
String |
Dirección IP externa de la región global del servicio de reuniones. |
Parámetro |
Tipo |
Descripción |
---|---|---|
token |
String |
Token de control de reunión. |
tmpWsToken |
String |
Token para configurar una conexión a WebSocket. Este parámetro es obligatorio cuando la conexión WebSocket se realiza correctamente. |
wsURL |
String |
URL para configurar una conexión a WebSocket. |
role |
Integer |
Roles de los participantes. Valores enumerados:
|
expireTime |
long |
Hora UTC cuando caduca la sesión, en milisegundos. |
userID |
String |
ID del usuario que programa la reunión. |
orgID |
String |
ID de la empresa a la que pertenece la reunión. |
participantID |
String |
ID de sitio devuelto después de que una terminal se une a la reunión. |
confTokenExpireTime |
Integer |
Tiempo en que el token de control de reunión expira, en segundos. |
vmrCurrentConfID |
String |
ID de la sala de reuniones en la nube utilizada para celebrar la reunión. |
supportNotifyType |
Array of strings |
Tipo de mensajes de WebSocket que se enviarán. |
Solicitud de ejemplo
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)
Ejemplo de respuesta
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 error
Si se devuelve un código de error que comienza con MMC o USG cuando utiliza esta API, corrija el error siguiendo las instrucciones proporcionadas en el Centro de errores de la API de Huawei Cloud.
Ejemplo 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'