- Inicio
- /
- Artículo
Encuentre toda la información importante que necesita 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 las actualizaciones para la API de XML 11 SP9 y versiones anteriores, vaya a Cisco DevNet.
Actualizaciones de la API 41.12.0
Actualizaciones de la API de XML 41.12.0
Haga clic aquí para descargar el esquema 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 es falso
API afectadas y cambios de 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 admitirá reuniones de Webex Events (clásico).
Si la casilla Enable classicEvent (Habilitar evento clásico) es falsa, debe llamar a estas API para operar la reunión de Webex Events (clásica):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
La API responderá a una nueva excepción 010106El evento clásico se ha desactivado.
Cambios de esquema
Sin cambios de esquema.
Ejemplo de solicitud y respuesta de API
CreateEvent Solicitud y respuesta de API de
Solicitud de CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>Pruebas de EC XMLAPI</sessionName>
</metaData>
<schedule>
<startDate>17/07/2021 01:29:15</startDate>
<openTime>15</openTime>
</schedule>
</bodyContent>
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>PRINCIPAL</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 Afectar a las API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
responderá al nuevo elemento de subProductCodePrefix
API afectadas
Actualizar la API LstMeetingType
elemento de respuesta productionCodePrefix
: PRO, AUO y otros que tienen 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 pueden personalizarse como prefijo del tipo de reunión.
Cambios de esquema en la API: LstMeetingType
Responderá a un nuevo elemento: subProdctCodePrefix
Ejemplo de solicitud y respuesta de API
LstMeetingType
Solicitud y respuesta de la API
Solicitud de LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
Respuesta de LstMeetingType
<serv:body>
<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:meetingType>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Nuevo elemento para el tipo de reunión personalizado
<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 API de XML 41.11.0.
Compatibilidad de reenvío de API de XML en la API de administración de usuarios para los sitios administrados por Control Hub
API afectadas y cambios de esquema
Si su aplicación de integración actualmente utiliza 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 sitio administrado por Control Hub, estas API seguirán funcionando para lograr la compatibilidad de reenvío. Hay algunos cambios de comportamiento, como se indica a continuación:
Al utilizar createUser: si el estado del usuario en Control Hub no está "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, consulte: Estado del usuario de los usuarios nuevos y convertidos en Control Hub.
El elemento password de las API de CreateUser y SetUser se ignorará, comenzamos a enviar correos electrónicos de activación a los nuevos usuarios, los usuarios pueden hacer clic en el enlace del correo electrónico para activar una nueva cuenta e introducir una nueva contraseña.
El activoelementodeAPI de CreateUser se ignorará, el usuario nuevo (no verificado) no se puede activar a través de este parámetro mediante la API SetUser.
El valor de Id webEx El elemento del cuerpoContent de las API de CreateUser debe ser el mismo que el correo electrónico. Si Id webEx es diferente de correo electrónico, trataremos el Id webEx igual que el correo electrónico al almacenarlo en WebDB y se ignorará el valor.
El valor de Id webEx en el cuerpoContenido de las API de SetUser debe ser la identidad del usuario de la dirección de correo electrónico; puede cambiarla mediante <correo electrónico> en bodyContent.
La API de SetUser será compatible con el cambio del correo electrónico del usuario existente: es correcto si la cuenta de operación en SecurityContext es administrador del sitio completo de Control Hub. De lo contrario, la API informa de un error con un nuevo código de error y un mensaje a continuación:
030120 La cuenta debe ser un administrador completo del sitio para cambiar el correo electrónico.
Se ignorará el elemento newWebExId del cuerpoContent de la API de SetUser.
La API de SetUser intenta cambiar a un correo electrónico que ya está en uso; la API muestra a continuación un nuevo código de error y un mensaje de error:
030118 El correo electrónico ya se utiliza en los sitios administrados por Control Hub.
La API de DelUser desactiva al usuario en el lado de la reunión de Webex y la licencia de reunión correspondiente se elimina del sitio de Webex. Este usuario desactivado se puede reactivar mediante la API: SetUser (<active>ACTIVADO</active>) siempre que el usuario se haya verificado antes.
Las API CreateUser y SetUser generan 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 pasar a su organización a través del proceso de solicitud de usuario. Para conocer los pasos para reclamar al usuario en su organización, consulte Reclamar usuarios a su organización (Convertir usuarios). Deberá verificar el dominio al que pertenece el usuario antes de reclamar el usuario.
030119 El token de acceso de CI debe incluir el alcance webexsquare: administrador al aprovisionar al usuario.
Solo se admite la compatibilidad con un período de tiempo limitado. Le enviaremos un aviso previo 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 la API de CreateUser
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/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{cuenta de administración del sitio}</webExID>
<email>{cuenta de administración del sitio}</email>
<sessionTicket>xxxx</sessionTicket> o <password> o <webExAccessToken>
o <accessToken>, cuando se utiliza CI "accessToken", debe incluir el alcance webexsquare:admin cuando se aprovisiona el usuario
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<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>
<password>....</password>
<privilege>
<host>true</host>
</privilege>
<active>ACTIVATED</active> -- este parámetro no puede activar al usuario directamente hasta que el usuario se active por sí mismo a través del correo electrónico de activación.
</bodyContent>
</body>
Ejemplo de respuesta de la API:
<?xml version="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>PRINCIPAL</serv:gsbStatus>
</serv:response>
</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>
</serv:body>
</serv:message>
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 convertir el sitio clásico de Webex al 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 <webExID> en <securityContext> 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, admitimos ambos antiguos webExID (Por ejemplo: Jack) y el nuevo webExID (el contenido es el mismo que el correo electrónico, por ejemplo: Jack@xx.com) para iniciar sesión, esta compatibilidad con versiones anteriores de autenticación es para todas las API de XML.
Para los usuarios nuevos creados en sitios administrados por Control Hub, el valor del elemento webExID debe ser el mismo que el correo electrónico para el inicio de sesión.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- los usuarios existentes se han creado en el sitio webEx classic, puede ser: jack o jack@xx.com; el usuario nuevo debe usar jack@xx.com
<sessionTicket>xxxx</sessionTicket> o <password> o <webExAccessToken> o <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
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 <webExID> <bodyContent> 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, admitimos ambos antiguos Id webEx(p. ej.: Jack) y nuevo Id webEx(el contenido es el mismo que el correo electrónico, por ejemplo: Jack@xx.com) en bodyContent.
Para los usuarios nuevos creados en sitios administrados por Control Hub, el valor de Id webEx elemento tiene que ser el mismo que el correo electrónico en
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- los usuarios existentes se crearon en el sitio webEx classic, puede ser: jack o jack@xx.com; el nuevo usuario debe usar jack@xx.com
</bodyContent>
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 la 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/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- los usuarios existentes se crearon en el sitio web Ex classic, puede ser: jack o jack@xx.com; el nuevo usuario debe utilizar jack@xx.com
<sessionTicket>xxxx</sessionTicket> o <password> o <webExAccessToken> o <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- los usuarios existentes se crearon en el sitio web Ex classic, puede ser: jack o jack@xx.com; el usuario nuevo debe usar jack@xx.com
</bodyContent>
</body>
Ejemplo de respuesta de la API:
...igual que antes
Mejora de la API del informe del historial de la vista de grabación para admitir en Webex Meetings, Webex Events (nuevo) y Webex Events (clásico)
API afectadas
API actual: lstrecordaccessHistory
y una lstrecordaccessDetailHistory
solo admite el informe de historial accedido de la vista de grabación de Webex Training. La nueva mejora también es compatible con el informe de historial de acceso a la vista de grabación de Webex Meetings, Webex Events (nuevo) y Webex Events (clásico).
Cambios de esquema
Admitimos a continuación un nuevo esquema en lstrecordaccessHistory de API en el cuerpo de solicitud de API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Detalles
La API: lstrecordaccessHistory
es capaz de devolver el historial de acceso a la vista de grabación para Webex Meetings, Webex Events (nuevo), Webex Events (clásico) y Webex Training.
Si no hay Tipo de servicio especificado en la solicitud de API, la API de
lstrecordaccessHistory
devuelve solo el historial al que se accedió la vista de grabación de Webex Training.Cuando el serviceType es MeetingCenter, la API de
lstrecordaccessHistory
devuelve el historial accedido a la vista de grabación de Webex Meetings y Webex Events (nuevo).Cuando el Tipo de servicio es EventCenter, la API de
lstrecordaccessHistory
devuelve el historial al que se accedió la vista de grabación de Webex Events (clásica).
La API: lstrecordaccessDetailHistory
es capaz de devolver detalles por recordID
de Webex Meetings, Webex Events (nuevo), Webex Events (clásico) y Webex Training.
Ejemplo de solicitud y respuesta de API
lstrecordaccessHistory
Solicitud y respuesta de la API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>20/9/2021 00:00:00</viewTimeStart>
<viewTimeEnd>28/9/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy>GRABADA</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</bodyContent>
</body>
</serv:message>
<?xml version="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:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</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>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>TestErollment_001-20210610 1905-1</history:recordName>
<history:creationTime>06/10/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>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Probar la 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>
</history: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>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test 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>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test 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>
</history: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>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
lstrecordaccessDetailHistory
Solicitud y respuesta de la 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">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="">
"java:com.webex.service.binding.history.lstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</body>
<?xml version="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:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>ÉXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</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>falso</history:registered>
<history:downloaded>falso</history:downloaded>
<history:viewed>verdadero</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history: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>falso</history:registered>
<history:downloaded>verdadero</history:downloaded>
<history:viewed>falso</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
Afectar a las API:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Corrija el intervalo de longitud máxima permitida de descripción de Webex Events (clásico) entre XMLAPI y la página de Webex.
API afectadas
La API XML : Elemento CreateEvent y SetEvent de descripción permitirá entradas de 10000 caracteres como máximo; si se introducen más de tamaño, se generará el nuevo código de error y el nuevo mensaje:
060068 Descripción de entrada ilegal. Esta descripción no puede superar los 10000 caracteres.
Cambios de esquema
Sin cambio de esquema.
Ejemplo de solicitud y respuesta de API
Solicitud y respuesta de la API de CreateEvent
Ejemplo de solicitud de #API:
...
<body>
<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/eventhttp://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVADO</listing>
</accessControl>
<metaData>
<sessionName>Prueba EC</sessionName>
<description>.......Suponga que rellena 10000 caracteres en la descripción.......</description>
</metaData>
...
------------------------------------
#Ejemplo de respuesta API cuando la descripción supera 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:header>
<serv:response>
<serv:result>FALLO</serv:result>
<serv:reason>Descripción de entrada ilegal. La descripción no puede superar los 10000 caracteres</serv:reason>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
<serv:exceptionID>060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
Afectar a las API:
CreateEvent
SetEvent
API XML : GetUser devuelve nuevo elemento de freeAccount
API afectadas
GetUser
devuelve un nuevo elemento que identifica freeAccount
la cuenta de usuario es FreeAccount
o no.
Cambios de esquema
Ejemplo de respuesta de GetUser
Respuesta de GetUser:
<use:initials>AW</use:initials>
<use:isUploaded>falso</use:isUploaded>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>falso</use:freeAccount>
Afectar a las API:
GetUser
Actualizaciones de la API 41.10.0
No hay cambios de esquema en el esquema 41.10.0 de la API de XML. |
Actualizaciones de la API 41.9.0
Actualizaciones de la API de XML 41.9.0
Anular la API de XML 10.0.0 para todos los sitios T31
Webex planea el fin de vida útil de la versión 10.0.0 de la API de XML para todos los sitios T31.
Estamos retirando el código API 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
Anular la API de XML 10.0.0 para todos los sitios T31
Webex planea el fin de vida útil de la versión 10.0.0 de la API de XML para todos los sitios T31.
Webex encontró que algunos clientes accedían a la URL de la API de XML utilizando formas incorrectas como: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, la forma correcta de acceder a la URL de la API de XML como: https://{siteName}.webex.com/WBXService/XMLService.
Cambie la API de XML de acceso al código utilizando la forma correcta para evitar el impacto antes de que terminemos el soporte de vida útil en la versión 10.0.0 de la API de XML.
Actualizaciones de la API 41.7.0
Actualizaciones 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 de esquema
GetSite
: devolverá nuevos elementos de denominación enableNBRMCModify
, y separateNoRecordingEdit
debajo de 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>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:tools>
...
<ns1:enableNBRMCModify>falso</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>verdadero</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Actualizaciones de la API 41.6.3
Actualizaciones de la API de XML 41.6.3
GetSite
Respuesta nuevo elemento de supportLargeEvent
API afectadas y cambios de esquema
GetSite: devuelve nueva denominación de elementos supportLargeEvent
en siteCommonOptions
para informar a la persona que llama 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>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:siteCommonOptions>
...
<ns1:enablePreMeetingLobby>falso</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>verdadero</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Actualizaciones de la API 41.6.0
Actualizaciones de la API de XML 41.6.0
XMLAPI admite Webex Events 2.0 en el aprovisionamiento
API afectadas
GetUser
: devuelve nuevo nombre de elementos 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 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
: LstRecording
respuesta CreateTime
como la hora en la que el usuario realmente presiona el botón de grabación.
Detalles
En el pasado, la API de XML utilizaba la marca de tiempo de cuando se creó la grabación en la base de datos como la hora de creación en LstRecording
respuesta. Ahora es el momento en el que el usuario comienza a realizar la grabación. Este cambio se aplica a todas las grabaciones de servicios. No hay ningún cambio de esquema.
Actualizaciones de la API 41.5.0
Actualizaciones de la API de XML 41.5.0
XMLAPI tiene la capacidad de iniciar reuniones planificadas de Webex desde PSTN como organizador
API afectadas
CreateUser
: generahostPIN
independientemente de que la PMR del usuario esté habilitada o no cuando la función de usuario sea el organizador o los administradores del sitio completos o de solo lectura o de administración de usuarios.SetUser
: conjuntoshostPIN
usophones.hostPIN
cuandopersonalMeetingRoom.hostPIN
no está en la solicitud XML (condición previa: alternancia de funcionesAllowStartScheduledMtgFromPhone
está habilitado).GetUser
: devolucionesphones.hostPIN
independientemente de que la PMR del usuario esté habilitada o no. (condición previa: alternancia de funcionesAllowStartScheduledMtgFromPhone
está habilitado).
Cambios de esquema
GetUserResponse
:
SetUser
:
Ejemplo de respuesta
GetUserResponse
:
SetUser
:
XMLAPI GetSite
respuesta dos nuevos elementos para el cliente móvil
API afectadas
GetSite
:GetSite
ahora responderá dos nuevos elementos para admitir que el cliente móvil tiene la lógica de mostrar o no mostrar la ficha de grabación.enableRecordingAccess
: verdadero o falso, los superadministradores de Webex pueden habilitar o deshabilitar el acceso a la grabación mediante la alternancia(EnableRecordingAccesses
).storageEmptyStatus
: verdadero o falso, si ambos sitios no admiten la función NBR y asignaron el espacio de almacenamiento NBR como cero, entonces la respuesta de estado es verdadera, de lo contrario es falsa.
Cambios de esquema
Solicitud de muestra para GetSite
Respuesta de muestra para Getsite
El asunto del correo electrónico que tenga caracteres no ASCII se codificará con RFC2047. En el caso de un asunto de correo electrónico de carácter ASCII puro, no hay codificación
API afectadasNo hay impactos en ninguna solicitud de API, carga útil de respuestas, pero cambia el comportamiento de codificación del asunto del correo electrónico. Cuando el asunto del correo electrónico que tenga caracteres no ASCII se codifique con RFC2047. En el caso de un asunto de correo electrónico de carácter ASCII puro, no hay codificación.
Cambios de esquema
No hay cambios de esquema.
Actualizaciones de la API 41.4.0
Actualizaciones de la API de XML 41.4.0
Crear eventos de Webex planificados puede aprovechar el tono de entrada y salida predeterminado a nivel del sitio
XMLAPI se alinea con la nueva lógica actual para controlar el tono de entrada y salida. Todos los tonos para Webex Events se controlaron mediante una configuración 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 estableció el tono predeterminado, crear evento no aprovechará esta configuración al aplicar el valor predeterminado de XMLAPI.
API afectadas
La API XML : GetSite devuelve un nuevo elemento entryExitToneEC
para indicar el valor.
La API XML : La lógica de negocio back end de CreateEvent, SetEvent, GetEvent lee el valor de entryExitToneEC
.
Cambios de esquema
API XML : Muestra de respuesta de GetSite:
<ns1:defaults>
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>NAME</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NONE</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
Afectar a las API:
GetSite
CreateEvent
SetEvent
GetEvent
XMLAPI solo devuelve la información detallada del evento grande (evento de Webex 2.0)
Si la reunión de Webex es el evento grande o la difusión web,
GetSessionInfo
devuelve cierta información detallada, como 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 debe cambiar ningún esquema).XMLAPI no es compatible con la creación y edición de ninguna característica de evento grande o difusión web, por lo que
CreateMeeting
y unaSetMeeting
devuelva una excepción nueva (110064, El tipo de sesión de evento y difusión web no son compatibles) para un caso de evento grande o difusión web.
API de impacto
Nombre de la API | Descripción | Observación |
---|---|---|
| Si la reunión de Webex es el evento grande o la difusión web, | No se debe cambiar ningún esquema. |
| Si el usuario intenta utilizar | Se cambiará el comportamiento. |
Actualizaciones de la API 41.3.0
Actualizaciones de la API de XML 41.3.0
Los nuevos cambios de la API de XML admiten la característica de Webex Events 2.0
API afectadas
Ambas API: Elementos de devolución de GetSessionInfo y GetMeeting enableEvent
y una enableWebniar
también.
Nombre del elemento | Descripción |
---|---|
enableEvent | Admite EC 2.0 en una reunión de Webex |
enableWebniar | Admite seminario web en una reunión de Webex |
El soporte de XMLAPI devuelve por encima de dos elementos para EC 2.0. La versión actual de la API de XML no es compatible con planificar y configurar reuniones de EC2.0. |
Cambios de esquema
GetSessionInfo
elementos de retorno enableEvent
y una enableWebniar
para EC 2.0.
GetMeeting
elementos de retorno enableEvent
y una enableWebniar
para EC 2.0.
Muestra de respuesta:
GetSessionInfo
respuesta:
<ep:accessControl>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>verdadero</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadero</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
respuesta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>verdadero</meet:HQvideo>
<meet:HDvideo>verdadero</meet:HDvideo>
<meet:viewVideoThumbs>verdadero</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>verdadero</meet:enablePreMeetingLobby>
Los nuevos cambios de XMLAPI admiten la característica de sala de recepción previa a la reunión
API afectadas
La API XML : GetSite
, LstSummarySession
, GetSessionInfo
, y GetMeeting
responderá al nuevo elemento enablePreMeetingLobby
para la sala de recepción previa a la reunión.
Cambios de esquema
La API XML : GetSite
elemento de retorno enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API XML : LstSummarySession
elemento de retorno enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API XML : GetSessionInfo
elemento de retorno enablePreMeetingLobby
para la sala de recepción previa a la reunión.
La API XML : GetMeeting
elemento de retorno enablePreMeetingLobby
para la sala de recepción previa a la reunión.
Muestra de respuesta:
GetSite
respuesta:
<ns1:siteCommonOptions>
<ns1:SupportCustomDialRestriction>falso</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>falso</ns1:SupportTelePresence>
<ns1:SupportTelePresencePlus>falso</ns1:SupportTelePresencePlus>
<ns1:EnableCloudTelepresence>verdadero</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>verdadero</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>verdadero</ns1:enablePersonalMeetingRoom>
<ns1:SupportAlternateHost>verdadero</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturnScheduledPMR>falso</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>verdadero</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>verdadero</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
respuesta:
<ep:isException>falso</ep:isException>
<ep:isNextUpcomingInstance>verdadero</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadero</ep:enablePreMeetingLobby>
GetSessionInfo
respuesta:
<ep:accessControl>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>verdadero</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadero</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
respuesta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>verdadero</meet:HQvideo>
<meet:HDvideo>verdadero</meet:HDvideo>
<meet:viewVideoThumbs>verdadero</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>verdadero</meet:enablePreMeetingLobby>
La API de XML GetSite
revelación del cambio de comportamiento de la información de la respuesta
API afectadas
La API XML : GetSite
solo los elementos de respuesta siguientes para la cuenta de administrador, que incluyen funciones: SiteAdmin
, RO_SiteAdmin
, y UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Se cambió el comportamiento
Solo permitir que el rol de administrador tenga datos de licencia de respuesta de GetSite
. El organizador o el asistente no obtendrán esos datos de licencia GetSite
respuesta.
A continuación se muestra la API: GetSite's
ejemplo de respuesta para siteadmin
o solo listo siteadmin
o administrador de administración de usuarios:
Actualizaciones de la API 41.2.0
Actualizaciones de la API de XML 41.2.0
XMLAPI debe admitir "VOIP de CMR híbrida" si el sitio admite telefonía de Webex
API afectadas
GetSite
devuelve un nuevo elementoIsWebexTelephony
en la respuesta.CreateUser
y unaSetUser
puede actualizar elcmrHybridVoip
elemento siIsWebexTelephony
es cierto junto con otras condiciones.IsTSPUsingTelephonyAPI
ya no es consecuente.
Cambios de esquema
API XML : GetSite
la respuesta devuelve un elemento adicional IsWebexTelephony
GetSite
la respuesta incluye este nuevo elemento:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>N.º de conferencia personal</ns1:serviceName>
<ns1:participantAccessCodeLabel>Código de acceso del asistente</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Código de acceso del organizador</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Identificador del asistente</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
soporta EC2.0
Las API de XML se ven afectadas
LstSummarySession
devolverá dos nuevos elementos para apoyar EC 2.0
Nombre del elemento | Descripción |
---|---|
enableEvent | Admite EC 2.0 en una reunión de Webex |
enableWebniar | Admite seminario web en una reunión de Webex |
Cambios de esquema
API XML : LstSummarySession
: Anexar el < enableEvent
> y < enableWebniar
> elementos
Respuesta de API de XML: LstSummarySession
Respuesta para EC 2.0
<ep:isNextUpcomingInstance>verdadero</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>verdadero</ep:enableEvent>
<ep:enableWebniar>verdadero</ep:enableWebniar>
Compatibilidad con XMLAPI para devolver al usuario del sitio Webex-voice-assistant
opción de 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 la API 41.1.0
No hay cambios de esquema en el esquema 41.1 de la API de XML. |