- Головна
- /
- Стаття
Огляд оновлень API Cisco Webex Meetings (API 40)
Знайдіть всю важливу інформацію, яка вам потрібна про API зустрічей Cisco Webex, наприклад, зміни схем та інші оголошення.
Додаткову інформацію про XML API 41 див. в Огляд оновлень API Cisco Webex Meetings (API 41)
Для отримання додаткової інформації про XML API 39 і XML API 11 див. огляд оновлень XML API зустрічей Cisco Webex (XML API 39 і раніше).
Щоб отримати оновлення для XML API 11 SP9 і більш ранніх версій, перейдіть до Cisco DevNet.
API 40.12.0 Оновлення
Оновлення XML API 40.12.0
XML API підтримує приватний тип зустрічі
Можна вплинути на XML API
-
Ми можемо використовувати API:
CreateMeeting
іSetMeeting
, щоб запланувати або оновити нараду Webex для типу приватної наради. -
Якщо нараду Webex заплановано за типом приватної наради,
GetSessionInfo
GetMeeting
,LstSummarySession
іLstCalendarSession
повернуть нове ім’я елементаPrivateMeeting
, щоб знати це. -
GetMeetingType
іLstMeetingType
повертають новий елемент з ім’ям
, який вказує, чи підтримує він приватні наради.SupportPrivateMeeting
Зміни схеми
XML API: GetMeetingType/LstMeetingType:Додайте елемент .
XML API: СеансЗведення
: Додайте елемент
.
XML API:Сеанс календаряLstCalendar
: Додайте елемент
.
XML API: Інформація про сеанс
: Додайте елемент
.
XML API: GetMeeting: Додайте елемент
.
Запит XML API: CreateMeeting
Запит на створення зустрічі з приватним типом зустрічі
10/25/2020 13:00:00
45
45
;********
MC_PrivateMeeting_Test
168 //169 – це зразок, який підтримує приватну нараду
Відповідь XML API: ОтриматиВідомостіСеансу
Відповідь для isPrivateMeeting
false
true
true //true: нарада підтримує приватну нараду; хибно: нарада не підтримує приватну нараду.
false
false
true
GetSite API поверне шаблони зустрічей на рівні сайту
Опис історії/завдання користувача
GetSite API для повернення шаблону зустрічі на рівні сайту. Це дасть змогу з 'єднувачу освіти та класним кімнатам Webex показувати ці шаблони, щоб вчителі могли обирати ці шаблони під час планування своїх сеансів в режимі он-лайн.
Задіяні API
Якщо існують індивідуальні шаблони зустрічей на рівні сайту, GetSite api поверне ці шаблони на рівні сайту.
Назва елементів |
Опис |
---|---|
|
назва індивідуальних шаблонів зустрічей на рівні сайту |
|
Засідання Webex, тренінги Webex і події Webex |
Зміни схеми
GetSite : Додайте елемент .
Зразок відповіді
Відповідь GetSite
<ns1:meetingTypes>
<ns1:ідентифікаторТипуНаради>3</ns1:ідентифікаторТипуНаради>
<ns1:meetingTypeName>ПРОФЕСІЙНА</ns1:NameTypeMeeting>
</ns1:Типи нарад>
<ns1:meetingTemplates>
<ns1:ШаблонНаради>
<ns1:meetingTemplateName>Tempus наради MC 1</ns1:meetingTemplateName>
<ns1:serviceType>MeetingCenter</ns1:serviceType>
</ns1:ШаблонНаради>
<ns1:ШаблонНаради>
<ns1:meetingTemplateName>Tempus наради ЄС 2</ns1:meetingTemplateName>
<ns1:serviceType>Центр подій</ns1:serviceType>
</ns1:ШаблонНаради>
<ns1:ШаблонНаради>
<ns1:meetingTemplateName>Шаблон наради TC 3</ns1:meetingTemplateName>
<ns1:serviceType>Навчальний центр</ns1:serviceType>
</ns1:ШаблонНаради>
</ns1:ШаблониНаради>
SetUser XML API не може змінювати елемент підтримуванихСлужб
, якщо вебсайт є сайтом уніфікованим CI
Опис
SetUser
XMLAPI не підтримує зміну значення «supportedServices
» у запиті API, коли вебсайт є сайтами нарад Unified Webex, пов’язаними з Control Hub.
Зміни схеми
У API немає змін схеми: SetUser
.
WEBEX-15436: Додайте захист, щоб уникнути дублювання адрес електронної пошти в учаснику Mtgconfattendee
Опис
Якщо кілька учасників, які мають однакову електронну адресу, додаються до однієї зустрічі в одному запиті API, ми обробляємо електронною поштою лише першого учасника.
Задіяні API
-
СтворитиВідвідувачНаради
-
CreateUser
-
Сет'юзер
-
CreateMeeting
-
Установити нараду
-
Створитивизвернення
-
SetEvent
-
СтворитиНавчальнийСеанс
-
УстановитиНавчальнийСеанс
Зразок 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>тестовийВебсайт</siteName>
<webExID>тестовий користувач</webExID>
<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>
<людина>
<email>test@webex.com</email>
<name>ім’я1</name>
</людина>
<відвідувачі>
<людина>
<email>test@webex.com</email>
<name>ім’я2</name>
</людина>
<sessionKey>1714904382</sessionKey>
</відвідувачі>
</bodyContent>
</body>
API 40.11.0 Оновлення
Оновлення XML API 40.11.0
XMLAPI CreateUser підтримує displayname
CreateUser
підтримує функцію dispalyname
, коли перемикач функції EnableDisplayName
має значення 1. Якщо перемикачем функції не є значення 1, displayName
буде ігноровано.
Зміни схеми
CreateUser:
XMLAPI SetUser підтримує displayname
SetUser
підтримує функцію dispalyname
, коли перемикач функції EnableDisplayName
дорівнює 1. Якщо перемикачем функції не є 1, displayName
буде ігноровано.
Зміни схеми
УстановитиКористувача:
XMLAPI GetUser підтримує displayname
GetUser
підтримує функцію dispalyname
, коли перемикач функції EnableDisplayName
дорівнює 1. Якщо перемикачем функції не є 1, displayName
не буде відображено.
Якщо displayName
в БД має значення null, а перемикач функції УвімкнутиDisplayName
дорівнює 1, displayName
буде firstName+" "+lastName
для неазійських символів і firstName+lastName
для азійських символів.
Зміни схеми
GetUserResponse:
Керування рівнем користувача XMLAPI для гібридного голосового зв 'язку CMR
Параметр cmrHybridVoip
використовується для встановлення та отримання параметра на рівні користувача для EnableCMRHybridVoIP
.
Зміни схеми
Відповідь GetUser:
Запит CreateUser:
Запит на встановлення користувача:
API 40.10.0 Оновлення
XML API 40.10.0 Оновлення
Підтримка XML API для UUID наради
в запиті та відповіді API
Приклад XML API: Запит GetSessionInfo
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>НЕ_Триває</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:
-
СтворитиВідвідувачНаради
-
ВідвідувачНаради
-
ЗареєструватисяВідвідувачНаради
-
СтворитиСеансТелеконференції
-
УстановитиСеансТелеконференції
-
СеансGetTeleconferenceSession
-
СтворитиНавчальнийСеанс
-
УстановитиНавчальнийСеанс
-
GetTrainingSession
-
DelTrainingSession
-
Створитивизвернення
-
SetEvent
-
DelEvent
XMLAPI поверне додатковий елемент для налаштування адміністратора сайту, щоб вимкнути захоплення екрана
Вимога походить від Security - як помилок PenTest
, так і клієнтів, таких як Goldman Sachs. Вони не хочуть дозволяти кінцевим користувачам знімати екран у додатку "Зустрічі". Тим часом багато інших клієнтів хочуть цю функцію - щоб дозволити знімати екран. Також користувачі освіти хочуть дозволити захоплення екрана також. Тому для цього у нас буде конфігурація адміністратора вебсайту, а 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">
<header>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Тест</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</body>
<? xml version="1.0" encoding="ISO- 8859- 1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>УСПІХ</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:siteInstance>
...
<ns1:securityOptions>
...
...
<ns1:УвімкнутиМобільнийScreenCapture>хибно</ns1:УвімкнутиМобільнийScreenCapture>
...
</ns1:securityOptions>
...
</ns1:siteInstance>
</serv:bodyContent>
Уражений API
GetSite
Підтримка XMLAPI MEET-269 Покращення з 'єднання без PIN-коду
XMLAPI додає НОВУ ОПЦІЮ Системи відеоконференцій в моїй організації можуть починати та приєднуватися до зустрічей без підказок для зустрічі в Особистій кімнаті та зустрічі MC.
-
createUser/setUser/getUser
додати новий вузолпристрійМожеРозпочатиМійPMR
вособистійКімнаті
. -
createMeeting/setMeeting/getMeeting
додати новий вузолdeviceCanStartMeeting
у розкладі.
Параметр інтерфейсу користувача Webex для зустрічі в особистій кімнаті:
Зміни схеми
CreateUser:
УстановитиКористувача:
getUserResponse:
Створити нараду:
установитиНарада:
ВідповідьНарадиGet:
API 40.9.0 Оновлення
XML API 40.9.0 Оновлення
Підтримка XML API для запиту та відповіді UUID наради
Ми додали UUID наради до запиту та відповіді API, де б ми не підтримували як ключ meetingKey
або sessionKey
.
Приклад XML API: Запит GetSessionInfo
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>НЕ_Триває</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:
-
Інформація про реєстрацію
-
ПідсумокНавчальнийСеанс
-
ЗапланованийТест
-
ЗапланованийТест
-
DelScheduledTest
-
GetTestInformation
-
ПередатиПодіюЗображення
-
НадіслатиЗапрошенняЕлектронна пошта
-
СтворитиСеансПідтримки
-
ВикористанняПопереднєІсторія
-
Відвідувач наради LstrПопередняІсторія
-
LsteventsessionPreliminaryHistory
-
LsteventвідвідувачPreliminaryHistory
-
LstTrainingОпитуванняРезультатиІсторія
На зустрічах Webex буде заблокований вестибюль зустрічі, де користувачі можуть чекати на допуск до зустрічі
Заплануйте й змініть нараду MC, щоб підтримати заблокований хол, коли ввімкнено функцію (ConsistentLockedLobby
).
Зміни схеми
Додано три нові елементи (externalAttendeeSecurity
, autoLock
, autoLockWaitTime
) до API CreateMeeting, SetMeeting і GetMeeting .
Елемент |
Опис |
---|---|
|
Коли зустріч розблоковано, можна вибрати три елементи зовнішньої безпеки користувача.
|
|
Чи автоматичне блокування зустрічі. Дійсно: Автоматично блокувати зустріч через # хвилин після початку зустрічі Хибно: Не блокує зустріч автоматично після початку зустрічі |
|
Протокол (0,5,10,15,20) для автоматичного блокування наради після початку наради |
Зразок запиту та відповіді
Запит CreateMeeting:
...
...
false
ДозволитиПриєднанняЗаХолом
true
10
...
Запит SetMeeting:
2###1###01
...
...
false
ДозволитиПриєднанняЗаХолом
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>ОСНОВНИЙ</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>ДозволитиПриєднання</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...
</serv:message>
Задіяний API:
-
CreateMeeting
-
Установити нараду
-
GetMeeting
Покращення API GetSessionInfo
для повернення стану учасників у сеансі, що триває
Додано два нові елементи (hasHostInMeeting
, hasAttendeeInMeeting
) у відповідь функції GetSessionInfo
. Ці два елементи будуть повернуті, коли зустріч буде тривати.
Елемент |
Опис |
---|---|
|
Чи приєднався господар до поточної зустрічі. Дійсно: Господар на поточній зустрічі. Хибно/Нуль: Господар не бере участь у нараді, що триває, або нарада не триває. |
|
Чи існує учасник/хост приєднався до наради в процесі виконання. Дійсно: присутній учасник або господар на нараді, що триває. Хибно/Нуль: немає жодного учасника або господаря на нараді, що триває, або нарада не є нарадою, що триває. |
Зразок відповіді API:
<? xml version="1.0" encoding="ISO- 8859- 1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common"
xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns: att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>УСПІХ</serv:result>
<serv:gsbStatus>ОСНОВНИЙ</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>ВИКОНУЄТЬСЯ</ep:status>
<ep:hasHostInMeeting>true</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
...
</serv:message>
Задіяний API:
ОтриматиВідомостіСеансу
API GetUserCard вимагає авторизації.
Для підвищення безпеки GetUserCard
XML API потрібен авторизацію для отримання інформації про користувача.
Задіяний API:
ОтриматиКарткуКористувача
API 40.8.0 Оновлення
Оновлення XML API 40.8.0
Посилення відповіді GetSessionInfo
Якщо вас не запросили або не схвалили на зустрічі, виклик до XML API: GetSessionInfo
не поверне елементи: confName, датаПочатку, тривалість, часовий пояс, посилання на нараду, sipURL, displayMeetingUrl
в тексті відповіді API.
Приклад відповіді API для зустрічей:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕ_Триває</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>ВІДСУТНІ В СПИСКУ</ep:listStatus>
<ep:registration>хибно</ep:реєстрація>
<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 для тренінгів/заходів:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>НЕ_Триває</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>ВІДСУТНІ В СПИСКУ</ep:listStatus>
<ep:registration>дійсно</ep:реєстрація>
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>ЗАПРОСИТИ/ЗАРЕЄСТРУВАТИ/ВІДХИЛИТИ</ep:joinStatus>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>Навчальний центр</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:
-
ОтриматиВідомостіСеансу
Інформація про сеанс, покращення безпеки GetUserCard
Ми зробили посилення безпеки в XML API GetSessionInfo
і GetUserCard
. Ми заблокуємо користувачам доступ до цих двох API протягом наступних двох годин, якщо їхній дзвінок досяг обмеження протягом однієї години без знайдених помилок даних.
Відповідь стану помилки: "403 Заборонено"
Уражені API:-
ОтриматиВідомостіСеансу
-
ОтриматиКарткуКористувача
UUID meeting
у запиті API і підтримці відповіді
Ми додали meetingUUID до запиту та відповіді API, де б ми не підтримували ключ meetingKey/sessionKey
.
Запит GetSessionInfo
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>НЕ_Триває</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
-
Інформація про реєстрацію
-
Зведені даніНарада
-
ЗапланованіТести
-
GetEvent
-
Зведені даніПодія
-
Використання Lstmeetingісторія
-
Навчальний сеансІсторія
-
LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSession
Шаблон освітніх сайтів (тип сеансу EDU) в підтримці XML API
Коли ваші сайти вмикають тип сеансу Інструктора освіти (EDU), XML API може підтримувати запланування зустрічі за допомогою шаблону зустрічі EDU.
Задіяний API:
-
CreateMeeting
-
Установити нараду
-
Створитивизвернення
-
SetEvent
-
СтворитиНавчальнийСеанс
-
УстановитиНавчальнийСеанс
Підтримка CreateMeetingAttendee
і RegisterMeetingAttendee
XML API
CreateMeetingAttendee
та RegisterMeetingAttendee
можуть перевірити необхідну форму реєстрації відвідувача для реєстрації Webex Meetings.
І для цього завдання є новий виняток:
Номер винятку |
Повідомлення про виняток |
---|---|
040014 |
Пропущено обов’язкові поля (форма реєстрації): ... |
Наприклад, якщо ви вибрали "Посада" та "Назва компанії" як необхідні поля для реєстрації учасника Веб-зборів, як показано нижче, то ви повинні вказати значення "Посада" та "Назва компанії" при виклику двох API: CreateMeetingAttendee
і RegisterMeetingAttendee
.
Запит відвідувача
реєстраціїНаради:
Ім’я імені
Ім’я
Прізвище
Інженер //назва завдання
Cisco1234 //назва компанії
...
;****@*****.com
ВІДВІДУВАЧ
true
ВІДВІДУВАЧ
ПРИЙНЯТИ
true
1####4####1
СтворитиЗапитВідвідувача
наради:
Ім’яПрізвищеА
Ім’яА
ПрізвищеА
Інженер //назва завдання
Cisco1234 //назва компанії
...
;*****@*****.com
ВІДВІДУВАЧ
true
ВІДВІДУВАЧ
ПРИЙНЯТИ
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>ПОМИЛКА</serv:result>
Пропущено обов’язкові поля (форма реєстрації): заголовок,компанія
<serv:gsbStatus>ОСНОВНИЙ</serv:gsbStatus>
<serv:exceptionID>
<serv:value>заголовок,компанія</serv:value>
</serv:response>
<serv:body>
<serv:bodyContent/>
</serv:body>
Задіяний API:
-
СтворитиВідвідувачНаради
-
ЗареєструватисяВідвідувачНаради
Покращення перевірки електронної пошти XML API
XML API не повинен дозволяти використання символів з пробілами в електронній пошті, тому ми розширили перевірку електронної пошти, щоб узгодити її з поведінкою сторінки зустрічей Webex.
Задіяний API:
-
СтворитиВідвідувачНаради
-
Створитивизвернення
-
SetEvent
-
Створити контакт
-
Установити контакт
-
УстановитиІнформаціюПроЗапис
-
СтворитиВідвідувачНаради
-
СтворитиНавчальнийСеанс
-
УстановитиНавчальнийСеанс
-
CreateUser
-
Сет'юзер
-
CreateMeeting
-
Установити нараду
-
ЗареєструватисяВідвідувачНаради
API 40.7.0 Оновлення
Оновлення XML API 40.7.0
Підтримка
meetingUUID
Ми додали meetingUUID
до запиту та відповіді API, де б ми не підтримували ключ meetingKey або ключ сеансу.
Приклад запиту
GetSessionInfo:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>НЕ_Триває</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:
-
Відвідувач нарадиІсторія
-
Відвідувач тренінгуІсторія
-
LsteventattendeeHistory
-
Відвідувач підтримкиHistory
Підтримка електронних листів з привітанням CreateUser
API для чотирьох нових мов
Вітальний електронний лист XMLAPI html підтримує наступні чотири нові мови:
-
Чеська мова (ідентифікатор =19)
-
Польська (languageID=20)
-
Угорська мова (ідентифікатор =21)
-
Румунська мова (ідентифікатор =22)
XMLAPI надсилає електронний лист із привітанням відповідно до мови або 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>Тест</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>тест</firstName>
<lastName>користувач</lastName>
<webExId>тестовий користувач</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<права>
<організатор>дійсно</організатор>
</права>
<languageID>19</languageID>
або
<language>Чеська</language>
<active>АКТИВОВАНО</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</bodyContent>
</body>
API 40.6.1, 40.4.9 Оновлення
XML API 40.6.1, 40.4.9 Оновлення
Підтримка CreateMeeting/SetMeeting
Під час планування наради Webex API XML CreateMeeting/SetMeeting
дає змогу встановити або зняти прапорець, а також клацнути обов’язкове чи необов’язкове поле в формі реєстрації відвідувача.
Нижче наведено зразок розкладу зустрічей з веб-сторінки користувача, де ви можете перевірити обов 'язкові поля, такі як "Посада", "Назва компанії", "Місто" та "Штат" в реєстраційній формі учасника:
Нижче наведено відображення між полями сторінки та елементами XML API:
Поля сторінки | Елемент XMLAPI |
---|---|
Ім’я завдання | |
Назва компанії | |
Адреса 1 | |
Адреса 2 | |
Місто | |
Штат | |
Поштовий індекс | |
Країна/регіон | |
Робочий телефон | |
Факс |
Змінена схема: Додати елемент "registrationForm" до CreateMeeting
Змінена схема: Додати елемент "registrationForm" до SetMeeting
Змінена схема: Додати елемент "registrationForm" до GetMeeting
Приклад запиту CreateMeeting
:
<accessControl>
<meetingPassword>пароль</meetingPassword>
</accessControl>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
дійсно
<auto>хибно</auto>
</attendeeOptions>
<реєстраційнаФорма>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>хибно</req></address1>
<address2><req>хибно</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>false</req></postalCode>
<country><req>хибно</req></country>
<phone><req>хибно</req></phone>
<fax><req>хибно</req></fax>
</реєстраційна форма>
Приклад запиту SetMeeting
:
<meetingkey>1015045339</meetingkey>
<confName>Назва конференції</confName>
<meetingType>3
</metaData>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
дійсно
<auto>true</auto>
</attendeeOptions>
<реєстраційнаФорма>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>хибно</req></address1>
<address2><req>хибно</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>false</req></postalCode>
<country><req>хибно</req></country>
<phone><req>хибно</req></phone>
<fax><req>хибно</req></fax>
</реєстраційна форма>
Приклад відповіді GetMeeting
:
<meet:sipURL>1234567890@sitename.webex.com</meet:sipURL>
<meet:displayMeetingUrl>1234567890@sitename.webex.com</meet:displayMeetingUrl>
<meet:реєстраціяФорма>
<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:компанія>
<meet:address1><meet:req>хибно</meet:req></meet:address1>
<meet:address2><meet:req>хибно</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>хибно</meet:req></meet:postalCode>
<meet:country><meet:req>хибно</meet:req></meet:country>
<meet:fax><meet:req>хибно</meet:req></meet:fax>
</meet:реєстраційна форма>
Уражені API:
-
CreateMeeting
-
Установити нараду
-
GetMeeting
-
DelMeeting
Тип зустрічі E2EE не підтримує зустріч PMR
Коли ви вмикаєте PMR під час дзвінка з API:CreateUser/SetUser/GetUser/GetMe
і доступний лише тип наради E2EE, він відповість на таке повідомлення про помилку: «110063 Для активації PMR користувач повинен мати принаймні один тип наради не E2EE.»
Уражені API:
-
CreateUser
-
Сет'юзер
-
GetUser
-
GetMe
API 40.6.0 Оновлення
Оновлення XML API 40.6.0
Додано роль керування користувачами
Ми створили роль User Management (Керування користувачами), і файл схеми для наступного змінився.
Змінена схема: Запит CreateUser
:
Змінена схема: Сет'юзер
Змінена схема: Відповідь GetMe
:
Змінена схема: Зведені даніВідповідь користувача
:
Уражені API:
-
CreateUser
-
Сет'юзер
-
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>АдміністраторВебсайту</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>
<хост>хибно</хост>
<siteAdmin>false</siteAdmin>
<labAdmin>хибно</labAdmin>
<voiceOverIp>хибно</voiceOverIp>
</права>
<languageID>3</languageID>
<active>АКТИВОВАНО</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</body>
Підтримка за допомогою доступу до ключа API GetUserCard
Тепер ми підтримуємо використання ключа API (згенерованого токена JWT) для доступу до API: GetUserCard
у цьому випуску.
Ви можете звернутися до цих сторінок щодо застосування одного ключа API та створення маркера JWT:
Приклад запиту GetUserCard
:
Публікація 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">
<header>
<securityContext>
<siteName>{sitename}</siteName>
</securityContext>
</header>
<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>ОСНОВНИЙ</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
Ми додали meetingUUID
до запиту та відповіді API, коли підтримуємо ключ meetingKey або ключ сеансу.
Уражені API:
-
LstRecording
-
ЗведенняСеансу
-
ОтриматиВідомостіПроСеанс
-
GethosturlНарада
-
GetjoinurlНарада
-
ВідвідувачНарадиLst
-
CreateMeeting
-
Установити нараду
-
GetMeeting
-
DelMeeting
-
СеансКалендаряLst
Приклад запиту нарадиUUID
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<password>xxx</password>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>НЕ_Триває</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
Ключі зустрічі PMR не будуть змінені від тимчасово деактивованого користувача або вимкненого PMR
Коли тимчасово деактивований користувач або вимкнений PMR повторно активується протягом одного тижня, тепер повторно активований користувач або увімкнений ключ зустрічі PMR не змінюється, він буде таким самим, як і раніше.
Задіяні API:
-
Сет'юзер
-
DelUser
Покращення LstSummarySession
Ми покращили API: LstSummarySession
поверніть запланований PMR, щоб у запиті був один новий елемент, returnScheduledPMR
. І функція перемикача за замовчуванням вимкнена.
Задіяні API:
-
ЗведенняСеансуLst
Зміна схеми:
Ми додаємо нове ім’я елемента returnScheduledPMR
до запиту API LstSummarySession.
Ми додаємо нове ім’я елемента isScheduledPMR
у відповідь API LstSummarySession.
Приклад запиту 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>Тест</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>WEBEXID хоста</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>ЧАС ПОЧАТКУ</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>Центр продажів</serviceType>
<serviceType>НавчальнийЦентр</serviceType>
<serviceType>ЦентрПідтримки</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>ОСНОВНИЙ</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:сеанс>
<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>Тест</ep:hostWebExID>
<ep:hostFirstName>Перевірити</ep:hostFirstName>
<ep:hostLastName>Тест</ep:hostLastName>
<ep:otherHostWebExID>Тестування</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT–10:00, Гаваї (Гонолулу)</ep:timeZone>
<ep:status>НЕ_Триває</ep:status>
<ep:startTime>12.10.2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>ЗАГАЛЬНОДОСТУПНИЙ</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>хибно</ep:participantsJoined>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>хибно</ep:реєстрація>
<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:сеанс>
<ep:сеанс>
<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>НЕ_Триває</ep:status>
<ep:startTime>12.10.2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>ЗАГАЛЬНОДОСТУПНИЙ</ep:listStatus>
<ep:hostEmail>Molly08Console81696000@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>хибно</ep:participantsJoined>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>хибно</ep:реєстрація>
<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:сеанс>
</serv:bodyContent>
Покращення GetSite
Додано перемикач функції відповіді GetSite
для функції SupportXMLAPIReturnScheduledPMR
Задіяні API:
-
GetSite
Зміна схеми:
Новий елемент відповіді GetSite
XML API: ПідтримкаXMLAPIReturnЗапланованийPMR
Приклад запиту GetSite
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>Тест</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</header>
<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>ОСНОВНИЙ</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>дійсно</ns1:SupportXMLAPIReturnScheduledPMR>
...
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
API 40.4.8, 40.2.9 Оновлення
XML API 40.4.8, 40.2.9 Оновлення
Нова відповідь під час оновлення запланованих зустрічей у XMLAPI
Коли клієнти використовують XMLAPI для оновлення зустрічей, запланованих на їхній сторінці, ми надсилатимемо числовий пароль в оновленні електронної пошти зустрічі та застосовуватимемо його до центрів зустрічей, команд і подій Webex.
Ці API: GetMeeting, GetTrainingSession, GetEvent
і GetTeleconferenceSession
отримають ці нові елементи як відповідь: AudioPassword
(числовий пароль), isEnforceAudioPassword
, isEnforceAudioLogin
для центрів Webex Meetings, Teams і Events.
Змінена схема:
Задіяні API:
-
GetMeeting
-
GetTrainingSession
-
GetEvent
-
СеансGetTeleconferenceSession
Приклад запиту GetMeeting
Request:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>testSite</siteName>
<webExID>test</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</body>
Приклад відповіді:
<? 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>ОСНОВНИЙ</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 Оновлення
XML API 40.4.5, 40.2.6 Оновлення
Обмеження використання GetUserCard
і GetSessionInfo
Ми впроваджуємо обмеження використання для API GetUserCard
та GetSessionInfo
. Якщо ви досягнете обмеження використання, ви можете отримати повідомлення про помилку: "403 заборонено".
Уражені API:
-
ОтриматиКарткуКористувача
-
ОтриматиВідомостіСеансу
API 40.4.4, 40.2.5 Оновлення
XML API 40.4.4, 40.2.5 Оновлення
Обмеження кількості номерів контенту
Ми додали обмежену кількість BodyContent
у кожен розділ XML API. Якщо додати забагато BodyContent
до запиту API, буде повернуто такий код помилки й повідомлення: "000053 Кількість BodyContent у запиті має бути меншою за {number}"
Задіяні API:
-
Будь-який XML API
Запит XML API із кількома прикладами BodyContent
:
<? 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 Оновлення
XML API 40.4.3, 40.2.4 Оновлення
Натисніть тут, щоб завантажити схему XML API 40.4.3, 40.2.4.
Покращення CreateUser
Ми покращили CreateUser
, щоб підтримувати вітальний електронний лист кількома мовами. Запити CreateUser
тепер єHTMLEmail
Уражені 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>
<права>
<організатор>дійсно</організатор>
<siteAdmin>false</siteAdmin>
<labAdmin>хибно</labAdmin>
<voiceOverIp>хибно</voiceOverIp>
</права>
<languageID>3</languageID>
<active>АКТИВОВАНО</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</body>
API 40.4.0 Оновлення
Оновлення XML API 40.4.0
Забезпечити перевірку електронної пошти під час зміни електронної пошти в XML API
Після того, як адміністратор сайту увімкнув Підтвердження, необхідне користувачеві для оновлення адреси електронної пошти в адміністрації сайту Webex:
-
Якщо обліковий запис адміністратора за межами вебсайту викликає API
SetUser
для зміни адреси електронної пошти, поточна адреса електронної пошти залишатиметься, доки нова адреса електронної пошти не буде перевірена. Електронний лист із підтвердженням зміни облікового запису надсилається на нову електронну адресу з "Підтвердженням зміни облікового запису Webex". Після натискання посилання в електронному листі для підтвердження, нова адреса електронної пошти буде негайно пов 'язана.Якщо адміністратор поза вебсайтом кілька разів викликає API
SetUser
без завершення процесу перевірки адреси електронної пошти, поточну адресу електронної пошти буде збережено, а останню нову адресу електронної пошти потрібно перевірити. -
Якщо обліковий запис адміністратора вебсайту викликає API
SetUser
для зміни адреси електронної пошти, процес перевірки електронної пошти не запускається. Нова електронна адреса буде негайно пов 'язана з обліковим записом господаря або учасника.
Задіяні API:
-
Сет'юзер
Тайм-аут GetEnrollmentInfo
і скидання підключення
API GetEnrollmentInfo
наразі шукає IP-адреси в системі доменних імен, що спричиняє величезний вплив на продуктивність. Ми плануємо спростити цей процес і надати пусту відповідь у полі .
Уражені API:
-
Інформація про реєстрацію
Приклад запиту GetEnrollmentInfo
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
Приклад відповіді 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>ОСНОВНИЙ</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:відвідувач>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>Алекс</att:firstName>
<att:lastName>Ян</att:lastName>
<att:email>omega.alex.yang@gmail.com</att:email>
<att:компанія></att:компанія>
<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>ЗАТВЕРДЖЕНО</att:status>
</att:відвідувач>
<att:відвідувач>
<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:компанія></att:компанія>
<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>ЗАТВЕРДЖЕНО</att:status>
</att:відвідувач>
<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 Оновлення
Оновлення XML API 40.2.0
Видалити анонімний доступ до LstSummarySession
Задля посилення безпеки ми зупиняємо підтримку анонімного доступу до API LstSummarySession
. Якщо Webex Meetings анонімно отримує доступ до API, буде повернуто такий код помилки та повідомлення: "000015 На жаль, запис не знайдено."
Уражені API:
-
ЗведенняСеансуLst
Приклад запиту LstSummarySession
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>ім’я вебсайту1</siteName>
</securityContext>
</header>
<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>ОСНОВНИЙ</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Покращення безпеки CreateMeeting
і SetMeeting
Ця зміна була внесена в XML API 40.2.0, але її опис був відредагований після отримання відгуків клієнтів.
Для підвищення безпеки ми оновили API CreateMeeting
і SetMeeting
, щоб не дозволити користувачам планувати минулий час початку наради. Якщо вони намагаються, API отримає повідомлення про помилку: "Час початку сеансу 060016 має бути пізніше за поточний час." Якщо користувачеві потрібно запланувати миттєву зустріч, ми рекомендуємо встановити час початку зустрічі на п 'ять хвилин пізніше поточного часу.
Задіяні API:
-
CreateMeeting
-
Установити нараду
API 40.1.2 Оновлення
XML API 40.1.2 Оновлення
Запланування зустрічі автоматично генерує пароль, якщо він не надається
Ми покращили CreateMeeting
, CreateEvent
, CreateTrainingSession
та CreateTeleconferenceSession
, щоб включити пароль до тіла відповіді API.
За замовчуванням, параметр Всі зустрічі/події/сеанс повинен мати ввімкнений пароль. У цьому сценарії, якщо запит API не містить пароля, пароль автоматично генерується з серверів XML API.
Якщо параметр Всі зустрічі/події/сеанс повинен мати пароль вимкнено, а запит API не містить пароля, пароль не генерується з серверів XML API.
Якщо запит API включає пароль, то відповідь включатиме цей пароль, незалежно від того, чи повинні всі зустрічі/події/сеанс мати налаштування пароля, увімкнене або вимкнене.
Задіяні API:
-
CreateMeeting
-
Створитивизвернення
-
СтворитиНавчальнийСеанс
-
СтворитиСеансТелеконференції
Відповідь 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>назваСайту1</siteName>
<webExID>ідентифікатор користувача</webExID>
<password>*****</password>
<partnerID>партнер webexpartner</partnerID>
</securityContext>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<confName>Тest_аuto_гenerated_mtg_pwd</confName>
<meetingType>3
</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>ОСНОВНИЙ</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>cfc7f3246d4862f1bb69 b803e8615b7a</meet:guestToken>
</serv:bodyContent>
Відповідь CreateEvent
тепер має елемент eventPassword
:
Відповіді CreateTrainingSession
і CreateTeleconferenceSession
тепер мають елемент sessionPassword
:
API 40.1.0 Оновлення
Оновлення XML API 40.1.0
Покращення GetSessionInfo
Додано нові елементи до API GetSessionInfo
. Тепер API також повертає інформацію для мобільних пристроїв.
Задіяні API:
-
ОтриматиВідомостіСеансу
Оновлення запиту 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>адміністратор вебсайту</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:
-
LstAccessAnywhereІсторія
Оновлення запиту на оновлення історіїLstAccessAnywhere
:
Оновлення відповіді 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>тест</webExID>
<password>P@ss1234</password>
</securityContext>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>тест1</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>АБО</serv:listMethod>
</listControl>
<order>
<orderBy>ЧАС ПОЧАТКУ</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>ОСНОВНИЙ</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>декан</history:userName>
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>
</serv:bodyContent>