- Inicio
- /
- Artículo
Descripción general de las actualizaciones de la API de Cisco Webex Meetings (API 40)
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 41, consulte la Descripción general de actualizaciones de la API de Cisco Webex Meetings (API 41)
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 actualizaciones para la API de XML 11 SP9 y versiones anteriores, vaya a Cisco DevNet.
Actualizaciones de API 40.12.0
Actualizaciones de la API de XML 40.12.0
Haga clic aquí para descargar el esquema de la API de XML 40.12.0
API para XML es compatible con el tipo de reunión privada
Las API de XML se verán afectadas
-
Podemos usar API:
CreateMeeting
ySetMeeting
para planificar o actualizar una reunión de Webex con el tipo de reunión privada. -
Si una reunión de Webex se planifica con el tipo de reunión privada,
GetSessionInfo
GetMeeting ,
LstSummarySession , y
LstCalendarSession
devolverá un nuevo nombre de elemento es PrivateMeeting para conocerlo.
-
GetMeetingType
yLstMeetingType
devuelven un nuevo elemento con el nombre
que indica si admite reuniones privadas o no.SupportPrivateMeeting
Cambios de esquema
API para XML: GetMeetingType/LstMeetingType: Anexe el elemento .
API para XML: LstSummarySession
: Anexe el elemento
.
API para XML: LstCalendarSession
: Anexe el elemento
.
API para XML: GetSessionInfo
: Anexe el elemento
.
API para XML: GetMeeting: Anexe el elemento
.
Solicitud de API de XML: Crear reunión
Solicitud de CreateMeeting con el tipo de reunión privada
25/10/2020 13:00:00
45
45
;********
MC_PrivateMeeting_Test
168 //169 es una muestra que admite reuniones privadas
Respuesta de la API de XML: GetSessionInfo
Respuesta para isPrivateMeeting
false
true
true //true: la reunión es compatible con reuniones privadas; Falso: la reunión no es compatible con reuniones privadas.
false
false
true
La API de GetSite devolverá las plantillas de reunión a nivel del sitio
Historia del usuario/Descripción de tarea
API de GetSite para volver a la plantilla de reunión a nivel de sitio. Esto permitirá que education Connector y webex Classrooms muestren estas plantillas para que los maestros escojan y elijan estas plantillas mientras planifican sus sesiones en línea.
API afectadas
Si hay plantillas de reunión personalizadas que son a nivel de sitio, la API de GetSite devuelve estas plantillas a nivel del sitio.
Nombre de los elementos |
Descripción |
---|---|
|
el nombre de las plantillas de reunión personalizadas a nivel del sitio |
|
Webex Meetings, Webex Training y Webex Events |
Cambios de esquema
GetSite : Anexe el elemento .
Ejemplo de respuesta
Respuesta de GetSite
3
PRO
MC Meeting Tempalte 1
MeetingCenter
EC Meeting Tempalte 2
EventCenter
Plantilla de reunión 3 de TC
TrainingCenter
XML API SetUser no puede cambiar el elemento de supportedServices
cuando el sitio es un sitio unificado de CI
Descripción
XMLAPI SetUser no admite el valor de cambio de "
supportedServices " en una solicitud API cuando el sitio es un sitio de Unified Webex Meeting vinculado
con Control Hub.
Cambios de esquema
No hay cambios de esquema en la API: SetUser
.
WEBEX-15436: Agregar protección para evitar mensajes de correo electrónico duplicados en Mtgconfattendeelist
Descripción
Si se agregan varios asistentes que tienen el mismo correo electrónico a la misma reunión en la misma solicitud API, solo procesamos al primer asistente con el correo electrónico.
API afectadas
-
CreateMeetingAttendee
-
CreateUser
-
SetUser
-
Crear reunión
-
Definir reunión
-
Crear evento
-
Establecer evento
-
Crearsesión de capacitación
-
ConfigurarSesión de capacitación
API de muestra
Solicitud
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>password</password>
</securityContext>
</header>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body>
<bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<sessionKey>1714904382</sessionKey>
<person>
<email>test@webex.com</email>
<name>name1</name>
</person>
<attendees>
<person>
<email>test@webex.com</email>
<name>name2</name>
</person>
<sessionKey>1714904382</sessionKey>
</attendees>
</bodyContent>
</body>
</serv:
Actualizaciones de LA API 40.11.0
Actualizaciones de la API de XML 40.11.0
Haga clic aquí para descargar el esquema de la API de XML 40.11.0
XMLAPI CreateUser admite displayname
CreateUser
admite dispalyname
cuando la alternancia de características EnableDisplayName
es 1. Si la alternancia de características no es 1, se ignorará el displayName.
Cambios de esquema
CreateUser:
XMLAPI SetUser admite displayname
SetUser
admite dispalyname
cuando la alternancia de características EnableDisplayName
es 1. Si el conmutador de características no es 1, se ignorará el displayName.
Cambios de esquema
SetUser:
XMLAPI GetUser admite displayname
GetUser
admite dispalyname
cuando la alternancia de características EnableDisplayName
es 1. Si el conmutador de características no es 1, no se mostrará el
displayName.
Cuando displayName en DB es nulo y la alternancia de características EnableDisplayName es
1, displayName será
nombre
+" "+apellido
para caracteres no asiáticos y nombre + apellido para caracteres asiáticos.
Cambios de esquema
GetUserResponse:
Control de nivel de usuario XMLAPI para Voip híbrido de CMR
La configuración cmrHybridVoip se utiliza para establecer y recuperar la configuración de nivel de usuario para
EnableCMRHybridVoIP
.
Cambios de esquema
Respuesta de GetUser:
Crear solicitud de usuario:
Configurar solicitud del usuario:
Actualizaciones de la API 40.10.0
Actualizaciones de la API de XML 40.10.0
Haga clic aquí para descargar el esquema de la API de XML 40.10.0
Compatibilidad con API de XML para UUID de reunión
en solicitud y respuesta de API
API de XML de muestra: Solicitud de GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afectadas:
-
CreateMeetingAttendee
-
DelMeetingAttendee
-
RegistrarMeetingAttendee
-
CrearSesión de audio conferencia
-
SetTeleconferenceSession
-
GetTeleconferenceSession
-
Crearsesión de capacitación
-
ConfigurarSesión de capacitación
-
Obtener CapacitaciónSesión
-
DelTrainingSession
-
Crear evento
-
Establecer evento
-
Delevento
XMLAPI devolverá un elemento adicional para la configuración de administración del sitio para deshabilitar la captura de pantalla
El requisito proviene de la seguridad, tanto errores de PenTest
como clientes, como Goldman GoldmanDro. No quieren permitir que los usuarios finales tomen capturas de pantalla en la aplicación reuniones. Mientras tanto, muchos otros clientes desean esta característica: permitir la captura de pantalla. Además, los usuarios de Educación también quieren permitir la captura de pantalla. De manera que tendremos una configuración del administrador del sitio para esto, y XMLAPI devolverá un campo adicional EnableMobileScreenCapture en la respuesta de GetSite para admitir
esto.
Muestra de la solicitud GetSite
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Test</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</body>
<?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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns1:siteInstance>
...
<ns1:securityOptions>
...
...
<ns1:EnableMobileScreenCapture>false</ns1:EnableMobileScreenCapture>
...
</ns1:securityOptions>
...
</ns1:siteInstance>
</serv:bodyContent>
</ser
API afectadas
GetSite
XMLAPI admite una mejora para entrar a la reunión con UN PIN MEET-269 sin PIN
XMLAPI agregar una NUEVA OPCIÓN Sistemas de videoconferencias en mi organización pueden iniciar y entrar a reuniones sin mensajes para la reunión de sala personal y reunión de MC.
-
createUser/setUser/getUser
agregue un nodo nuevodeviceCanStartMyPMR
enpersonalMeetingRoom
. -
createMeeting/setMeeting/getMeeting
agregue un nodo nuevodeviceCanStartMeeting
en la planificación.
La opción en la interfaz de usuario de Webex para la reunión de sala personal:
Cambios de esquema
CreateUser:
SetUser:
getUserResponse:
Crear reunión:
setMeeting:
getMeetingResponse:
Actualizaciones de la API 40.9.0
Actualizaciones de la API de XML 40.9.0
Haga clic aquí para descargar el esquema de la API de XML 40.9.0
Compatibilidad con la API de XML para la solicitud y respuesta de UUID de reunión
Hemos agregado el UUID de la reunión a la solicitud y respuesta de API donde sea que admitamos como meetingKey
o sessionKey
.
API de XML de muestra: Solicitud de GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afectadas:
-
Obtener información de inscripción
-
LstsummaryTrainingSession
-
Prueba addscheduled
-
Configurarprueba programada
-
DelScheduledTest
-
ObtenerTestinformación
-
CargarEventImage
-
EnviarinvitationEmail
-
CreateSupportSession
-
LstmeetingusagePreliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
LsteventsessionPreimainaryHistory
-
LsteventattendeePredelainaryHistory
-
LstTrainingPollResultsHistory
Las reuniones de Webex tendrán una sala de recepción de reunión bloqueada donde los usuarios pueden esperar para ser admitidos en la reunión
La reunión de XML API planifica y edita una reunión de MC para admitir la sala de recepción bloqueada cuando se activa la característica(ConsistentLockedLobby).
Cambios de esquema
Se agregaron tres elementos nuevos(externalAttendeeSecurity
, autoLock
, autoLockWaitTime ) en
createMeeting, SetMeeting y GetMeeting API.
Elemento |
Descripción |
---|---|
|
Cuando la reunión está desbloqueada, hay tres elementos de seguridad del usuario externos que pueden elegirse.
|
|
Si bloquea automáticamente la reunión. Verdadero: Bloquear automáticamente la reunión después de # minutos después de que se inicia la reunión Falso: No bloquea automáticamente la reunión después de que se inicia la reunión |
|
Minutos(0,5,10,15,20 ) para bloquear automáticamente la reunión despuésde que se inicia la reunión |
Muestra de solicitud y respuesta
Solicitud de CreateMeeting:
...
...
false
AllowJoinWithLobby
true
10
...
Solicitud de SetMeeting:
2###1###01
...
...
false
AllowJoinWithLobby
true
10
...
Respuesta de GetMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<meet:attendeeOptions>
...
<meet:joinRequiresAccount>false</meet:joinRequiresAccount>
<meet:externalAttendeeSecurity>AllowJoin</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...
</serv:mensaje>
API afectadas:
-
Crear reunión
-
Definir reunión
-
Obtener reunión
Mejora de la API GetSessionInfo
para devolver el estado de los participantes en la sesión en curso
Se agregaron dos elementos nuevos(tieneHostInMeeting
, hasAttendeeInMeeting ) en respuesta
a GetSessionInfo
. Estos dos elementos volverán cuando la reunión esté en curso.
Elemento |
Descripción |
---|---|
|
Si el anfitrión ha entró a la reunión en curso. Verdadero: El anfitrión está en la reunión en curso. Falso/Nulo: El host no está en la reunión en curso o la reunión no está en curso. |
|
Si hay un asistente/organizador que haya participado en la reunión en curso. Verdadero: hay un asistente u organizador en una reunión en curso. Falso/Nulo: no hay ningún asistente ni organizador en la reunión en curso o la reunión no está en curso. |
Ejemplo de respuesta de API:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ep:status>INPROGRESS</ep:status>
<ep:hasHostInMeeting>true</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
...
</serv:message>
API afectadas:
GetSessionInfo
La API GetUserCard requiere autorización.
Mejora de seguridad: la API de XML GetUserCard
requiere autorización para obtener información del usuario.
API afectadas:
GetUserCard
Actualizaciones de la API 40.8.0
Actualizaciones de la API de XML 40.8.0
Haga clic aquí para descargar el esquema de la API de XML 40.8.0
Mejora de la respuesta GetSessionInfo
Si no se lo invita ni aprueba de la reunión, su llamada a la API de XML: GetSessionInfo
no devolverá los elementos: confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
en el cuerpo de respuesta de la API.
Ejemplo de respuesta de API para reuniones:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>UNLISTED</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>MeetingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
Ejemplo de respuesta de API para capacitaciones/eventos:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>UNLISTED</ep:listStatus>
<ep:registration>true</ep:registration>
https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>true</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>INVITAR/REGISTRAR/RECHAZAR</ep:joinStatus>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>TrainingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
API afectadas:
-
GetSessionInfo
GetSessionInfo, GetUserCard
Mejoras de seguridad
Hemos hecho una mejora de seguridad en la API de XML GetSessionInfo
y GetUserCard
. Bloquearemos a los usuarios para que accedan a estas dos API en las próximas dos horas si su llamada alcanzó el límite en una hora sin errores encontrados en ningún dato.
La respuesta del estado de error es: "403 Prohibido"
API afectadas:-
GetSessionInfo
-
GetUserCard
meetingUUID
en soporte de solicitud y respuesta de API
Hemos agregado meetingUUID a la solicitud y respuesta de API donde sea que admitamos una reuniónKey/sessionKey
.
Solicitud de GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afectadas:
-
LstOpenSession
-
Obtener información de inscripción
-
LstsummaryMeeting
-
Pruebas LstScheduled
-
Obtener evento
-
Evento de resumen de Lstsu
-
LstmeetingusageHistory
-
LsttrainingsessionHistory
-
LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSession
Plantilla de sitios educativos (tipo de sesión EDU) en soporte para API de XML
Cuando sus sitios habilitan el tipo de sesión del Instructor de educación (EDU), la API de XML puede admitir para planificar una reunión con la plantilla de reunión de EDU.
API afectadas:
-
Crear reunión
-
Definir reunión
-
Crear evento
-
Establecer evento
-
Crearsesión de capacitación
-
ConfigurarSesión de capacitación
XML API CreateMeetingAttendee
and RegisterMeetingAttendee
support
Tanto CreateMeetingAttendee
como RegisterMeetingAttendee pueden comprobar el formulario de inscripción de asistentes requerido para la inscripción de Webex Meetings.
Y hay una nueva excepción para esta tarea:
Número de excepción |
Mensaje de excepción |
---|---|
040014 |
Faltan campos obligatorios (formulario de inscripción): ... |
Por ejemplo, si seleccionó "Cargo" y "Nombre de la empresa" como campos obligatorios para el registro de un asistente a Webex Meetings como se muestra a continuación, debe proporcionar valor en "Cargo" y "Nombre de la empresa" cuando llame a las dos API: CreateMeetingAttendee
y RegisterMeetingAttendee
.
Solicitud RegisterMeetingAttendee
:
FirstNameb LastName
FirstNameb
LastName
Engineer //Job Title
Cisco1234 //Company Name
...
;****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1####4####1
Solicitud CreateMeetingAttendee
:
FirstNameA LastNameA
FirstNameA
LastNameA
Engineer //Job Title
Cisco1234 //Company Name
...
;*****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1###4####1
040014 Excepción de respuesta
Ejemplo:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:result>FAILURE</serv:result>
Faltan campos obligatorios (formulario de registro): title,company
PRIMARY
040014
title,company
API afectadas:
-
CreateMeetingAttendee
-
RegistrarMeetingAttendee
Mejoras en la validación de correo electrónico de API de XML
La API de XML no debe permitir los caracteres de espacios en blanco en un correo electrónico, de manera que hemos mejorado la validación del correo electrónico para alinearse con el comportamiento de la página de Webex Meetings.
API afectadas:
-
CreateMeetingAttendee
-
Crear evento
-
Establecer evento
-
Crear contacto
-
SetContact
-
SetRecordingInfo
-
CreateMeetingAttendee
-
Crearsesión de capacitación
-
ConfigurarSesión de capacitación
-
CreateUser
-
SetUser
-
Crear reunión
-
Definir reunión
-
RegistrarMeetingAttendee
Actualizaciones de la API 40.7.0
Actualizaciones de la API de XML 40.7.0
Haga clic aquí para descargar el esquema de la API de XML 40.7.0
soporte para
meetingUUID
Hemos agregado meetingUUID a la solicitud y respuesta de API donde sea que admitamos una meetingKey o sessionKey.
GetSessionInfo
Ejemplo de solicitud:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
Ejemplo de solicitud:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
Ejemplo de respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afectadas:
-
LstmeetingattendeeHistory
-
LsttrainingattendeeHistory
-
LsteventattendeeHistory
-
LstsupportattendeeHistory
Soporte de correo electrónico de bienvenida de la API de CreateUser
para cuatro nuevos idiomas
El correo electrónico en formato HTML de bienvenida de XMLAPI es compatible con los siguientes cuatro idiomas nuevos:
-
Checo (LANGUAGEID=19)
-
Polaco (languageID=20)
-
Húngaro (languageID=21)
-
Nativo (LANGUAGEID=22)
XMLAPI envía el correo electrónico de bienvenida según el idioma o el languageID en la solicitud
CreateUser.
Ejemplo de uso de CreateUser
para enviar correo electrónico de bienvenida HTML (checo):
<?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">
<securityContext>
<siteName>xxx</siteName>
<webExID>Prueba</webExID>
<password>xxx</password>
</securityContext>
<cuerpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>prueba</firstName>
<lastName>usuario</lastName>
<webExId>usuario de prueba</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<privilegio>
<organizador>verdadero</organizador>
</privilege>
<languageID>19</languageID>
o
<language>Checo</language>
<active>ACTIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</bodyContent>
</cuerpo>
API 40.6.1, 40.4.9 Actualizaciones
API de XML 40.6.1, 40.4.9 Actualizaciones
Haga clic aquí para descargar el esquema de la API de XML 40.6.1
Haga clic aquí para descargar el esquema de la API de XML 40.4.9
Soporte para CreateMeeting/SetMeeting
Cuando planifica una reunión de Webex, LA API de XML CreateMeeting/SetMeeting le permite marcar o desmarcar o hacer clic en un campo obligatorio o no obligatorio del formulario de inscripción de asistentes.
La siguiente es una planificación de reuniones de muestra desde la página web del usuario donde puede verificar los campos requeridos como "Cargo", "Nombre de la empresa", "Ciudad" y "Estado" en el formulario de inscripción de asistente:
La siguiente es una asignación entre los campos de la página y los elementos de la API de XML:
Campos de página | Elemento XMLAPI |
---|---|
Cargo | |
Nombre de la empresa | |
Dirección 1 | |
Dirección 2 | |
Ciudad | |
Estado | |
Código postal | |
País/Región | |
Teléfono laboral | |
Fax |
Cambio de esquema: Agregar el elemento "registrationForm" a CreateMeeting
Cambio de esquema: Agregar el elemento "registrationForm" a SetMeeting
Cambio de esquema: Agregar el elemento "registrationForm" a GetMeeting
Ejemplo de solicitud de CreateMeeting
:
<accessControl>
<meetingPassword>contraseña</meetingPassword>
</accessControl>
<Opciones del asistente>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>false</auto>
</Opciones del asistente>
<registrationForm>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<req>false</req>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>falso</req></fax>
</registrationForm>
Ejemplo de solicitud de SetMeeting
:
<meetingkey>1015045339</meetingkey>
<metaData>
<confName>Nombre de la conferencia</confName>
<meetingType>3</meetingType>
</metaData>
<Opciones del asistente>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>true</auto>
</Opciones del asistente>
<registrationForm>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<req>false</req>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>falso</req></fax>
</registrationForm>
Ejemplo de respuesta de GetMeeting
:
1234567890@nombredelsitio.webex.com
1234567890@nombredelsitio.webex.com
false
true
true
false
false
verdadero
verdadero
false
false
falso
API afectadas:
-
Crear reunión
-
Definir reunión
-
Obtener reunión
-
Eliminar
El tipo de reunión E2EE no es compatible con una reunión de PMR
Cuando habilita una PMR durante una llamada con las API:CreateUser/SetUser/GetUser/GetMe
y solo está disponible un tipo de reunión E2EE, responderá al siguiente mensaje de error: "110063 El usuario debe tener al menos un tipo de reunión que no sea E2EE para habilitar la PMR".
API afectadas:
-
CreateUser
-
SetUser
-
GetUser
-
Obtenerme
Actualizaciones de la API 40.6.0
Actualizaciones de la API de XML 40.6.0
Haga clic aquí para descargar el esquema de la API de XML 40.6.0
Rol de administración de usuarios agregado
Hemos creado la función de administración de usuarios y ha cambiado el archivo del esquema para lo siguiente.
Esquema cambiado: Solicitud CreateUser
:
Esquema cambiado: SetUser
Esquema cambiado: Respuesta de GetMe
:
Esquema cambiado: Respuesta de LstsummaryUser
:
API afectadas:
-
CreateUser
-
SetUser
-
Obtenerme
-
Usuario de Lstsummary
Ejemplo de solicitud de CreateUser
:
<?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">
<securityContext>
<siteName>xxx</siteName>
<webExID>Administrador del sitio</webExID>
<password>xxxx</password>
</securityContext>
<cuerpo>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilegio>
<umSiteAdmin>true</umSiteAdmin>
<host>falso</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilege>
<languageID>3</languageID>
<active>ACTIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</cuerpo>
Soporte mediante el uso de la clave API para acceder a la GetUserCard
Ahora ofrecemos compatibilidad para usar la clave API (token JWT generado) para acceder a la API: GetUserCard
en esta versión.
Puede consultar estas páginas para obtener información sobre cómo aplicar una clave API y para generar un token JWT:
GetUserCard
Ejemplo de solicitud:
POST https://{sitename}.webex.com/WBXService/XMLService
Encabezado:
Content-Type application/json;charset=utf-8
JWTToken ${jwttoken}
Body:
<?xml version="1.0" encoding="UTF-8"?>
<message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2009/05/service">
<header>
<securityContext>
<siteName>{sitename}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUserCard">
<webExId>{userName}</webExId>
</bodyContent>
</body>
Ejemplo de respuesta:
<?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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:url>https://xxxx.webex.com/svc3300/svccomponents/html/img/avatar160.png</use:url>
<use:lastModifiedTime>1587493389768</use:lastModifiedTime>
<use:isUploaded>false</use:isUploaded>
</use:avatar>
<use:title>Sala personal de la prueba</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
Soporte para meetingUUID
en solicitud y respuesta de API
Hemos agregado meetingUUID a la solicitud y respuesta de API cuando ofrecemos soporte para una meetingKey o sessionKey.
API afectadas:
-
LstRecording
-
LstsummarySession
-
Obtener información de la ssesssion
-
ObtenerhosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
Crear reunión
-
Definir reunión
-
Obtener reunión
-
Eliminar
-
LstCalendarSession
meetingUUID
Ejemplo de solicitud:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
o
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
meetingUUID
Ejemplo de respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NO_INPROGRESS</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
Las claves de las reuniones de PMR no se cambiarán desde un usuario desactivado temporalmente o desde una PMR deshabilitada
Cuando un usuario desactivado temporal o una PMR deshabilitada se vuelve a activar en el plazo de una semana, el usuario ahora reactivado o la clave de reunión de LA PMR habilitada no se modifican, será igual que antes.
API afectadas:
-
SetUser
-
DelUser
Mejoras de LstSummarySession
Mejoramos la API: LstSummarySession
devuelve scheduled-PMR para tener un nuevo elemento, returnScheduledPMR
, en la solicitud. Y la alternancia de características predeterminada está desactivada.
API afectadas:
-
LstSummarySession
Cambio de esquema:
Agregamos un nuevo nombre de elemento returnScheduledPMR
en la solicitud LstSummarySession de API.
Agregamos un nuevo nombre de elemento esScheduledPMR
en la respuesta LstSummarySession de API.
Ejemplo de solicitud LstSummarySession
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<securityContext>
<siteName>xxx</siteName>
<webExID>Prueba</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
<cuerpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>Y</listMethod>
<dateScope>
<startDateStart>11/01/2019 8:0:0</startDateStart>
<startDateEnd>12/01/2019 7:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>11/01/2019 8:0:0</endDateStart>
<endDateEnd>12/01/2019 7:59:59</endDateEnd>
</dateScope>
<pedido>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>HORA DE ESPERA</orderBy>
<orderAD>ASC</orderAD>
</pedido>
<serviceTypes>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
</serviceTypes>
<returnScheduledPMR>true</returnScheduledPMR>
</bodyContent>
</cuerpo>
LstSummarySession
Ejemplo de respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ep:lstsummarySessionResponse">
<ep:matchingRecords>
<serv:total>1787</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</ep:matchingRecords>
<ep:session>
<ep:sessionKey>809914325</ep:sessionKey>
<ep:MeetingUUID>809914325</ep:MeetingUUID>
<ep:confName>Reunión de equipo</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Prueba</ep:hostWebExID>
<ep:hostFirstName>Prueba</ep:hostFirstName>
<ep:hostLastName>Prueba</ep:hostLastName>
<ep:otherHostWebExID>Prueba</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Hawái (Honolulu)</ep:timeZone>
<ep:status>NO_INPROGRESS</ep:status>
<ep:startTime>10/12/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:session>
<ep:session>
<ep:sessionKey>805660167</ep:sessionKey>
<ep:confName>xmlmc Molly08Console816960001</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Molly08Console81696000</ep:hostWebExID>
<ep:hostFirstName>Molly08Console81696000</ep:hostFirstName>
<ep:hostLastName>Molly08Console81696000</ep:hostLastName>
<ep:otherHostWebExID>Molly08Console81696000</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Hawái (Honolulu)</ep:timeZone>
<ep:status>NO_INPROGRESS</ep:status>
<ep:startTime>10/12/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:hostEmail>Molly08Console81696000@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:session>
</serv:bodyContent>
Mejoras de GetSite
Hemos agregado una alternancia de características de respuesta de GetSite
de SupportXMLAPIReturnScheduledPMR
API afectadas:
-
GetSite
Cambio de esquema:
El nuevo elemento de respuesta de la API de XML GetSite
es: SupportXMLAPIReturnScheduledPMR
Ejemplo de solicitud de GetSite
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
Ejemplo de respuesta de GetSite
:
<?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: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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns1:siteInstance>
<ns1:siteCommonOptions>
...
<ns1:SupportXMLAPIReturnScheduledPMR>true</ns1:SupportXMLAPIReturnScheduledPMR>
...
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
API 40.4.8, 40.2.9 Actualizaciones
API de XML 40.4.8, actualizaciones de 40.2.9
Haga clic aquí para descargar el esquema de la API de XML 40.4.8
Haga clic aquí para descargar el esquema de la API de XML 40.2.9
Nueva respuesta al actualizar reuniones planificadas en XMLAPI
Cuando los clientes usen XMLAPI para actualizar reuniones planificadas a través de su página, enviaremos la contraseña numérica en una actualización del correo electrónico de la reunión y la aplicaremos a Webex Meetings, Teams y Events Centers.
Esas API: GetMeeting, GetTrainingSession, GetEvent
y GetTeleconferenceSession
, tendrán estos nuevos elementos como respuesta: audioPassword
(contraseña numérica), isEnforceAudioPassword
, isEnforceAudioLogin
para los centros de Webex Meetings, Teams y Events.
Esquema cambiado:
API afectadas:
-
Obtener reunión
-
Obtener CapacitaciónSesión
-
Obtener evento
-
GetTeleconferenceSession
Ejemplo de solicitud de GetMeeting
:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>testSite</siteName>
<webExID>test</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</body>
Ejemplo de respuesta:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:accessControl>
<meet:listToPublic>false</meet:listToPublic>
<meet:isPublic>false</meet:isPublic>
<meet:meetingPassword>PkzC8tP7kM5</meet:meetingPassword>
<meet:audioPassword>75928877</meet:audioPassword>
<meet:isEnforceAudioPassword>true</meet:isEnforceAudioPassword>
<meet:isEnforceAudioLogin>false</meet:isEnforceAudioLogin>
</meet:accessControl>
...
...
</serv:bodyContent>
API 40.4.5, 40.2.6 Actualizaciones
API de XML 40.4.5, actualizaciones de 40.2.6
Límite de uso de GetUserCard
y GetSessionInfo
Implementamos el límite de uso en la API GetUserCard
y GetSessionInfo
; puede obtener el mensaje de error: "403 forbidden" si alcanza el límite de uso.
API afectadas:
-
GetUserCard
-
GetSessionInfo
API 40.4.4, 40.2.5 Actualizaciones
Actualizaciones de la API de XML 40.4.4, 40.2.5
Límite de números de BodyContent
Hemos agregado una cantidad limitada de BodyContent
en cada sección de API de XML. Cuando agrega demasiados BodyContent
en la solicitud de la API, aparecerá el siguiente código de error y mensaje: "000053 El recuento de BodyContent en una solicitud debe ser inferior a {number}".
API afectadas:
-
Cualquier API de XML
Solicitud de API de XML con varios BodyContent
Ejemplo:
<?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>xxxx</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser">
<webExId>xxx</webExId>
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetSite">
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>801020403</sessionKey>
</bodyContent>
</body>
API 40.4.3, 40.2.4 Actualizaciones
API de XML 40.4.3, actualizaciones de 40.2.4
Haga clic aquí para descargar el esquema de la API de XML 40.4.3, 40.2.4.
Mejoras de CreateUser
Hemos mejorado CreateUser para
que sea compatible con el correo electrónico de bienvenida en varios idiomas. CreateUser
solicita ahora isHTMLEmail
API afectadas:
-
CreateUser
Ejemplo de solicitud de CreateUser
:
<?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">
<securityContext>
<webExID>administrador</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
<cuerpo>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilegio>
<organizador>verdadero</organizador>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilege>
<languageID>3</languageID>
<active>ACTIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</cuerpo>
Actualizaciones de la API 40.4.0
Actualizaciones de la API de XML 40.4.0
Exigir la verificación del correo electrónico al cambiar los correos electrónicos en la API de XML
Después de que el administrador del sitio habilite la confirmación necesaria para que el usuario actualice la dirección de correo electrónico en la Administración del sitio de Webex:
-
Si una cuenta de administrador que no es del sitio llama a la API setUser para cambiar las direcciones de correo electrónico, el correo electrónico actual permanece hasta que
se verifique el nuevo correo
electrónico. El correo electrónico de confirmación del cambio de cuenta se envía a la nueva dirección de correo electrónico con la "Confirmación de cambio de cuenta de Webex". Después de hacer clic en el enlace del correo electrónico para confirmar, la nueva dirección de correo electrónico se vincula inmediatamente.Si un administrador que no es del sitio llama varias veces a la API SetUser sin finalizar el proceso de verificación del correo electrónico, se guarda el correo electrónico actual y el nuevo correo electrónico más reciente es el que debe
verificarse.
-
Si una cuenta de administrador del sitio llama a la API setUser para cambiar las direcciones de correo electrónico, no se activa el proceso de verificación
del correo electrónico. El nuevo correo electrónico se vinculará inmediatamente a la cuenta del organizador o del asistente.
API afectadas:
-
SetUser
Tiempo de espera de GetEnrollmentInfo
y restablecimiento de conexiones
La API GetEnrollmentInfo actualmente busca direcciones IP en el sistema de nombres de dominio, lo que genera grandes impactos en el rendimiento. Tenemos previsto simplificar este proceso con una respuesta vacía en el campo
.
API afectadas:
-
Obtener información de inscripción
Ejemplo de solicitud de GetEnrollmentInfo
:
<?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>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
Ejemplo de respuesta de GetEnrollmentInfo
:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="att:getEnrollmentInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<att:session>
<att:confID>154279066999981548</att:confID>
<att:asistente>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>Alex</att:firstName>
<att:lastName>Yang</att:lastName>
<att:email>omega.alex.yang@gmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:código postal></att:código postal>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.35.240.53</att:ipAddress>
<att:submitTime>27/02/2020 22:03:57</att:submitTime>
<att:status>APROBADO</att:status>
</att:asistente>
<att:asistente>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>Prueba</att:lastName>
<att:email>achillesyang@hotmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:código postal></att:código postal>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.154.181.15</att:ipAddress>
<att:submitTime>27/02/2020 22:07:38</att:submitTime>
<att:status>APROBADO</att:status>
</att:asistente>
<att:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</att:matchingRecords>
<att:sessionKey>716773566</att:sessionKey>
</att:session>
</serv:bodyContent>
Actualizaciones de la API 40.2.0
Actualizaciones de la API de XML 40.2.0
Haga clic aquí para descargar el esquema de la API de XML 40.2.0.
Eliminar el acceso anónimo a LstSummarySession
Como una mejora de seguridad, estamos deteniendo el soporte para el acceso anónimo a la API de LstSummarySession.
Si Webex Meetings accede anónimamente a la API, se devuelve el siguiente código de error y mensaje: "000015 Lo sentimos, no se encontró ningún registro".
API afectadas:
-
LstSummarySession
Ejemplo de solicitud LstSummarySession
:
<?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>
<siteName>nombredelsitio1</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
LstSummarySession
Ejemplo de respuesta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>ERROR</serv:result>
<serv:reason>Lo sentimos, no se encontró ningún registro</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Mejoras de seguridad de CreateMeeting
y SetMeeting
Este cambio se realizó en la API de XML 40.2.0, pero su descripción se editó después de recibir comentarios del cliente.
Como una mejora de seguridad, hemos actualizado las API de CreateMeeting y SetMeeting para que no permitan a los usuarios planificar una hora de inicio de reunión
que ya haya pasado. Si lo intentan, la API muestra el mensaje de error: "060016 La hora de inicio de la sesión debe ser posterior a la hora actual". Si un usuario necesita planificar una reunión instantánea, le recomendamos que establezca la hora de inicio de la reunión cinco minutos más tarde que la hora actual.
API afectadas:
-
Crear reunión
-
Definir reunión
Actualizaciones de API 40.1.2
Actualizaciones de la API de XML 40.1.2
Haga clic aquí para descargar el esquema de la API de XML 40.1.2.
La planificación de una reunión genera automáticamente una contraseña si no se proporciona una
Hemos mejorado la sesión CreateMeeting
, CreateEvent ,
CreateTrainingSession
y CreateTeleconferenceSession
para incluir una contraseña en el cuerpo de la respuesta de la API.
De manera predeterminada, la configuración Todas las reuniones,eventos/sesiones debe tener habilitada una contraseña. En esta situación, si la solicitud API no incluye una contraseña, se genera una contraseña automáticamente desde los servidores de API de XML.
Si la configuración Todos los eventos/las reuniones/las sesiones debe tener una contraseña deshabilitada, y la solicitud API no incluye una contraseña, no se genera una contraseña desde los servidores de API de XML.
Si la solicitud API incluye una contraseña, la respuesta incluirá esa contraseña, independientemente de que todos los eventos/las reuniones/las sesiones deben tener habilitada o deshabilitada la configuración de una contraseña.
API afectadas:
-
Crear reunión
-
Crear evento
-
Crearsesión de capacitación
-
CrearSesión de audio conferencia
La respuesta de CreateMeeting
ahora tiene el elemento meetingPassword:
Ejemplo de solicitud de CreateMeeting
:
<?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>
<siteName>siteName1</siteName>
<webExID>userID</webExID>
<password>*****</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<metaData>
<confName>Test_Auto_Generated_mtg_pwd</confName>
<meetingType>3</meetingType>
</metaData>
<schedule>
<startDate>28/10/2020 17:35:00</startDate>
</schedule>
</bodyContent>
</body>
Ejemplo de respuesta de CreateMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:createMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:meetingkey>806745263</meet:meetingkey>
<meet:meetingPassword>UzXJuzUD428</meet:meetingPassword>
<meet:iCalendarURL>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
</meet:iCalendarURL>
<meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
</serv:bodyContent>
La respuesta crear evento ahora tiene el elemento
eventPassword:
Las respuestas CreateTrainingSession
y CreateTeleconferenceSession
ahora tienen el elemento sessionPassword:
Actualizaciones de API 40.1.0
Actualizaciones de la API de XML 40.1.0
Haga clic aquí para descargar el esquema de la API de XML 40.1.
Mejoras de GetSessionInfo
Hemos agregado nuevos elementos a la API GetSessionInfo.
La API ahora también devuelve información para los dispositivos móviles.
API afectadas:
-
GetSessionInfo
Solicitar actualizaciones de GetSessionInfo
:
Ejemplo de solicitud:
<?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>
<siteName>sqdemo11</siteName>
<webExID>siteadmin</webExID>
<password>P@ss1234</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>713707633</sessionKey>
https://go.webex.com/join/dongchen</pmrUrl>
<sipUrl>dongchen@go.webex.com o 123456789_go@webex.com o 123456789@go.webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</body>
<
Mejoras en LstAccessAnywhereHistory
Hemos agregado una nueva API, lstAccessAnywhereHistory , para responder con la información
del informe de Webex Access Anywhere.
API afectadas:
-
LstAccessAnywhereHistory
Actualizaciones de la solicitud de LstAccessAnywhereHistory
:
Actualizaciones de la respuesta de LstAccessAnywhereHistory
:
Ejemplo de solicitud:
<?xml version="1.0" encoding="UTF-8"?>
<serv:mensaje
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>prueba</webExID>
<password>P@ss1234</password>
</securityContext>
<cuerpo>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>29/09/2019 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>29/12/2019 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>29/9/2019 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>29/12/2019 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>O</serv:listMethod>
<pedido>
<orderBy>HORA DE ESPERA</orderBy>
<orderAD>ASC</orderAD>
</pedido>
</bodyContent>
</cuerpo>
Ejemplo de respuesta:
<?xml version="1.0" encoding="UTF-8"?>
<serv:mensaje
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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARIO</serv:gsbStatus>
</serv:respuesta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:LstAccessAnywhereHistoryResponse"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:matchingRecords>
<serv:total>775</serv:total>
<serv:returned>10</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
<history:accessAnyWhereInfo>
<history:confID>123456</history:confID>
<history:userName>dean</history:userName>
<history:computerName>6926_dean</history:computerName>
<history:clientIP>10.224.222.183</history:clientIP>
<history:startTime>29/11/2019 03:05:44</history:startTime>
<history:endTime>29/11/2019 03:10:06</history:endTime>
<history:duration>5</history:duration>
</history:accessAnyWhereInfo>
</serv:bodyContent>