Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Meeting/ Referencia de la API del servidor/ Control de la reunión/ APIs/ Obtención de un token de control de reuniones
Actualización más reciente 2023-01-31 GMT+08:00

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

Tabla 1 Prototipo

Método de solicitud

GET

Dirección de solicitud

/v1/mmc/control/conferences/token

Protocolo de transporte

HTTPS

Parámetros de solicitud

Tabla 2 Parámetros

Parámetro

Obligatorio

Tipo

Localización

Descripción

conferenceID

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

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

Integer

Header

Tipo de solicitud.

  • 1: El valor se fija en 1.

X-Nonce

No

String

Header

Token de nonce temporal de un usuario.

Códigos de estado

Tabla 3 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

Tabla 4 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.

Tabla 5 Estructura de datos

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:

  • 0: host.
  • 1: invitado.

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'