- Главная
- /
- Статья
Обзор обновлений API Cisco Webex Meetings (API 40).
Найдите всю необходимую информацию о Cisco Webex Meetings API, например изменения схемы и другие объявления.
Дополнительную информацию об API XML 41 см. в обзоре обновлений API Cisco Webex Meetings (API 41)
Дополнительную информацию об XML API 39 и XML API 11 см. в статье Обзор обновлений XML API Cisco Webex Meetings (XML API 39 и более ранние версии).
Информацию об обновлениях XML API 11 SP9 и более ранних выпусков см. в разделе Cisco DevNet.
Обновления API 40.12.0
Обновления API XML 40.12.0
API XML поддерживает тип "Личное совещание"
Будут также затронуты API XML
-
Можно использовать API:
CreateMeeting
иSetMeeting
для планирования или обновления совещания Webex с типом "Личное совещание". -
Если совещание Webex запланировано с типом "Личное совещание",
GetSessionInfo
GetMeeting
,LstSummarySession
иLstCalendarSession
будут возвращать новый элемент с именемPrivateMeeting
для информирования об этом. -
GetMeetingType
иLstMeetingType
возвращают новый элемент с именем
, который указывает, поддерживает ли он личные совещания или нет.SupportPrivateMeeting
Изменения схемы
API XML: GetMeetingType/LstMeetingType: Добавьте элемент .
API XML: LstSummarySession
: добавление элемента <isPrivateMeeting>
.
API XML: LstCalendarSession
: добавление элемента <isPrivateMeeting>
.
API XML: GetSessionInfo
: добавление элемента <isPrivateMeeting>
.
API XML: GetMeeting: добавление элемента <isPrivateMeeting>
.
Запрос API XML: CreateMeeting
Запрос CreateMeeting с типом "Личное совещание"
25.10.2020 13:00:00
45
45
>
********
MC_PrivateMeeting_Тест
168 //169 — пример, поддерживающий личное совещание
Ответ API XML: GetSessionInfo
Ответ для isPrivateMeeting
false
true
true //true: совещание поддерживает тип "Личное совещание"; false: совещание не поддерживает личное совещание.
false
false
true
API GetSite возвратит шаблоны совещаний на уровне веб-сайта
Пользовательский сценарий / описание задачи
API GetSite для возврата шаблона совещания на уровне веб-сайта. Это обеспечит отображение этих шаблонов в Education Connector и Webex Classrooms для преподавателей, а также возможность выбора этих шаблонов при планировании онлайн-сеансов.
Затронутые API
Если настраиваемые шаблоны совещаний являются шаблонами на уровне веб-сайта, API GetSite возвратит эти шаблоны.
Названия элементов |
Описание |
---|---|
|
названия настраиваемых шаблонов совещаний на уровне веб-сайта |
|
Webex Meetings, Webex Trainings и Webex Events |
Изменения схемы
GetSite : Добавьте элемент .
Пример ответа
Ответ GetSite
3
PRO
Tempalte совещания MC 1
MeetingCenter
EC Meeting Tempalte 2
EventCenter
Шаблон совещания TC 3
TrainingCenter
API XML SetUser не может изменить элемент supportedServices
, если веб-сайт является унифицированным веб-сайтом CI
Описание
API XML SetUser
не поддерживает изменение значения "supportedServices
" в запросе API, если веб-сайт является унифицированным веб-сайтом Webex Meetings, связанным с Control Hub.
Изменения схемы
Не предусмотрено изменение схемы в API: SetUser
.
WEBEX-15436: Добавление защиты во избежание дублирования сообщений электронной почты в Mtgconfattendeelist
Описание
Если несколько посетителей с одинаковым адресом электронной почты добавлены в одно и то же совещание в одном запросе API, будет обработан только первый посетитель с этим адресом электронной почты.
Затронутые API
-
CreateMeetingAttendee
-
CreateUser
-
SetUser
-
CreateMeeting
-
SetMeeting
-
CreateEvent
-
SetEvent
-
CreateTrainingSession
-
SetTrainingSession
Пример API
Запрос
<?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">
<заголовок>
<securityContext>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>password</password>
</securityContext>
</заголовок>
<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>
<посетители>
<person>
<email>test@webex.com</email>
<name>name2</name>
</person>
<sessionKey>1714904382</sessionKey>
</посетители>
</bodyContent>
</body>
Обновления API 40.11.0
Обновления API XML 40.11.0
API XML CreateUser поддерживает параметр displayname
CreateUser
поддерживает dispalyname
, если переключатель функции EnableDisplayName
равен 1. Если для переключателя функции установлено значение, отличное от 1, параметр displayName
будет проигнорирован.
Изменения схемы
CreateUser:
API XML SetUser поддерживает параметр displayname
SetUser
поддерживает dispalyname
, если переключатель функции EnableDisplayName
равен 1. Если для переключателя функции установлено значение, отличное от 1, параметр displayName
будет проигнорирован.
Изменения схемы
SetUser:
API XML GetUser поддерживает параметр displayname
GetUser
поддерживает dispalyname
, когда переключатель функции EnableDisplayName
равен 1. Если для переключателя функции установлено значение, отличное от 1, значение displayName
не будет отображаться.
Если в БД для параметра displayName
указано нулевое значение и для переключателя функции EnableDisplayName
установлено значение 1, параметр displayName
будет отображаться как firstName+" "+lastName
для неазиатских символов и как firstName+lastName
для азиатских символов.
Изменения схемы
GetUserResponse:
API XML для управления на уровне пользователя параметром "Передача голоса по IP для CMR гибридного типа"
С помощью настройки cmrHybridVoip
можно настраивать параметр EnableCMRHybridVoIP
и извлекать значение настройки на уровне пользователя.
Изменения схемы
Ответ GetUser:
Запрос CreateUser:
Запрос SetUser:
Обновления API 40.10.0
Обновления API XML 40.10.0
Поддержка API XML для UUID совещания
в запросе и ответе API
Пример API XML: Запрос 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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</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: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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_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:
-
CreateMeetingAttendee
-
DelMeetingAttendee
-
RegisterMeetingAttendee
-
CreateTeleconferenceSession
-
SetTeleconferenceSession
-
GetTeleconferenceSession
-
CreateTrainingSession
-
SetTrainingSession
-
GetTrainingSession
-
DelTrainingSession
-
CreateEvent
-
SetEvent
-
DelEvent
XMLAPI будет возвращать дополнительный элемент конфигурации администратора веб-сайта для отключения возможности создавать снимок экрана
Это требование установлено из соображений безопасности как на основании ошибок, выявленных в ходе испытаний на проникновение
, так и по просьбе таких клиентов, как банк Goldman Sachs. Им не нужно, чтобы конечные пользователи могли делать снимок экрана в приложении Meetings. При этом многим клиентам необходимо иметь такую функцию, чтобы делать снимки экрана. Кроме того, возможность делать снимок экрана необходима и пользователям Education. В связи с этим для этой возможности будет предоставлена настройка на уровне администратора веб-сайта. Также для поддержки этой возможности XMLAPI будет возвращать дополнительное поле EnableMobileScreenCapture
в ответе GetSite
.
Пример запроса 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">
<заголовок>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Test</webExID>
<password>xxxx</password>
</securityContext>
</заголовок>
<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>УСПЕХ</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>
Затронутые API
GetSite
Поддержка улучшения присоединения без ПИН MEET-269 для XMLAPI
Для совещания в персональной комнате и совещания MC в XMLAPI добавлен НОВЫЙ ПАРАМЕТР Системы для видеоконференций в моей организации могут начинать совещания и присоединяться к ним без запроса.
-
createUser/setUser/getUser
добавить новый узелdeviceCanStartMyPMR
вперсональная комната совещаний
. -
createMeeting/setMeeting/getMeeting
add a new nodedeviceCanStartMeeting
in schedule.
Параметр в пользовательском интерфейсе Webex для совещания в персональной комнате.
Изменения схемы
CreateUser:
SetUser:
getUserResponse:
CreateMeeting:
setMeeting:
getMeetingResponse:
Обновления API 40.9.0
Обновления API XML 40.9.0
Поддержка API XML для запроса и ответа UUID
совещания
Для поддержки meetingKey
или sessionKey
в запрос и ответ API добавлен параметр meetingUUID.
Пример API XML: Запрос 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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</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: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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_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:
-
GetEnrollmentInfo
-
LstsummaryTrainingSession
-
AddScheduledTest
-
SetScheduledTest
-
DelScheduledTest
-
GetTestInformation
-
UploadEventImage
-
SendInvitationEmail
-
CreateSupportSession
-
LstmeetingusagePreliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
LsteventsessionPreliminaryHistory
-
LsteventattendeePreliminaryHistory
-
LstTrainingPollResultsHistory
Для совещаний Webex будет предусмотрен заблокированный холл совещания, где пользователи смогут ожидать допуска на совещание.
Будет внедрена поддержка заблокированного холла для планирования и редактирования совещаний MC с помощью API XML при включенной функции (ConsistentLockedLobby
).
Изменения схемы
В API CreateMeeting, SetMeeting и GetMeeting
добавлены три новых элемента (externalAttendeeSecurity
, autoLock
, autoLockWaitTime).
Элемент |
Описание |
---|---|
|
Если совещание разблокировано, на выбор доступны три элемента безопасности присоединения внешних пользователей.
|
|
Нужно ли автоматически блокировать совещание. Верно: автоматически блокировать совещание через # мин после его начала. Ложь: не блокировать совещание автоматически после его начала. |
|
Количество минут (0, 5, 10, 15, 20) до автоматической блокировки совещания после его начала |
Пример запроса и ответа
Запрос CreateMeeting.
...
...
false
AllowJoinWithLobby
true
10
...
Запрос SetMeeting.
2###1###01
...
...
false
AllowJoinWithLobby
true
10
...
Ответ 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>УСПЕХ</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">
...
<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:message>
Затронутые API:
-
CreateMeeting
-
SetMeeting
-
GetMeeting
Усовершенствование API GetSessionInfo
для возврата статуса участников на текущем сеансе
В ответ GetSessionInfo
добавлены два новых элемента (hasHostInMeeting
и hasAttendeeInMeeting
). Эти два элемента будут возвращены, если совещание уже началось.
Элемент |
Описание |
---|---|
|
Присоединился ли организатор к совещанию, которое уже началось. Верно: организатор присоединился к совещанию, которое уже началось. False/Null: организатор не присоединился к совещанию, которое уже началось, или совещание не начато. |
|
Присоединился ли какой-либо посетитель или организатор к совещанию, которое уже началось. Верно: какой-либо посетитель или организатор присоединился к совещанию, которое уже началось. False/Null: ни один из посетителей или организатор не присоединился к совещанию, которое уже началось, или совещание не начато. |
Пример ответа XML.
<?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>УСПЕХ</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:
GetSessionInfo
API GetUserCard требует авторизации.
Усовершенствование безопасности: API XML GetUserCard
требует авторизации для получения информации о пользователе.
Затронутые API:
GetUserCard
Обновления API 40.8.0
Обновления API XML 40.8.0
Улучшение ответа GetSessionInfo
Если вы не приглашены на совещание или ваше участие не утверждено, ваш вызов API XML: GetSessionInfo
не возвращает элементы: confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
в теле ответа API.
Пример ответа API для совещаний:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_INPROGRESS</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>СКРЫТЫЕ</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>
Пример ответа API для сеансов обучения и event-совещаний:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_INPROGRESS</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>СКРЫТЫЕ</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>INVITE/REGISTER/REJECT</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:
-
GetSessionInfo
Улучшения безопасности GetSessionInfo,
GetUserCard
Усовершенствованы параметры безопасности в API XML GetSessionInfo
и GetUserCard
. Доступ пользователей к этим двум API будет заблокирован на два часа, если их вызов достигнет предельного значения в течение часа с ошибками об отсутствии данных.
Ответ о состоянии ошибки: "403 Запрещено"
Затронутые API:-
GetSessionInfo
-
GetUserCard
meetingUUID
в поддержке запросов и ответов API
Для поддержки meetingKey/sessionKey
в запрос и ответ API добавлен параметр meetingUUID.
Запрос 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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</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: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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_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:
-
LstOpenSession
-
GetEnrollmentInfo
-
LstsummaryMeeting
-
LstScheduledTests
-
GetEvent
-
LstsummaryEvent
-
LstmeetingusageHistory
-
LsttrainingsessionHistory
-
LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSession
Поддержка шаблона веб-сайтов, задействованных в обучении (тип сеанса EDU), в API XML
Если на веб-сайтах включен тип сеанса "Инструктор по обучению" (EDU), API XML может поддерживать планирование совещаний с помощью шаблона совещания EDU.
Затронутые API:
-
CreateMeeting
-
SetMeeting
-
CreateEvent
-
SetEvent
-
CreateTrainingSession
-
SetTrainingSession
Поддержка API XML CreateMeetingAttendee
и RegisterMeetingAttendee
CreateMeetingAttendee
и RegisterMeetingAttendee
могут выполнять проверку обязательной формы регистрации посетителя для регистрации в совещаниях Webex.
Для этой задачи появилось новое исключение.
Номер исключения |
Сообщение для исключения |
---|---|
040014 |
Отсутствуют обязательные поля (форма регистрации): ... |
Например, если поля "Должность" и "Название компании" выбраны в качестве обязательных полей для регистрации посетителя на совещания Webex, как указано ниже, необходимо указать значения полей "Должность" и "Название компании" при вызове двух API: CreateMeetingAttendee
и RegisterMeetingAttendee
.
Запрос RegisterMeeting
Attendee:
Фамилия FirstNameb
FirstNameb
Фамилия
Инженер //должность
Cisco1234 //Название компании
...
****@*****.com
ПОСЕТИТЕЛЬ
true
ПОСЕТИТЕЛЬ
ACCEPT
true
1####4####1
Запрос CreateMeetingAttendee
:
FirstNameA LastNameA
FirstNameA
LastNameA
Инженер //должность
Cisco1234 //Название компании
...
*****@*****.com
ПОСЕТИТЕЛЬ
true
ПОСЕТИТЕЛЬ
ACCEPT
true
1###4####1
040014 Исключение ответа
Пример:
<?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>
Отсутствуют обязательные поля (форма регистрации): название, компания
PRIMARY
040014
название, компания
Затронутые API:
-
CreateMeetingAttendee
-
RegisterMeetingAttendee
Усовершенствования проверки адреса электронной почты с помощью API XML
API XML не должен разрешать использование символов пробела в адресе электронной почты. В связи с этим усовершенствована проверка адреса электронной почты для соответствия поведению на странице Webex Meetings.
Затронутые API:
-
CreateMeetingAttendee
-
CreateEvent
-
SetEvent
-
CreateContact
-
SetContact
-
SetRecordingInfo
-
CreateMeetingAttendee
-
CreateTrainingSession
-
SetTrainingSession
-
CreateUser
-
SetUser
-
CreateMeeting
-
SetMeeting
-
RegisterMeetingAttendee
Обновления API 40.7.0
Обновления API XML 40.7.0
поддержка
meetingUUID
Для поддержки meetingKey или sessionKey в запрос и ответ API добавлен параметр meetingUUID
.
Пример запроса
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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Пример запроса
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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Пример ответа
GetSessionInfo:
<?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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_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:
-
LstmeetingattendeeHistory
-
LsttrainingattendeeHistory
-
LsteventattendeeHistory
-
LstsupportattendeeHistory
Поддержка приветственного сообщения электронной почты
API CreateUser для четырех новых языков
Приветственное электронное сообщение API XML в формате HTML поддерживаются на приведенных ниже четырех языках.
-
Чешский (languageID = 19)
-
Польский (languageID = 20)
-
Венгерский (languageID = 21)
-
Румынский (languageID = 22)
API XML отправляет приветственное электронное сообщение в соответствии с языком или идентификатором languageID, указанным в запросе CreateUser
.
Пример использования CreateUser
для отправки приветственного сообщения HTML (чешский язык):
<?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>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>test</firstName>
<lastName>user</lastName>
<webexId>testuser</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<привилегия>
<host>true</host>
</привилегия>
<languageID>19</languageID>
или
<language>Чешский</language>
<active>ACTIVATED</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</bodyContent>
</body>
Обновления API 40.6.1, 40.4.9
Обновления API XML 40.6.1, 40.4.9
Поддержка CreateMeeting/SetMeeting
API XML CreateMeeting/SetMeeting
позволяет при планировании совещания Webex установить/снять флажок или сделать поле обязательным/необязательным в форме регистрации посетителя.
Ниже приведен пример планирования совещаний на веб-странице пользователя, где можно установить обязательные поля, такие как "Должность", "Название компании", "Город" и "Область" в форме регистрации посетителя.
Ниже приведено сопоставление полей страницы и элементов API XML.
Поля страниц Элемент API XML Заголовок задания <title>
Название компании <company>
Адрес 1 <address1>
Адрес 2 <address2>
Город <city>
Состояние <state>
Почтовый индекс <postalCode>
Страна или регион <country>
Рабочий телефон <phone>
Факс <fax>
Измененная схема. Добавление элемента registrationForm в CreateMeeting
Измененная схема. Добавление элемента registrationForm в SetMeeting
Измененная схема. Добавление элемента registrationForm в GetMeeting
Пример запроса
CreateMeeting:
<accessControl>
<meetingPassword>password</meetingPassword>
</accessControl>
<attendeeOptions>
<emailInvite>true</emailInvite>
<registration>true</registration>
<auto>false</auto>
</attendeeOptions>
<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>
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</registrationForm>
Пример запроса
SetMeeting:
<meetingkey>1015045339</meetingkey>
<metaData>
<confName>Название конференции</confName>
<meetingType>3</meetingType>
</metaData>
<attendeeOptions>
<emailInvite>true</emailInvite>
<registration>true</registration>
<auto>true</auto>
</attendeeOptions>
<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>
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</registrationForm>
Пример ответа GetMeeting
<meet:sipURL>1234567890@sitename.webex.com</meet:sipURL>
<meet:displayMeetingUrl>1234567890@sitename.webex.com</meet:displayMeetingUrl>
<meet:registrationForm>
<meet:phone><meet:req>ложно</meet:req></meet:phone>
<meet:title><meet:req>true</meet:req></meet:title>
<meet:company><meet:req>true</meet:req></meet:company>
<meet:address1><meet:req>false</meet:req></meet:address1
<meet:address2><meet:req>false</meet:req></meet:address2>
<meet:city><meet:req>true</meet:req></meet:city>
<meet:state><meet:req>true</meet:req></meet:state>
<meet:postalCode><meet:req>false</meet:req></meet:postalCode>
<meet:country><meet:req>false</meet:req></meet:country>
<meet:fax><meet:req>ложно</meet:req></meet:fax>
</meet:registrationForm>
Затронутые API:
-
CreateMeeting
-
SetMeeting
-
GetMeeting
-
DelMeeting
Тип совещания E2EE не поддерживает совещания PMR
При включении PMR во время вызова с помощью API:CreateUser/SetUser/GetUser/GetMe
и доступен только тип совещания E2EE, он ответит на следующее сообщение об ошибке: "110063 Для включения PMR у пользователя должен быть хотя бы один тип совещания, не связанный с E2EE".
Затронутые API:
-
CreateUser
-
SetUser
-
GetUser
-
GetMe
Обновления API 40.6.0
Обновления API XML 40.6.0
Роль "Управление пользователями" добавлена
Вы создали роль "Управление пользователями". Файл схемы для приведенных ниже параметров изменен.
Измененная схема. Запрос
CreateUser:
Измененная схема. SetUser
Измененная схема. GetMe
response:
Измененная схема. Ответ
LstsummaryUser:
Затронутые API:
-
CreateUser
-
SetUser
-
GetMe
-
LstsummaryUser
Пример запроса
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>SiteAdmin</webExID>
<password>xxxx</password>
</securityContext>
</заголовок>
<body>
<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>
<привилегия>
<umSiteAdmin>true</umSiteAdmin>
<host>false</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</привилегия>
<languageID>3</languageID>
<active>ACTIVATED</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</body>
Поддержка доступа с помощью ключа API к GetUserCard
Теперь в этом выпуске поддерживается использование ключа доступа API (созданного маркера JWT) GetUserCard
в этом выпуске.
Справочную информацию о применении одного ключа API и создании маркера JWT см. на страницах ниже.
Пример запроса
GetUserCard:
POST https://{sitename}.webex.com/WBXService/XMLService
Заголовок:
Content-Type application/json;charset=utf-8
JWTToken ${jwttoken}
Корпус:
<?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">
<заголовок>
<securityContext>
<siteName>{sitename}</siteName>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUserCard">
<webexId>{userName}</webExId>
</bodyContent>
</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:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</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>Персональная комната теста</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
Поддержка meetingUUID
в запросе и ответе API
Для поддержки meetingKey или sessionKey в запрос и ответ API добавлен параметр meetingUUID
.
Затронутые API:
-
LstRecording
-
LstsummarySession
-
GetSesssionInfo
-
GethosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
CreateMeeting
-
SetMeeting
-
GetMeeting
-
DelMeeting
-
LstCalendarSession
Пример запроса
meetingUUID:
<?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>Test</webExID>
<password>xxx</password>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
или
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Пример ответа
meetingUUID:
<?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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕТ_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:
-
SetUser
-
DelUser
Усовершенствования LstSummary
Session
Усовершенствование API: LstSummarySession
return scheduled-PMR для ввода в запросе одного нового элемента, returnScheduledPMR
. Переключатель функции по умолчанию отключен.
Затронутые API:
-
LstSummarySession
Изменение схемы.
В запрос API LstSummarySession добавлено имя нового элемента returnScheduledPMR
.
В ответ API LstSummarySession добавлено имя нового элемента isScheduledPMR
.
Пример запроса
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>Test</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>И</listMethod>
</listControl>
<dateScope>
<startDateStart>01.11.2019 8:0:0</startDateStart>
<startDateEnd>01.12.2019 7:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>01.11.2019 8:0:0</endDateStart>
<endDateEnd>01.12.2019 7:59:59</endDateEnd>
</dateScope>
<order>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
</serviceTypes>
<returnScheduledPMR>true</returnScheduledPMR>
</bodyContent>
</body>
Пример ответа
LstSummarySession:
<?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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</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>Командное совещание</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Test</ep:hostWebExID>
<ep:hostFirstName>Test</ep:hostFirstName>
<ep:hostLastName>Test</ep:hostLastName>
<ep:otherHostWebExID>Test</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Гавайи (Гонолулу)</ep:timeZone>
<ep:status>НЕТ_INPROGRESS</ep:status>
<ep:startTime>12.10.2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBLIC</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, Гавайи (Гонолулу)</ep:timeZone>
<ep:status>НЕТ_INPROGRESS</ep:status>
<ep:startTime>12.10.2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBLIC</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>
Усовершенствования
GetSite
Добавлен переключатель функции GetSite
ответа SupportXMLAPIReturnScheduledPMR
Затронутые API:
-
GetSite
Изменение схемы.
Новый элемент ответа GetSite
API XML: SupportXMLAPIReturnScheduledPMR
Пример
запроса 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">
<заголовок>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
Пример ответа
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>УСПЕХ</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:siteCommonOptions>
...
<ns1:SupportXMLAPIReturnScheduledPMR>true</ns1:SupportXMLAPIReturnScheduledPMR>
...
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
Обновления API 40.4.8, 40.2.9
Обновления API XML 40.4.8, 40.2.9
Новое ответное сообщение при обновлении запланированных совещаний в API XML
При использовании клиентами API XML для обновления совещаний, запланированных на странице, им будет отправлен числовой пароль в сообщении электронной почты об обновлении совещания. Он будет применен в центрах Webex Meetings, Teams и Events.
Перечисленные далее API GetMeeting, GetTrainingSession, GetEvent
и GetTeleconferenceSession
, будут иметь следующие новые элементы в качестве ответа: audioPassword
(числовой пароль), isEnforceAudioPassword
, isEnforceAudioLogin
для центров Webex Meetings, Teams и Events.
Измененная схема.
Затронутые API:
-
GetMeeting
-
GetTrainingSession
-
GetEvent
-
GetTeleconferenceSession
Пример запроса
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">
<заголовок>
<securityContext>
<siteName>testSite</siteName>
<webExID>test</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</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: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>УСПЕХ</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">
<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
Обновления API XML 40.4.5, 40.2.6
Ограничение использования GetUserCard
и GetSessionInfo
Мы реализуем ограничение использования для API GetUserCard
и GetSessionInfo
, при достижении лимита использования можно получить сообщение об ошибке: "403 запрещено".
Затронутые API:
-
GetUserCard
-
GetSessionInfo
Обновления API 40.4.4, 40.2.5
Обновления API XML 40.4.4, 40.2.5
Ограничение количества BodyContent
В каждом разделе API XML добавлено ограниченное количество элементов BodyContent
. При добавлении слишком большого количества BodyContent
в запрос API будет возвращено следующее сообщение: "000053 Количество BodyContent в запросе должно быть меньше {number}"
Затронутые API:
-
все API XML
Пример запроса API XML с множественным
содержанием:
<?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>xxxx</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</заголовок>
<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
Обновления API XML 40.4.3, 40.2.4
Усовершенствования
CreateUser
Функция CreateUser
усовершенствована: приветственное электронное сообщение поддерживается на нескольких языках. Теперь CreateUser
запрашивает isHTMLEmail
Затронутые API:
-
CreateUser
Пример запроса
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>администратор</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</заголовок>
<body>
<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>
<привилегия>
<host>true</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</привилегия>
<languageID>3</languageID>
<active>ACTIVATED</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</body>
Обновления API 40.4.0
Обновления API XML 40.4.0
Принудительное подтверждение адреса электронной почты при изменении электронных адресов в API XML
После включения администратором веб-сайта в службе администрирования веб-сайта Webex параметра "Для обновления адреса электронной почты пользователю необходимо подтвердить запрос" будут реализованы приведенные ниже сценарии.
-
Если пользователь с учетной записью администратора, не являющийся администратором веб-сайта, совершит вызов API SetUser для изменения адресов электронной почты, до подтверждения нового адреса электронной почты будет сохранен текущий адрес электронной почты.
На новый адрес электронной почты будет отправлено электронное сообщение, подтверждающее изменение учетной записи, с текстом "Подтверждение изменения учетной записи Webex". После перехода по ссылке в электронном сообщении с подтверждением связывание нового адреса электронной почты будет выполнено немедленно.
Если администратор, не являющийся администратором веб-сайта, совершит вызов API SetUser несколько раз без завершения процесса подтверждения адреса электронной почты, будет сохранен текущий адрес электронной почты. Подтвердить необходимо будет самый последний новый адрес электронной почты.
-
Если пользователь с учетной записью администратора веб-сайта совершит вызов API SetUser для изменения адресов электронной почты, процесс подтверждения адреса электронной почты не будет запущен.
Новый адрес электронной почты будет немедленно связан с учетной записью организатора или посетителя.
Затронутые API:
-
SetUser
Время ожидания GetEnrollmentInfo
и сброс подключения
В настоящее время API GetEnrollmentInfo выполняет поиск IP-адресов в системе имен домена, что значительно влияет на производительность.
Запланировано упрощение этого процесса с пустым откликом в поле <domain>
.
Затронутые API:
-
GetEnrollmentInfo
Пример запроса 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">
<заголовок>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</заголовок>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.getEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
Пример ответа 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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</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:attene>
<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:zipcode></att:zipcode>
<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>APPROVED</att:status>
</att:attene>
<att:attene>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>Тест</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:zipcode></att:zipcode>
<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>APPROVED</att:status>
</att:attene>
<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>
Обновления API 40.2.0
Обновления API XML 40.2.0
Удалить анонимный доступ к LstSummarySession
В качестве усовершенствования безопасности мы останавливаем поддержку анонимного доступа к API LstSummarySession
. Если Webex Meetings анонимно получает доступ к API, возвращается следующий код ошибки и сообщение: "000015 Извините, запись не найдена".
Затронутые API:
-
LstSummarySession
Пример запроса
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">
<заголовок>
<securityContext>
<siteName>имя_сайта1</siteName>
</securityContext>
</заголовок>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
Пример ответа
LstSummarySession:
<?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>СБОЙ</serv:result>
<serv:reason>К сожалению, запись не найдена</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Усовершенствования
безопасности CreateMeeting
и SetMeeting
Усовершенствования
безопасности CreateMeeting
Это изменение внесено в API XML 40.2.0, но его описание было изменено после получения обратной связи от клиентов.
В целях повышения безопасности API CreateMeeting
и SetMeeting
обновлен, чтобы пользователи не могли запланировать совещание на время в прошлом. При попытке API выдаст сообщение об ошибке: "Время начала сеанса 060016 должно быть позже текущего времени". Если пользователю необходимо запланировать мгновенное совещание, рекомендуется установить время начала совещания на пять минут позднее текущего времени.
Затронутые API:
-
CreateMeeting
-
SetMeeting
Обновления API 40.1.2
Обновления API XML 40.1.2
Если пароль не указан при планировании совещания, он будет создан автоматически
Усовершенствованы CreateMeeting
, CreateEvent
, CreateTrainingSession
и CreateTeleconferenceSession
. Теперь они содержат пароль в теле ответа API.
Параметр Все совещания, event-совещания и сеансы должны быть защищены паролем включен по умолчанию. В этом случае, если в запросе API не указан пароль, пароль будет автоматически создан серверами API XML.
Если параметр Все совещания, event-совещания и сеансы должны быть защищены паролем отключен и в запросе API отсутствует пароль, пароль не будет создан серверами API XML.
Если запрос API содержит пароль, этот пароль будет включен в ответ независимо от значения параметра Все совещания, event-совещания и сеансы должны быть защищены паролем.
Затронутые API:
-
CreateMeeting
-
CreateEvent
-
CreateTrainingSession
-
CreateTeleconferenceSession
Ответ CreateMeeting
теперь содержит элемент meetingPassword
:
Пример запроса
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">
<заголовок>
<securityContext>
<siteName>siteName1</siteName>
<webExID>userID</webExID>
<password>*****</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</заголовок>
<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>
Пример ответа
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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</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>
Ответ CreateEvent
теперь содержит элемент eventPassword
:
Ответы CreateTrainingSession
и CreateTeleconferenceSession
теперь содержат элемент sessionPassword
:
Обновления API 40.0.1
Обновления XML API 40.1.0
Усовершенствования GetSessionInfo
В API GetSessionInfo
добавлены новые элементы. API теперь также возвращает информацию о мобильных устройствах.
Затронутые API:
-
GetSessionInfo
Обновления запроса
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">
<заголовок>
<securityContext>
<siteName>sqdemo11</siteName>
<webExID>siteadmin</webExID>
<password>P@ss1234</password>
</securityContext>
</заголовок>
<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 или 123456789_go@webex.com или 123456789@go.webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</body>
Усовершенствования LstAccessAnywhereHistory
Добавлен новый API lstAccessAnywhereHistory
для предоставления ответа с информацией о Webex Access Anywhere.
Затронутые API:
-
LstAccessAnywhereHistory
Обновления запросов
LstAccessAnywhereHistory:
Обновления ответа LstAccessAnywhereHistory
:
Пример запроса:
<?xml version="1.0" encoding="UTF-8"?>
<serv:сообщение
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<заголовок>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>test</webExID>
<password>P@ss1234</password>
</securityContext>
</заголовок>
<body>
<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.09.2019 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>29.12.2019 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>OR</serv:listMethod>
</listControl>
<order>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</order>
</bodyContent>
</body>
Пример ответа:
<?xml version="1.0" encoding="UTF-8"?>
<serv:сообщение
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>УСПЕХ</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</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>