- Inicio
- /
- Artículo
Cisco Webex Meetings de las actualizaciones de API de uso general (API 41)
Busque toda la información importante que necesite sobre la API de Cisco Webex Meetings, como los cambios de esquema y otros anuncios.
Para obtener más información sobre la API de XML 39 y la API de XML 11, consulte la Descripción general de actualizaciones de la API de XML de Cisco Webex Meetings (API de XML 39 y versiones anteriores).
Para obtener más información sobre la API de XML 40, consulte la Descripción general de actualizaciones de la API de XML de Cisco Webex Meetings (API de XML 40 y versiones posteriores).
Para obtener actualizaciones para la API de XML 11 SP9 y versiones anteriores, vaya a Cisco DevNet.
Actualizaciones de API 41.12.0
Actualizaciones de la API de XML 41.12.0
Haga clic aquí para descargar el esquema de la API de XML 41.12.0.
XMLAPI bloqueará la planificación y la edición de Webex Events (clásico) según el elemento de configuración del sitio de EnableClassicEvent
que sea falso.
API afectadas y cambios en el esquema
En la página de configuración de la administración del sitio, si la casilla de verificación Habilitar evento clásico es falsa, este sitio ya no admite Webex Events reuniones (clásicas).
Si la casilla de verificación Habilitar evento clásico es falsa, debe llamar a estas API para que funcionen Webex Events reunión (clásica):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
La API responderá a la nueva excepción 010106 El Evento clásico ha sido deshabilitado.
Cambios de esquema
No hay cambios de esquema.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de API de CreateEvent
Solicitud para crear un evento
XXXXXXXX
Pruebas EC XMLAPI
07/17/2021 01:29:15
15
Respuesta de CreateEvent
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>ERROR</serv:result>
<serv:reason>El Evento clásico se ha desactivado.</serv:reason>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateEvent3.1.3 Afecta a las API:
-
Establecer evento y obtener evento
-
GetSessionInfo
-
Evento de resumen de Lstsu
-
EventoGrabado
-
LstsummaryProgram
-
CargarEventImage
XMLAPI LstMeetingType
responderá al nuevo elemento de subProductCodePrefix
API afectadas
Actual el elemento de respuesta LstMeetingType
de la API de productionCodePrefix
: PRO, AUO y otros que son el prefijo del tipo de reunión predefinido de Webex.
Después de esta nueva mejora, la API responderá a un nuevo elemento de subProdctCodePrefix
: PRO1, PRO2, etc., que puede personalizarse como prefijo del tipo de reunión.
Cambios de esquema en la API: Tipo de reunión de Lst
Responderá al nuevo elemento: prefijoCódigoProdct
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de API de LstMeetingType
Solicitud de LstMeetingType
13810
Respuesta de LstMeetingType
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
//Nuevo elemento para el tipo de reunión personalizada
<mtgtype:active>ACTIVADO</mtgtype:active>
<mtgtype:name>Cus_Chat_Cerrado</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Cerrado</mtgtype:displayName>
Actualizaciones de API 41.11.0
Actualizaciones de la API de XML 41.11.0
Haga clic aquí para descargar el esquema de la API de XML 41.11.0.
Soporte de API de XML reenviar compatibilidad en la API de administración de usuarios para los sitios administrados por Control Hub
API afectadas y cambios en el esquema
Si su aplicación de integración está utilizando actualmente las API de administración de usuarios de XMLAPI de Webex: CreateUser
, SetUser
, DelUser
y GetUser
para aprovisionar o administrar usuarios, después de que su sitio clásico de Webex se convierta en un sitio administrado por Control Hub, estas API seguirán funcionando para lograr la compatibilidad futura. Hay algunos cambios de comportamiento como se mencionó a continuación:
-
Al utilizar createUser: si el estado del usuario en Control Hub no es "activo", el estado del usuario en el sitio no estará activo. Si el estado del usuario en control Hub está activo, el estado del usuario en el sitio también está activo; referencia: Estado de usuario de usuarios nuevos y convertidos en Control Hub.
-
Se ignorará el elemento de contraseña de las API de CreateUser y SetUser. Comenzaremos a enviar un correo electrónico de activación a los nuevos usuarios; los usuarios pueden hacer clic en el enlace del correo electrónico para activar la cuenta nueva e introducir una nueva contraseña.
-
Se ignorará el elemento activo de la API de CreateUser ; el usuario nuevo (no se verificará) no se podrá activar a través de este parámetro mediante la API SetUser.
-
El valor del elemento webExId en el bodyContent de las API de CreateUser debe ser el mismo que el correo electrónico. Si webExId es diferente del correo electrónico, trataremos el webExId del mismo modo que el correo electrónico al almacenarlo en WebDB y el valor será ignorado.
-
El valor del elemento webExId en el cuerpoContent de las API de SetUser debe ser la identidad del usuario de la dirección de correo electrónico; puede cambiarla mediante <email> en bodyContent.
-
La API SetUser admite la modificación del correo electrónico del usuario existente: es satisfactorio si la cuenta de operación de SecurityContext es el administrador completo del sitio Control Hub. De lo contrario, la API informa errores con el nuevo código de error y el siguiente mensaje:
-
030120 La cuenta debe ser un administrador completo del sitio para cambiar el correo electrónico.
-
-
Se ignorará el elemento newWebExId en el bodyContent de la API setUser.
-
La API SetUser intenta cambiar a un correo electrónico que ya está en uso, la API aparece debajo del nuevo código de error y del mensaje de error:
-
030118 El correo electrónico ya se utiliza en los sitios administrados por Control Hub.
-
-
La API del usuario desactiva al usuario en el lado de la reunión de Webex y se elimina la licencia de reunión correspondiente del sitio de Webex. Este usuario desactivado se puede reactivar mediante la API: SetUser (ACTIVADO) siempre que el usuario sea verificado antes.
-
Las API CreateUser y SetUser crean un nuevo código de error y un mensaje de error, como se muestra a continuación:
-
030117, Este usuario existe fuera de su organización, por lo que debe ser reclamado para entrar a su organización a través del proceso de reclamo de usuarios. Para ver los pasos para reclamar al usuario en su organización, consulte Reclamar usuarios a su organización (Convertir usuarios). Tendrá que verificar el dominio al que pertenece el usuario antes de reclamar al usuario.
-
030119 El token de acceso de CI debe incluir el alcance de webexsquare: admin cuando aprovisionar al usuario.
-
Solo se admite una compatibilidad de período limitado de reenvío. Le proporcionaremos un aviso por adelantado antes de que se elimine esta compatibilidad.
Cambios de esquema
No hay cambios de esquema en esas API: CreateUser
, SetUser
, DelUser
y GetUser
.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de API de CreateUser
Solicitud de API:
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<encabezado>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{cuenta de administración del sitio}</webExID>
<email>{cuenta de Administrador del sitio}</email>
<sessionTicket>xxxx</sessionTicket> o o
o , cuando se utiliza CI "accessToken", debe incluir el alcance webexsquare:admin al aprovisionar al usuario
</securityContext>
</encabezado>
<cuerpo>
<webExId>Jack@qa.webex.com</webExId>: debe ser la identidad del usuario de la dirección de correo electrónico
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<contraseña>....</contraseña>
<privilegio>
<host>verdadero</host>
</privilegio>
<active>ACTIVADO</active>: este parámetro no puede activar al usuario directamente hasta que este se autoactive a través del correo electrónico de activación.
</contenidoCorporal>
Ejemplo de respuesta de la API:
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:createUserResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:userId>23778617</use:userId>
</serv:bodyContent>
Afectar a las API:
-
CreateUser
-
SetUser
-
DelUser
LA API de XML admite la compatibilidad de reenvío de autenticación del usuario existente después de que el sitio clásico de Webex se convierte a sitio administrado por Control Hub
API afectadas
Después de convertir el sitio clásico de Webex en un sitio administrado por Control Hub, el valor del elemento en debe ser el mismo que el correo electrónico; los detalles a continuación:
-
Para los usuarios existentes creados en el sitio clásico de Webex, se admiten ambos webExID antiguos (por ejemplo: Jack) y nuevo webExID (el contenido es el mismo que el correo electrónico, ejemplo: Jack@xx.com) para iniciar sesión, esta compatibilidad retrocomposición de autenticación es para todas las API de XML.
-
En el caso de usuarios nuevos creados en sitios administrados por Control Hub, el valor del elemento webExID debe ser el mismo que el correo electrónico para iniciar sesión.
{siteName}
{userName} --- los usuarios existentes se crearon en el sitio clásico de webEx; puede ser: jack o jack@xx.com; el usuario nuevo debe utilizar jack@xx.com
xxxx o o o
Afectar a las API:
Todas las API de XML.
Después de convertir el sitio clásico de Webex en un sitio administrado por Control Hub, el valor del elemento <bodyContent> debe ser el mismo que el correo electrónico, los detalles a continuación:
-
En el caso de los usuarios existentes creados en el sitio clásico de Webex, admitimos ambos webExId antiguos (por ejemplo: Jack) y nuevo webExId (el contenido es el mismo que el correo electrónico, por ejemplo: Jack@xx.com) en cuerpoContent.
-
Para los usuarios nuevos creados en los sitios administrados por Control Hub, el valor del elemento webExId tiene que ser el mismo que el correo electrónico en
bodyContent
.
xxxx --- los usuarios existentes se crearon en el sitio clásico de webEx; puede ser: jack o jack@xx.com; el usuario nuevo debe utilizar jack@xx.com
Afectar a las API: GetUser
, SetUser
y DelUser
.
Cambios de esquema
No hay cambios de esquema en ninguna API.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de API de GetUser
Solicitud de API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- los usuarios existentes se crearon en el sitio clásico de webEx; puede ser: jack o jack@xx.com; el usuario nuevo debe utilizar jack@xx.com
xxxx o o o
xxxx --- los usuarios existentes se crearon en el sitio clásico de webEx; puede ser: jack o jack@xx.com; el usuario nuevo debe utilizar jack@xx.com
Ejemplo de respuesta de API:
...igual que antes
Mejora de la API de historial de visualización de grabaciones para admitir Webex Meetings, Webex Events (nuevo) y Webex Events (clásico)
API afectadas
API actual: lstrecordaccessHistory
y lstrecordaccessDetailHistory
solo admiten el informe del historial accedido de la vista de grabación de Webex Training. La nueva mejora también admite Webex Meetings historial de Webex Events, Webex Events (nueva) y Webex Events grabación (clásica) a la que se accede.
Cambios de esquema
Ofrecemos soporte para el siguiente nuevo esquema en API lstrecordaccessHistory en el cuerpo de la solicitud de API:
MeetingCenter
TrainingCenter
EventCenter
Detalles
La API: lstrecordaccessHistory
puede volver a la vista de grabación del historial accedido para Webex Meetings, Webex Events (nuevo), Webex Events (clásico) y Webex Training.
-
Si no se especifica ningún serviceType en la solicitud de API, la API de
lstrecordaccessHistory
devuelve solo el historial de acceso a la vista de grabación de Webex Training. -
Cuando el serviceType es MeetingCenter, la API de
lstrecordaccessHistory
devuelve el historial de acceso a la vista de grabación de Webex Meetings y Webex Events (nueva). -
Cuando el serviceType es EventCenter, la API de
lstrecordaccessHistory
devuelve el historial de acceso a la vista de grabación de Webex Events (clásico).
La API: lstrecordaccessDetailHistory
puede devolver detalles por recordID
de Webex Meetings, Webex Events (nuevo), Webex Events (clásico) y Webex Training.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de la API de lstrecordaccessHistory
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<encabezado>
<securityContext>
<webexID>{userName}</webExID>
{password}
<siteName>{siteName}</siteName>
</securityContext>
</encabezado>
<cuerpo>
<viewTimeScope>
<viewTimeStart>20/9/2021 00:00:00</viewTimeStart>
<viewTimeEnd>28/9/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
<pedido>
<orderBy>REGISTRADO</orderBy>
<orderAD>ASC</orderAD>
</pedido>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</contenidoCorporal>
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:historia="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test TC-20210924 1324-1</history:recordName>
<history:creationTime>24/09/2021 13:28:13</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>2</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>TestErollment_001-20210610 1905-1</history:recordName>
<history:creationTime>10/06/2021 19:10:15</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>3</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Probar reproducción instantánea 2-20210705 0709-1</history:recordName>
<history:creationTime>07/05/2021 07:15:06</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>EC2.0_232423-20210922 0447-1</history:recordName>
<history:creationTime>22/09/2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Prueba LstrecordaccessHistory EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>24/09/2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Prueba LstrecordaccessHistory MC-20210924 1319-1</history:recordName>
<history:creationTime>24/09/2021 13:25:12</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC classic-20210924 1331-1</history:recordName>
<history:creationTime>24/09/2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
Solicitud y respuesta de la API de lstrecordaccessDetailHistory
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<encabezado>
<securityContext>
<webexID>{userName}</webExID>
{password}
<siteName>{siteName}</siteName>
</securityContext>
</encabezado>
<cuerpo>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</contenidoCorporal>
<?xml versión="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:historia="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessDetailHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24/09/2021 13:27:26</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>false</history:downloaded>
<history:viewed>verdadero</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordDetail>
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24/09/2021 13:27:39</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>verdadero</history:downloaded>
<history:viewed>false</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</historia:recordDetail>
<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
Afectar a las API:
-
lstrecordaccessHistory
-
lstrecordaccessDetailHistory
Corrija la brecha de longitud máxima Webex Events descripción de usuarios (clásico) entre XMLAPI y la página de Webex.
API afectadas
La API para XML: El elemento de descripción de CreateEvent y SetEvent de Descripción permitirá entradas de 10.000 caracteres como máximo; si se excede el tamaño de la entrada, se generará el nuevo código de error y el mensaje:
060068 descripción de entrada no ilegal. Esta descripción no puede superar 10.000 caracteres.
Cambios de esquema
No hay cambios de esquema.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de API de CreateEvent
#Ejemplo de solicitud de API:
...
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent"
xmlns:att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service/event http://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>Prueba EC</sessionName>
<description>.......Suponga que completa 10000 caracteres en descripción......</description>
</metaData>
...
------------------------------------
#Ejemplo de respuesta de API cuando la descripción excede los 10000 caracteres:
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:result>ERROR</serv:result>
Descripción de entrada ilegal. La descripción no puede exceder los 10 000 caracteres
PRINCIPAL
060068
Afectar a las API:
-
Crear evento
-
Establecer evento
API para XML: GetUser devuelve el nuevo elemento de freeAccount
API afectadas
GetUser
devuelve un nuevo elemento que identifica afreeAccount
si la cuenta de usuario es FreeAccount
o no.
Cambios de esquema
Ejemplo de respuesta de GetUser
Respuesta de GetUser:
AW
false
3
false
Afectar a las API:
GetUser
Actualizaciones de API 41.10.0
No hay cambios de esquema en el esquema de la API de XML 41.10.0.
Actualizaciones de LA API 41.9.0
Actualizaciones de la API de XML 41.9.0
Haga clic aquí para descargar el esquema de la API de XML 41.9.0.
Decomisación de la API de XML 10.0.0 para todos los sitios de T31
Webex tiene previsto el fin del soporte de vida útil de la API de XML ver 10.0.0 para todos los sitios de T31.
Estamos descomisando el código de la API de XML 10.0.0 de todas las producciones en la actualización 41.9.0.
Actualizaciones de API 41.8.0
Actualizaciones de la API de XML 41.8.0
Haga clic aquí para descargar el esquema de la API de XML 41.8.0.
Decomisación de la API de XML 10.0.0 para todos los sitios de T31
Webex tiene previsto el fin del soporte de vida útil de la API de XML ver 10.0.0 para todos los sitios de T31.
Webex encontró algunos clientes que accediendo a la URL de la API de XML utilizando una manera incorrecta como: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, la forma correcta de acceder a la URL de API de XML como: https://{siteName}.webex.com/WBXService/XMLService.
Cambie su código acceso XML API utilizando la forma correcta para evitar impactos antes de que finalice el soporte en XML API versión 10.0.0.
Actualizaciones de API 41.7.0
Actualizaciones de la API de XML 41.7.0
Haga clic aquí para descargar el esquema de la API de XML 41.7.0.
La opción de administración del sitio debe controlar la eliminación y edición de grabaciones móviles: Permitir a los organizadores reasignar, editar, deshabilitar y eliminar grabaciones
API afectadas y cambios en el esquema
GetSite
: devolverá nuevos elementos con el nombre enableNBRMCModify
y separateNoRecordingEdit
en herramientas.
Ejemplo de respuesta
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
...
<ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>true</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
Actualizaciones de API 41.6.3
Actualizaciones de la API de XML 41.6.3
Haga clic aquí para descargar el esquema de la API de XML 41.6.3.
Respuesta de GetSite
nuevo elemento de supportLargeEvent
API afectadas y cambios en el esquema
GetSite: devuelve nuevos elementos con el nombre supportLargeEvent
en siteCommonOptions
para que la persona que llama sepa si el sitio es compatible con un evento grande (evento de Webex [nuevo]) o no.
Cambio de esquema
Ejemplo de respuesta
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
...
<ns1:enablePreMeetingLobby>false</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
Actualizaciones de API 41.6.0
Actualizaciones de la API de XML 41.6.0
Haga clic aquí para descargar el esquema de la API de XML 41.6.0.
Soporte de XMLAPI Webex Events 2.0 en aprovisionamiento
API afectadas
GetUser
: devuelve un nuevo elemento con el nombre largeEventCapacity
que muestra la capacidad del nuevo evento 2.0 (EC 2.0) en esta cuenta de usuario. Por ejemplo, si la cuenta de usuario tiene una licencia CI_EC3K, el valor de largeEventCapacity
es 3000.
Cambios de esquema
Ejemplo de respuesta
GetUserResponse:
CreateTime de XMLAPI LstRecording aplica la hora de inicio de la grabación
API afectadas
LstRecording
: Respuesta LstRecording
CreateTime
como la hora en la que el usuario realmente presiona el botón grabar.
Detalles
En el pasado, la API de XML utilizaba la marca de hora del momento en que se creaba la grabación en la base de datos como la hora de creación en la respuesta LstRecording
. Ahora es la hora en la que el usuario realmente comienza a realizar la grabación. Este cambio se aplica a todas las grabaciones de servicios. No hay cambios de esquema.
Actualizaciones de API 41.5.0
Actualizaciones de la API de XML 41.5.0
Haga clic aquí para descargar el esquema de la API de XML 41.5.0.
XMLAPI tiene la capacidad de iniciar reuniones planificadas de Webex desde PSTN como anfitrión
API afectadas
-
Crear usuario
: generahostPIN
independientemente de que la PMR del usuario esté habilitada o no cuando la función de usuario es organizador, administrador del sitio completo, de solo lectura o de administración de usuarios. -
Establecer usuario
: establecehostPIN
mediantephones.hostPIN
cuandopersonalMeetingRoom.hostPIN
no está en la solicitud XML (condición previa: la alternancia de característicasAllowStartScheduledMtgFromPhone
está habilitada). -
GetUser
: devuelvephones.hostPIN
independientemente de que la PMR del usuario esté habilitada o no. (condición previa: la alternancia de característicasAllowStartScheduledMtgFromPhone
está habilitada).
Cambios de esquema
GetUserResponse
:
Establecer usuario
:
Ejemplo de respuesta
GetUserResponse
:
Establecer usuario
:
La respuesta de XMLAPI GetSite
dos nuevos elementos para el cliente móvil
API afectadas
-
GetSite
:GetSite
ahora responderá a dos nuevos elementos para admitir que el cliente móvil tenga la lógica de mostrar o no la ficha de grabación.-
enableRecordingAccess
: verdadero o falso, los superadministradores de Webex pueden habilitar o deshabilitar el acceso a grabaciones mediante el conmutador (EnableRecordingAccesses
). -
storageEmptyStatus
: verdadero o falso, si ambos sitios no admiten la función NBR y asignan el espacio de almacenamiento NBR como cero, la respuesta de estado es verdadero; de lo contrario, es falso.
-
Cambios de esquema
Solicitud de muestra para GetSite
Respuesta de muestra para Getsite
El asunto del correo electrónico que tiene caracteres que no son ASCII se codificará con RFC2047. En caso de que un asunto de correo electrónico con caracteres ASCII puros, no hay codificación
API afectadasNo hay impactos en la carga de las respuestas y las solicitudes de API, pero cambia el comportamiento de codificación del asunto del correo electrónico. Cuando el asunto del correo electrónico que tiene caracteres que no son ASCII se codificará con RFC2047. En caso de que un asunto de correo electrónico con caracteres ASCII puros, no hay codificación.
Cambios de esquema
No hay cambios de esquema.
Actualizaciones de API 41.4.0
Actualizaciones de la API de XML 41.4.0
Haga clic aquí para descargar el esquema de la API de XML 41.4.0.
La opción Crear evento Webex Events puede aprovechar los valores predeterminados del sitio para el tono de entrada y salida
XMLAPI se alinea con la nueva lógica actual para controlar el tono de entrada y salida. Todos los tonos para las Webex Events fueron controlados por un ajuste diferente en la administración del sitio. En GetSite
, XMLAPI devuelve un campo adicional entryExitToneEC
para indicar el valor. Originalmente, cuando el administrador del sitio establece un valor predeterminado para el tono, crear evento no aprovechará esta configuración aplicando xmlapi predeterminado.
API afectadas
La API para XML: GetSite devuelve un nuevo elemento entryExitToneEC
para indicar el valor.
La API para XML: La lógica de negocio del extremo posterior de CreateEvent, SetEvent, GetEvent lee el valor de entryExitToneEC
.
Cambios de esquema
API para XML: Muestra de respuesta de GetSite:
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>ANNOUNCENAME</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:telephonySupport>
</ns1:telephonySupport>
<ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
Afectar a las API:
-
GetSite
-
Crear evento
-
Establecer evento
-
Obtener evento
XMLAPI solo devuelve la información detallada del evento grande (Webex Event 2.0)
-
Si la reunión de Webex es la difusión por Internet o un evento de gran tamaño, GetSessionInfo devuelve cierta información detallada que incluye la contraseña de la reunión, la contraseña numérica de la reunión, la contraseña del panelista y la contraseña numérica del panelista (no se puede cambiar el
esquema).
-
XMLAPI no admite la creación y la edición de ninguna característica de difusión por Internet o evento de gran tamaño, de manera que CreateMeeting y SetMeeting devuelven una nueva excepción
(110064, no se admite el tipo de sesión de evento y difusión por Web) para casos grandes o de difusión por
Web.
API de impacto
Nombre de API |
Descripción |
Observación |
---|---|---|
|
Si la reunión de Webex es el evento grande o difusión por Internet, GetSessionInfo devuelve la contraseña de la reunión, la contraseña numérica de la reunión, la contraseña del panelista y la |
No se puede cambiar ningún esquema. |
|
Si el usuario intenta utilizar la API de CreateMeeting para crear una reunión de Webex con un tipo de sesión de evento grande, o llame a SetMeeting para editar una reunión de Webex que en realidad es un evento grande o una difusión por Internet, devuelva una nueva |
Se cambiará el comportamiento. |
Actualizaciones de API 41.3.0
Actualizaciones de la API de XML 41.3.0
Haga clic aquí para descargar el esquema de la API de XML 41.3.0.
Los nuevos cambios en la API de XML Webex Events la característica de 2.0
API afectadas
Ambas API: GetSessionInfo y GetMeeting devuelve los elementos enableEvent
y enableWebniar
también.
Nombre del elemento |
Descripción |
---|---|
habilitar evento |
Compatible con EC 2.0 en una reunión de Webex |
enableWebniar |
Es compatible con el seminario Web en una reunión de Webex |
El soporte de XMLAPI devuelve más de dos elementos para EC 2.0. La versión actual de la API de XML no admite la planificación y la configuración de una reunión de EC2.0.
Cambios de esquema
GetSessionInfo
devuelve los elementos enableEvent
y enableWebniar
para EC 2.0.
GetMeeting
devuelve los elementos enableEvent
y enableWebniar
para EC 2.0.
Ejemplo de respuesta:
Respuesta de GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
verdadero
Respuesta de GetMeeting
:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>verdadero</meet:HQvideo>
<meet:HDvideo>verdadero</meet:HDvideo>
<meet:viewVideoThumbs>verdadero</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enableSala de recepción previa a la reunión>verdadero</meet:enableSala de recepción previa a la reunión>
Los nuevos cambios de XMLAPI admiten la característica de sala de recepción previa a la reunión
API afectadas
La API para XML: GetSite
, LstSummarySession
, GetSessionInfo
y GetMeeting
responderán el nuevo elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
Cambios de esquema
La API para XML: GetSite
devuelve el elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API para XML: LstSummarySession
devuelve el elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API para XML: GetSessionInfo
devuelve el elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API para XML: GetMeeting
devuelve el elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
Ejemplo de respuesta:
Respuesta de GetSite
:
false
false
false
verdadero
verdadero
verdadero
verdadero
false
verdadero
true
Respuesta de LstSummarySession
:
false
true
0
false
false
false
true
Respuesta de GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
verdadero
Respuesta de GetMeeting
:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>verdadero</meet:HQvideo>
<meet:HDvideo>verdadero</meet:HDvideo>
<meet:viewVideoThumbs>verdadero</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enableSala de recepción previa a la reunión>verdadero</meet:enableSala de recepción previa a la reunión>
El cambio de comportamiento de la información de respuesta de la API de XML GetSite
revela
API afectadas
La API para XML: GetSite
solo respuesta a continuación de los elementos para la cuenta de administrador, que incluyen funciones: SiteAdmin
, RO_SiteAdmin
y UserAdmin
.
...
...
...
...
...
...
...
...
Cambió el comportamiento
Solo permitir el rol de administrador tener datos de licencia de respuesta de GetSite
. El organizador o el asistente no obtienen esos datos de licencia en la respuesta
GetSite.
A continuación aparecen las API: Ejemplo de respuesta de GetSite
para siteadmin
o solo listo siteadmin
o administrador de usuarios:
Actualizaciones de API 41.2.0
Actualizaciones de la API de XML 41.2.0
Haga clic aquí para descargar el esquema de la API de XML 41.2.0.
XMLAPI debe ser compatible con la "CMR híbrida VoIP" si el sitio es compatible con la telefonía de Webex
API afectadas
-
GetSite
devuelve un nuevo elementoIsWebexTelephony
en la respuesta. -
CreateUser
ySetUser
pueden actualizar el elementocmrHybridVoip
siIsWebexTelephony
es verdadero junto con otras condiciones.IsTSPUsingTelephonyAPI
ya no tiene consecuencias.
Cambios de esquema
API para XML: La respuesta de GetSite
devuelve un elemento adicional IsWebexTelephony
La respuesta de GetSite
incluye este nuevo elemento:
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Número de conferencia personal</ns1:serviceName>
<ns1:participantAccessCodeLabel>Código de acceso de asistente</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Código de acceso de organizador</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>ID de asistente</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
es compatible con EC2.0
Las API de XML se verán afectadas
LstSummarySession
devolverá dos elementos nuevos para admitir EC 2.0
Nombre del elemento |
Descripción |
---|---|
habilitar evento |
Compatible con EC 2.0 en una reunión de Webex |
enableWebniar |
Es compatible con el seminario Web en una reunión de Webex |
Cambios de esquema
API para XML: LstSummarySession
: Anexe los elementos <enableEvent
> y <enableWebniar
>
Respuesta de la API de XML: LstSummarySession
Respuesta a EC 2.0
true
0
false
true
true
XMLAPI admite la devolución de la opción asistente de voz de Webex del usuario del sitio para la
integración de MCT
API afectadas
GetUser
devuelve un nuevo elemento webexAssistantEnabled
(verdadero o falso) en la respuesta.
Cambios de esquema
getUserResponse
:
Ejemplo de respuesta
Actualizaciones de API 41.1.0
No hay cambios de esquema en el esquema de la API de XML 41.1.