Дополнительную информацию об 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 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 возвратит эти шаблоны.

Названия элементов

Описание

meetingTemplateName

названия настраиваемых шаблонов совещаний на уровне веб-сайта

serviceType

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 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 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 node deviceCanStartMeeting in schedule.

Параметр в пользовательском интерфейсе Webex для совещания в персональной комнате.

Изменения схемы

CreateUser:

SetUser:

getUserResponse:

CreateMeeting:

setMeeting:

getMeetingResponse:

Обновления API 40.9.0

Обновления API XML 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).

Элемент

Описание

externalAttendeeSecurity

Если совещание разблокировано, на выбор доступны три элемента безопасности присоединения внешних пользователей.

AllowJoin: пользователи могут сразу присоединяться к совещанию.

AllowJoinWithLobby: пользователи могут присоединяться к совещанию, только если их допустит организатор.

BlockFromJoin: пользователи не могут присоединяться к совещанию.

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). Эти два элемента будут возвращены, если совещание уже началось.

Элемент

Описание

hasHostInMeeting

Присоединился ли организатор к совещанию, которое уже началось.

Верно: организатор присоединился к совещанию, которое уже началось.

False/Null: организатор не присоединился к совещанию, которое уже началось, или совещание не начато.

hasAttendeeInMeeting

Присоединился ли какой-либо посетитель или организатор к совещанию, которое уже началось.

Верно: какой-либо посетитель или организатор присоединился к совещанию, которое уже началось.

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

Чтобы скачать схему 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

Чтобы скачать схему 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

Чтобы скачать схему API XML 40.6.1, щелкните здесь

Чтобы скачать схему API XML 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

Чтобы скачать схему API XML 40.6.0, щелкните здесь

Роль "Управление пользователями" добавлена

Вы создали роль "Управление пользователями". Файл схемы для приведенных ниже параметров изменен.

Измененная схема. Запрос CreateUser:

Измененная схема. SetUser

Измененная схема. GetMeresponse:

Измененная схема. Ответ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 см. на страницах ниже.

Применение одного ключа 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

Изменение схемы.

Новый элемент ответа GetSiteAPI 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 40.4.8, щелкните здесь

Чтобы скачать схему API XML 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

Чтобы скачать схему 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

Чтобы скачать схему 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

Это изменение внесено в API XML 40.2.0, но его описание было изменено после получения обратной связи от клиентов.

В целях повышения безопасности API CreateMeeting и SetMeeting обновлен, чтобы пользователи не могли запланировать совещание на время в прошлом. При попытке API выдаст сообщение об ошибке: "Время начала сеанса 060016 должно быть позже текущего времени". Если пользователю необходимо запланировать мгновенное совещание, рекомендуется установить время начала совещания на пять минут позднее текущего времени.

Затронутые API:

  • CreateMeeting

  • SetMeeting

Обновления API 40.1.2

Обновления API XML 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

Чтобы скачать схему XML API 40.1, щелкните здесь.

Усовершенствования 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>