- Главная
- /
- Статья
Найдите всю важную информацию об API Cisco Webex Meetings (например, изменения схемы и другие объявления).
Дополнительную информацию об XML API 39 и XML API 11 см. в статье Обзор обновлений XML API Cisco Webex Meetings (XML API 39 и более ранние версии).
Дополнительную информацию об API XML 40 см. в статье Обзор обновлений API XML Cisco Webex Meetings (API XML 40 и последующие версии).
Информацию об обновлениях XML API 11 SP9 и более ранних выпусков см. в разделе Cisco DevNet.
Обновления API 41.12.0
Обновления API XML 41.12.0
XMLAPI будет блокировать расписание и изменения в Webex Events (классическая версия) в соответствии с элементом настроек EnableClassicEvent
неверно
Затронутые API и изменения схемы
Если на странице конфигурации службы администрирования веб-сайта флажок параметра Включить классическую версию event-совещаний не установлен, этот сайт не будет поддерживать совещания Webex Events (классическая версия).
Если флажок параметра Включить классическую версию event-совещаний не установлен, вы можете воспользоваться этими API для работы с Webex Events (классическая версия).
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
API будет отвечать на новые исключения 010106 Классическая версия event-совещаний была отключена.
Изменения схемы
В схеме нет изменений.
Пример запроса и ответа API
CreateEvent Запрос и ответ API
Запрос CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>Тестирование EC XMLAPI</sessionName>
</metaData>
<schedule>
<startDate>17.07.2021 01:29.15</startDate>
<openTime>15 лет</openTime>
</schedule>
</bodyContent>
Ответ CreateEvent
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>СБОЙ</serv:result>
<serv:reason>Классическое событие отключено.</serv:reason>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 Влияние на API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
будет отвечать на новый элемент subProductCodePrefix
Затронутые API
Текущий API LstMeetingType
элемент ответа productionCodePrefix
: PRO, AUO и других, которые являются предопределенными Webex префиксом meet type.
После этого нового усовершенствования API будет отвечать на новый элемент subProdctCodePrefix
:PRO1, PRO2 и т. д., которые могут быть настроены в виде префикса meet type.
Изменения схемы в API: LstMeetingType
Будет отвечать с новым элементом: subProdctCodePrefix
Пример запроса и ответа API
LstMeetingType
Запрос и ответ API
Запрос LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
Ответ LstMeetingType
<serv:body>
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:meetingType>
<mtgtype:productCodePrefix>ПРОФЕССИОНАЛЬНЫЙ</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Новый элемент для настраиваемого типа совещания
<mtgtype:active>АКТИВИРОВАНО</mtgtype:active>
<mtgtype:name>Cus_Chat_Закрыто</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Закрыто</mtgtype:displayName>
Обновления API 41.11.0
Обновления API XML 41.11.0
Поддержка прямой совместимости API XML в API управления пользователями для веб-сайтов под управлением Control Hub
Затронутые API и изменения схемы
Если в настоящее время приложение интеграции использует API управления пользователями Webex XMLAPI: CreateUser
, SetUser
, DelUser
и GetUser
Для инициализации или управления пользователями после преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub эти API продолжат работать для обеспечения прямой совместимости. Ниже приведены некоторые изменения в поведении.
При использовании createUser – если состояние пользователя в Control Hub не "активный", пользователь на веб-сайте также не будет активным. Если состояние пользователя в Control Hub активный, пользователь на веб-сайте также будет активным. Источник: Состояние новых и преобразованных пользователей в Control Hub.
Элемент пароля API CreateUser и SetUser будет проигнорирован. Мы начнем рассылку электронных сообщений со ссылкой на активацию для новых пользователей. Пользователи могут перейти по ссылке в электронном письме, чтобы активировать новую учетную запись и ввести новый пароль.
Активный элемент API CreateUser будет проигнорирован. Новый пользователь (не был подтвержден) не сможет быть активирован с помощью этого параметра, используя API SetUser .
Значение элемента webExId в bodyContent API CreateUser должно быть таким же, как и адрес электронной почты. Если webExId отличается от адреса электронной почты , при хранении в WebDB webExId будет обрабатываться как адрес электронной почты, и это значение будет проигнорировано.
Значение элемента webExId в bodyContent API SetUser должно являться удостоверением пользователя для адреса электронной почты. Вы можете изменить это, используя < адрес электронной почты > в bodyContent.
API SetUser поддерживает изменение адреса электронной почты существующего пользователя в следующем случае: если учетная запись операции в SecurityContext является администратором веб-сайта с полными правами в Control Hub. В противном случае API выдаст сообщение об ошибке вместе с новым кодом ошибки:
030120 Для изменения адреса электронной почты учетная запись должна быть администратором веб-сайта с полными правами.
Элемент newWebExId в bodyContent API SetUser будет проигнорирован.
API SetUser пытается изменить адрес электронной почты на тот, который уже используется. API выдаст сообщение об ошибке вместе с новым кодом ошибки:
030118 Этот адрес электронной почты уже используется на веб-сайтах под управлением Control Hub.
API DelUser деактивирует учетную запись пользователя на стороне совещания Webex и удаляет его лицензию на совещания на веб-сайте Webex. Деактивированный пользователь может быть повторно активирован с помощью API. SetUser (<active>АКТИВИРОВАН</active>) до тех пор, пока пользователь не пройдет верификацию.
API CreateUser и SetUser выдают сообщение об ошибке вместе с новым кодом ошибки, как показано ниже:
030117, Этот пользователь не существует в вашей организации. Необходимо утвердить пользователя через процесс утверждения пользователя в вашей компании. Чтобы получить информацию о том, какие действия необходимо предпринять для утверждения пользователя в организации, см. Утверждение пользователей в вашей организации (преобразование пользователей). Прежде чем утверждать пользователя, необходимо проверить домен, к которому принадлежит пользователь.
030119 Маркер доступа CI должен включать область действия webexsquare: администратора при подготовке пользователя к работе.
Прямая совместимость поддерживается только в течение ограниченного периода времени. Перед удалением этой совместимости будет отправлено предварительное уведомление. |
Изменения схемы
В схеме этих API нет изменений: CreateUser
, SetUser
, DelUser
и GetUser
.
Пример запроса и ответа API
CreateUser Запрос и ответ API
Запрос API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{учетная запись администратора веб-сайта}</webExID>
<email>{учетная запись администратора веб-сайта}</email>
<sessionTicket>xxxx</sessionTicket> или <password> или <webExAccessToken>
или <accessToken>, при использовании CI "accessToken" он должен включать область webexsquare:admin при подготовке пользователя
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- это должен быть идентификатор пользователя адреса электронной почты
<email>Jack@qa.webex.com</email>
<firstName>Джек</firstName>
<lastName>Смит</lastName>
<password>...</password>
<privilege>
<host>истина</host>
</privilege>
<active>АКТИВИРОВАНО</active> -- этот параметр не может активировать пользователя напрямую до тех пор, пока пользователь сам не активирует себя по электронной почте для активации.
</bodyContent>
</body>
Пример ответа API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:createUserResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:userId>23778617</use:userId>
</serv:bodyContent>
</serv:body>
</serv:message>
Повлиять на API.
CreateUser
SetUser
DelUser
API XML поддерживает прямую совместимость аутентификации существующих пользователей классической версии веб-сайта Webex и конвертированного веб-сайта под управлением Control Hub
Затронутые API
После преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub значение <webExID> элемента в <securityContext> должно совпадать с адресом электронной почты. Подробные сведения приведены ниже.
Для существующих пользователей, созданных в классической версии веб-сайта Webex, поддерживаются оба старых webExID (например, Jack) и новый webExID (контент совпадает с адресом электронной почты. Пример: Jack@xx.com) для входа. Обратная совместимость аутентификации существует для всех API XML.
Для новых пользователей, созданных на веб-сайтах под управлением Control Hub, значение элемента webExID должно совпадать с адресом электронной почты для входа в систему.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> -- существующие пользователи были созданы на классическом веб-сайте webEx. Это могут быть: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
<sessionTicket>xxxx</sessionTicket> или <password> или <webExAccessToken> или <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
Повлиять на API.
Все API XML
После преобразования классического веб-сайта Webex в веб-сайт под управлением Control Hub значение <webExID> элемента <bodyContent> должно совпадать с адресом электронной почты. Подробные сведения приведены ниже.
Для существующих пользователей, созданных в классической версии веб-сайта Webex, поддерживаются оба старых webExID (например, Jack) и новый webExID (контент совпадает с адресом электронной почты. Пример: Jack@xx.com) в bodyContent.
Для новых пользователей, созданных на веб-сайтах под управлением Control Hub, значение элемента webExID должно совпадать с адресом электронной почты
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- существующие пользователи были созданы на классическом веб-сайте webEx, это может быть: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
</bodyContent>
Повлиять на API.GetUser
, SetUser
и DelUser
.
Изменения схемы
В схеме всех API нет изменений:
Пример запроса и ответа API
GetUser Запрос и ответ API
Запрос API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- существующие пользователи были созданы на классическом веб-сайте webEx, это может быть: jack или jack@xx.com; новый пользователь должен использовать jack@xx.com
<sessionTicket>xxxx</sessionTicket> или <password> или <webExAccessToken> или <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- существующие пользователи были созданы на классическом веб-сайте webEx, это может быть: jack или jack@xx.com; новый пользователь должен использовать пример ответа jack@xx.com
</bodyContent>
</body>
API:
...то же, что и прежде
Усовершенствование API отчета о просмотре истории записей поддерживается в Webex Meetings, Webex Events (новая версия) и Webex Events (классическая версия)
Затронутые API
Текущий API: lstrecordaccessHistory
и lstrecordaccessDetailHistory
поддерживает отчеты о просмотре истории записей, доступные только в Webex Trainings. Новые усовершенствования добавляют поддержку отчетов о просмотре истории записей в Webex Meetings, Webex Events (новая версия) и Webex Events (классическая версия).
Изменения схемы
Ниже приведена новая схема в API lstrecordaccessHistory в теле запроса API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Сведения
API: lstrecordaccessHistory
может вернуть историю просмотров записей для Webex Meetings, Webex Events (новая версия) и Webex Events (классическая версия).
Если в запросе API не указан serviceType , то API
lstrecordaccessHistory
возвращает только историю просмотров записей в Webex Trainings.Если serviceType – MeetingCenter, API
lstrecordaccessHistory
возвращает историю просмотров записей в Webex Meetings и Webex Events (новая версия).Если serviceType – EventCenter, API
lstrecordaccessHistory
возвращает историю просмотров записей в Webex Events (классическая версия).
API: lstrecordaccessDetailHistory
может вернуть сведения от recordID
из Webex Meetings, Webex Events (новая версия), Webex Events (классическая версия) и Webex Trainings.
Пример запроса и ответа API
lstrecordaccessHistory
Запрос и ответ API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>20.09.2021 00:00:00</viewTimeStart>
<viewTimeEnd>28.09.2021 23:59.59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy><UNK> DID</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</bodyContent>
</body>
</serv:message>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test TC-20210924 1324-1</history:recordName>
<history:creationTime>24.09.2021 13:28.13</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>2. 2</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>TestErollment_001-20210610 1905-1</history:recordName>
<history:creationTime>10.06.2021 г. 19:10.15</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>3</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Тестирование мгновенного воспроизведения 2-20210705 0709-1</history:recordName>
<history:creationTime>05.07.2021 07:15.06</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>EC2.0_232423-20210922 0447-1</history:recordName>
<history:creationTime>22.09.2021 04:53.05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>24.09.2021 13:19.00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test MC-20210924 1319-1</history:recordName>
<history:creationTime>24.09.2021 13:25.12</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC classic-20210924 1331-1</history:recordName>
<history:creationTime>24.09.2021 13:37.28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
lstrecordaccessDetailHistory
Запрос и ответ API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="">
"java:com.webex.service.binding.history.lstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20 лет</timeZoneID>
</body>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessDetailHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24.09.2021 13:27.26</history:accessTime>
<history:registered>ложный</history:registered>
<history:downloaded>ложный</history:downloaded>
<history:viewed>истина</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordDetail>
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24.09.2021 13:27.39</history:accessTime>
<history:registered>ложный</history:registered>
<history:downloaded>истина</history:downloaded>
<history:viewed>ложный</history:viewed>
<history:timeZoneID>20 лет</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2. 2</serv:total>
<serv:returned>2. 2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
Повлиять на API.
lstrecordaccessHistory
lstrecordaccessDetailHistory
Исправьте несоответствие максимальной допустимой длины описания Webex Events (Classic) между XMLAPI и страницей Webex.
Затронутые API
XML API: CreateEvent и SetEvent – элемент описания допускает ввод не более 10 000 символов. При превышении количества символов появится сообщение с новым кодом ошибки:
060068 Введено недопустимое описание. Длина описания превышает 10 000 символов.
Изменения схемы
Без изменения схемы.
Пример запроса и ответа API
CreateEvent Запрос и ответ API
Пример запроса #API:
...
<body>
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
xmlns:att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service/eventhttp://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>ЧАСТНЫЙ</listing>
</accessControl>
<metaData>
<sessionName>тест EC</sessionName>
<description>.......Предположим, вы заполняете 10000 символов в описании........</description>
</metaData>
...
------------------------------------
#Пример ответа API, если описание превышает 10000 символов:
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>FAILURE Illegal input description.</serv:result>
<serv:reason> Длина описания не может превышать 10000 символов</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
Повлиять на API.
CreateEvent
SetEvent
XML API: GetUser возвращает новый элемент freeAccount
Затронутые API
GetUser
возвращает новый элемент, который определяет freeAccount
является ли это учетной записью пользователя FreeAccount
или нет.
Изменения схемы
Пример ответа GetUser
Ответ GetUser:
<use:initials>AW</use:initials>
<use:isUploaded>false</use:isUploaded>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>false</use:freeAccount>
Повлиять на API.
GetUser
Обновления API 41.10.0
В схеме API XML 41.10.0 нет изменений. |
Обновления API 41.9.0
Обновления API XML 41.9.0
Вывод из эксплуатации API XML 10.0.0 для всех веб-сайтов T31
Webex планирует завершить поддержку API XML версии 10.0.0 для всех веб-сайтов T31.
В обновлении 41.9.0 из всех продуктов будет исключен код API XML версии 10.0.0.
Обновления API 41.8.0
Обновления API XML 41.8.0
Вывод из эксплуатации API XML 10.0.0 для всех веб-сайтов T31
Webex планирует завершить поддержку API XML версии 10.0.0 для всех веб-сайтов T31.
Webex обнаружил, что некоторые клиенты обращаются к URL-адресу API XML некорректным способом: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService. Правильный способ доступа к URL-адресу API XML: https://{siteName}.webex.com/WBXService/XMLService.
Испрвальте путь доступа для кода API XML, чтобы избежать негативных последствий до того, как поддержка API XML версии 10.0.0 будет завершена.
Обновления API 41.7.0
Обновления API XML 41.7.0
Удаление и редактирование записей с помощью мобильных устройств должно управляться параметром администрирования веб-сайта: Разрешить организаторам переназначать, редактировать, отключать и удалять записи
Затронутые API и изменения схемы
GetSite
: будет возвращать новые элементы с именами enableNBRMCModify
и separateNoRecordingEdit
в разделе "Инструменты".
Пример ответа
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:tools>
...
<ns1:enableNBRMCModify>ложная</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>истина</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Обновления API 41.6.3
Обновления API XML 41.6.3
GetSite
Ответ с новым элементом supportLargeEvent
Затронутые API и изменения схемы
GetSite: возвращает новый элемент с именем supportLargeEvent
в разделе siteCommonOptions
для информирования вызывающего абонента о том, поддерживает ли веб-сайт крупные event-совещания (Webex Events (новая версия)) или нет.
Изменение схемы
Пример ответа
GetSiteResponse
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>УСПЕХ</serv:result>
<serv:gsbStatus>ОСНОВНОЙ</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:siteCommonOptions>
...
<ns1:enablePreMeetingLobby>ложная</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>истина</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Обновления API 41.6.0
Обновления API XML 41.6.0
API XML поддерживает Webex Events 2.0 в процессе предоставления
Затронутые API
GetUser
: возвращает новое имя элемента largeEventCapacity
в котором показана емкость новой версии Event 2.0 (EC 2.0) в рамках этого учетная запись пользователя. Например, если для учетной записи пользователя предусмотрена лицензия CI_EC3K, значение largeEventCapacity
– 3000.
Изменения схемы
Пример ответа
GetUserResponse:
Значение CreateTime LstRecording API XML применяется к началу записи
Затронутые API
LstRecording
: LstRecording
ответ CreateTime
время, когда пользователь фактически нажимает кнопку записи.
Сведения
Ранее API XML использовал метку времени создания записи в базе данных в качестве времени создания в LstRecording
ответ. Теперь это время, когда пользователь фактически начинает запись. Это изменение применяется ко всем записям службы. Изменения схемы отсутствуют.
Обновления API 41.5.0
Обновления API XML 41.5.0
С помощью API XML можно начинать запланированные совещания Webex из сети PSTN в качестве организатора
Затронутые API
CreateUser
: создаетhostPIN
, независимо от того, включена ли PMR, если пользователю назначена роль организатора либо администратора веб-сайта с полными правами, правами только на чтение или правами на управление пользователями.SetUser
: задаетhostPIN
с помощьюphones.hostPIN
, еслиpersonalMeetingRoom.hostPIN
отсутствует в запросе XML (предварительное условие: переключатель функцииAllowStartScheduledMtgFromPhone
включен).GetUser
: возвращаетphones.hostPIN
, независимо от того, включена ли PMR пользователя (предварительное условие: переключатель функцииAllowStartScheduledMtgFromPhone
включен).
Изменения схемы
GetUserResponse
:
SetUser
:
Пример ответа
GetUserResponse
:
SetUser
:
XMLAPI GetSite
– два новых элемента в ответе для мобильного клиента
Затронутые API
GetSite
:GetSite
теперь будет содержать два новых элемента в ответе, что обеспечит поддержку логики отображения или скрытия вкладки записи для мобильного клиента.enableRecordingAccess
: true или false; главные администраторы Webex могут включить или отключить доступ к записи с помощью переключателя (EnableRecordingAccesses
).storageEmptyStatus
: true или false, если оба веб-сайта не поддерживают функцию сетевой записи и выделили нулевое пространство хранилища сетевых записей, то ответ о состоянии будет иметь значение true, а остальные – false.
Изменения схемы
Пример запроса для GetSite
Пример ответа для Getsite
Тема электронного сообщения, которая содержит символы, не относящиеся к коду ASCII, будет зашифрована по стандарту RFC 2047. Если же тема электронного сообщения содержит только символы ASCII, кодирование не требуется.
Затронутые APIЭто не влияет на полезную нагрузку запроса или ответа API, однако меняет поведение кодирования темы электронного сообщения. Если тема сообщения электронной почты содержит символы, не относящиеся к коду ASCII, она будет зашифрована по стандарту RFC 2047. Если же тема сообщения электронной почты содержит только символы ASCII, кодирование не требуется.
Изменения схемы
Изменения схемы отсутствуют.
Обновления API 41.4.0
Обновления API XML 41.4.0
При создании запланированных event-совещаний Webex Events может использоваться по умолчанию на уровне веб-сайта при тоновом сигнале входа и выхода
XMLAPI соответствует существующей новой логике для управления тоновым сигналом входа и выхода. Управление всеми тоновыми сигналами для Webex Events осуществлялось различными настройками в службе администрирования веб-сайта. В GetSite
API XML возвращает дополнительное поле entryExitToneEC
для указания значения. Первоначально, когда администратор сайта устанавливал тональный сигнал по умолчанию, при создании event-совещания этот параметр не использовался с помощью XMLAPI по умолчанию.
Затронутые API
XML API: GetSite возвращает один новый элемент entryExitToneEC
для указания значения.
XML API: Серверная бизнес-логика CreateEvent, SetEvent, GetEvent считывает значение entryExitToneEC
.
Изменения схемы
XML API: Пример ответа GetSite:
<ns1:defaults>
<ns1:emailReminders>истина</ns1:emailReminders>
<ns1:entryExitTone>НАЗВАНИЕ ОБЪЯВЛЕНИЯ</ns1:entryExitTone>
<ns1:entryExitToneEC>НОТОН</ns1:entryExitToneEC>
<ns1:voip>истина</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>НЕТ</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>истина</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>ложный</ns1:updateTSPAccount>
</ns1:defaults>
Повлиять на API.
GetSite
CreateEvent
SetEvent
GetEvent
XMLAPI просто возвращает подробную информацию о крупном event-совещании (Webex Event 2.0)
Если совещанием Webex является крупное event-совещание или веб-трансляция,
GetSessionInfo
возвращает некоторую подробную информацию, в том числе пароль совещания, числовой пароль совещания, пароль и числовой пароль для членов команды-организатора (схема не будет изменена).API XML не поддерживает функцию создания и редактирования крупных event-совещаний или веб-трансляций, поэтому
CreateMeeting
иSetMeeting
возвращают новое исключение – 110064 The event and webcast session type aren’t supported (Тип сеанса event-совещания и веб-трансляции не поддерживаются), если это крупное event-совещание или веб-трансляция.
Затронутые API
Имя API | Описание | Замечание |
---|---|---|
| Если совещанием Webex является крупное event-совещание или веб-трансляция, | Схема не будет изменена. |
| Если пользователь пытается использовать API | Поведение изменено. |
Обновления API 41.3.0
Обновления API XML 41.3.0
Новые изменения в API XML поддерживают функцию Webex Events 2.0.
Затронутые API
Оба API: GetSessionInfo и GetMeeting также возвращают элементы enableEvent
и enableWebniar
.
Название элемента | Описание |
---|---|
enableEvent | Поддержка EC 2.0 на совещании Webex |
enableWebniar | Поддержка вебинара на совещании Webex |
Поддержка XMLAPI возвращает более двух элементов для EC 2.0. Текущий выпуск API XML не поддерживает планирование и устанавку совещания EC2.0. |
Изменения схемы
GetSessionInfo
возвращает элементы enableEvent
и enableWebniar
для EC 2.0.
GetMeeting
возвращает элементы enableEvent
и enableWebniar
для EC 2.0.
Пример ответа:
GetSessionInfo
– ответ:
<ep:accessControl>
<ep:listStatus>ОБЩЕДОСТУПНЫЙ</ep:listStatus>
<ep:registration>ложный</ep:registration>
<ep:passwordReq>истина</ep:passwordReq>
<ep:isEnforceAudioPassword>ложный</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>ложный</ep:isEnforceAudioLogin>
<ep:enableEvent>ложный</ep:enableEvent>
<ep:enableWebniar>ложный</ep:enableWebniar>
<ep:enablePreMeetingLobby>истина</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
– ответ:
<meet:supportPKI>ложный</meet:supportPKI>
<meet:HQvideo>истина</meet:HQvideo>
<meet:HDvideo>истина</meet:HDvideo>
<meet:viewVideoThumbs>истина</meet:viewVideoThumbs>
<meet:enableEvent>ложный</meet:enableEvent>
<meet:enableWebniar>ложный</meet:enableWebniar>
<meet:enablePreMeetingLobby>истина</meet:enablePreMeetingLobby>
Новые изменения в XMLAPI поддерживают функцию холла перед совещанием
Затронутые API
XML API: GetSite
, LstSummarySession
, GetSessionInfo
и GetMeeting
вернут ответ с новым элементом enablePreMeetingLobby
для холла перед совещанием.
Изменения схемы
XML API: GetSite
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: LstSummarySession
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: GetSessionInfo
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
XML API: GetMeeting
возвращает элемент enablePreMeetingLobby
для холла перед совещанием.
Пример ответа:
GetSite
– ответ:
<ns1:siteCommonOptions>
<ns1:SupportCustomDialRestriction>ложный</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>ложный</ns1:SupportTelePresence>
<ns1:SupportTelePresencePlus>ложный</ns1:SupportTelePresencePlus>
<ns1:EnableCloudTelepresence>истина</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>истина</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>истина</ns1:enablePersonalMeetingRoom>
<ns1:SupportAlternateHost>истина</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturnScheduledPMR>ложный</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>истина</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>истина</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
– ответ:
<ep:isException>ложный</ep:isException>
<ep:isNextUpcomingInstance>истина</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>ложный</ep:isScheduledPMR>
<ep:enableEvent>ложный</ep:enableEvent>
<ep:enableWebniar>ложный</ep:enableWebniar>
<ep:enablePreMeetingLobby>истина</ep:enablePreMeetingLobby>
GetSessionInfo
– ответ:
<ep:accessControl>
<ep:listStatus>ОБЩЕДОСТУПНЫЙ</ep:listStatus>
<ep:registration>ложный</ep:registration>
<ep:passwordReq>истина</ep:passwordReq>
<ep:isEnforceAudioPassword>ложный</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>ложный</ep:isEnforceAudioLogin>
<ep:enableEvent>ложный</ep:enableEvent>
<ep:enableWebniar>ложный</ep:enableWebniar>
<ep:enablePreMeetingLobby>истина</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
– ответ:
<meet:supportPKI>ложный</meet:supportPKI>
<meet:HQvideo>истина</meet:HQvideo>
<meet:HDvideo>истина</meet:HDvideo>
<meet:viewVideoThumbs>истина</meet:viewVideoThumbs>
<meet:enableEvent>ложный</meet:enableEvent>
<meet:enableWebniar>ложный</meet:enableWebniar>
<meet:enablePreMeetingLobby>истина</meet:enablePreMeetingLobby>
Обнаружение изменений в поведении информации в ответе API XML GetSite
изменение поведения при раскрытии информации об ответах
Затронутые API
XML API: GetSite
возвращает только ответ указанные ниже элементы для учетной записи администратора, включая роли: SiteAdmin
, RO_SiteAdmin
и UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Поведение изменено
Разрешить только для роли администратора получение ответа с данными о лицензии на запрос GetSite
. Организатор или посетитель не получит эти данные о лицензии в ответе GetSite
ответ.
Ниже приведен пример ответа API GetSite's
для siteadmin
, или администратора с правами только на чтение siteadmin
, или администратора с правами на управление пользователями
Обновления API 41.2.0
Обновления API XML 41.2.0
Если веб-сайт поддерживает телефонию Webex, для API XML требуется поддержка параметра "Передача голоса по IP для CMR гибридного типа"
Затронутые API
GetSite
возвращает новый элементIsWebexTelephony
в ответе.CreateUser
иSetUser
может обновить элементcmrHybridVoip
, если условие имеет значениеIsWebexTelephony
true, как и другие условия.IsTSPUsingTelephonyAPI
больше не является последовательным параметром.
Изменения схемы
XML API: GetSite
возвращает ответ с дополнительным элементом IsWebexTelephony
GetSite
– ответ включает этот новый элемент:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Номер персонального совещания</ns1:serviceName>
<ns1:participantAccessCodeLabel>Код доступа посетителя</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Код доступа организатора</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Идентификатор посетителя</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
поддерживает EC 2.0
Будут также затронуты API XML
LstSummarySession
будет возвращать два новых элемента для поддержки EC 2.0
Название элемента | Описание |
---|---|
enableEvent | Поддержка EC 2.0 на совещании Webex |
enableWebniar | Поддержка вебинара на совещании Webex |
Изменения схемы
XML API: LstSummarySession
: добавляет элементы < enableEvent
> и < enableWebniar
>
Ответ API XML: LstSummarySession
Ответ для EC 2.0
<ep:isNextUpcomingInstance>истина</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>ложный</ep:isScheduledPMR>
<ep:enableEvent>истина</ep:enableEvent>
<ep:enableWebniar>истина</ep:enableWebniar>
API XML поддерживает возврат параметра пользователя веб-сайта Webex-voice-assistant
для интеграции MCT
Затронутые API
GetUser
возвращает новый элемент webexAssistantEnabled
(true или false) в ответе.
Изменения схемы
getUserResponse
:
Пример ответа
Обновления API 41.1.0
В схеме API XML 41.1 нет изменений. |