- Головна
- /
- Стаття
Огляд оновлень API для зустрічей Cisco Webex (API 41)
Знайдіть всю важливу інформацію, яка вам потрібна про API зустрічей Cisco Webex, наприклад, зміни схем та інші оголошення.
Докладнішу інформацію про XML API 39 і XML API 11 див. в статті Огляд оновлень XML API Cisco Webex Meetings (XML API 39 і попередні версії).
Докладнішу інформацію про XML API 40 див. в статті Огляд оновлень XML API Cisco Webex Meetings (XML API 40 і пізніші версії).
Щоб отримати оновлення для XML API 11 SP9 або попередніх версій, перейдіть до Cisco DevNet.
Оновлення API 41.12.0
Оновлення XML API 41.12.0
XMLAPI заблокує розклад і редагування Webex Events (класична версія) відповідно до елемента конфігурації вебсайту EnableClassicEvent
, який є хибним
Вплив змін API та схеми
На сторінці конфігурації адміністрування сайту, якщо прапорець Увімкнути класичну подію помилковий, цей сайт більше не підтримуватиме наради Webex Events (класичні).
Якщо прапорець Увімкнути класичну подію помилковий, ви викликаєте ці API для роботи з вебекс-подіями (класичною) нарадою:
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
API відповість на новий виняток 010106 Класичну Подію вимкнено.
Зміни схеми
Схема не змінюється.
Приклад запиту та відповіді API
Запит і відповідь API CreateEvent
Запит на створення винаходу
XXXXXXXX
Тестування EC XMLAPI
07/17/2021 01:29:15
15
Відповідь 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>
CreateEvent3.1.3 Впливають на API:
-
SetEvent GetEvent
-
ОтриматиВідомостіСеансу
-
Зведені даніПодія
-
LstrecordedEvent
-
ПрограмаSummaryLstprogram
-
ПередатиПодіюЗображення
XMLAPI LstMeetingType
відповість на новий елемент subProductCodePrefix
Уражені API
Поточний елемент відповіді LstMeetingType
API productionCodePrefix
: PRO, AUO та інші, які є попередньо визначеним префіксом типу Webex.
Після цього нового покращення API відповість на новий елемент subProdctCodePrefix
:PRO1, PRO2 тощо, який можна налаштувати префікс типу Meet.
Зміни схеми на API: ТипНарадиLst
На нього відреагує новий елемент: підготовийКодПрефікс
Приклад запиту та відповіді API
Запит і відповідь API LstMeetingType
Запит типу LstMeetingType
13810
Відповідь LstMeetingType
<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:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Новий елемент для настроюваного типу наради
<mtgtype:active>АКТИВОВАНО</mtgtype:active>
<mtgtype:ім’я>Cus_сhat_Закрито</mtgtype:name>
<mtgtype:displayName>Cus_сhat_Закрито</mtgtype:displayName>
Оновлення API 41.11.0
Оновлення XML API 41.11.0
XML API підтримує пряму сумісність в 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 буде проігнорований, ми починаємо відправляти електронний лист активації новим користувачам, користувачі можуть натиснути посилання в електронному листі на активний новий обліковий запис і ввести новий пароль.
-
Активний елемент CreateUser API буде проігноровано. Нового користувача (не буде перевірено) не можна активувати за цим параметром за допомогою API SetUser.
-
Значення елемента webExId в тіліКонтент API CreateUser має бути таким же, як і електронна пошта. Якщо webExId відрізняється від email, під час збереження у WebDB webExId буде оброблено так само, як електронна пошта, і значення буде ігноровано.
-
Значення елемента webExId у bodyContent API SetUser має бути ідентифікатором користувача адреси електронної пошти. Його можна змінити за допомогою <email> у bodyContent.
-
SETUser API підтримуватиме зміну електронної пошти існуючого користувача: це успішно, якщо операційний обліковий запис у SecurityContext є повним адміністратором сайту Control Hub. В іншому випадку API повідомляє про помилку з новим кодом помилки та повідомленням нижче:
-
030120 Для зміни адреси електронної пошти обліковий запис має бути адміністратором вебсайту з повними правами.
-
-
Елемент newWebExId в тіліКонтент API SetUser буде проігнорований.
-
SETUser API намагається перейти на електронну пошту, яка вже використовується, API піднімається під новим кодом помилки та повідомленням про помилку:
-
030118 Адреса електронної пошти вже використовується на вебсайтах під керуванням Control Hub.
-
-
DelUser API деактивує користувача на стороні зустрічі Webex, і відповідна ліцензія на зустріч видаляється з сайту Webex. Цього деактивованого користувача можна повторно активувати за допомогою API: SetUser (АКТИВОВАНО) доки користувача буде підтверджено раніше.
-
Api CreateUser і SetUser з'являється новий код помилки та повідомлення про помилку, як показано нижче:
-
030117, Цей користувач існує за межами вашої організації, тому його необхідно зарезервувати, щоб перемістити до вашої організації за допомогою процесу резервування користувача. Щоб отримати право на приєднання користувача до вашої організації, перегляньте статтю Право на доступ користувачів до вашої організації (Convert Users). Перш ніж заявити про право на нього, потрібно буде підтвердити домен, до якого належить користувач.
-
030119 Токен доступу CI має включати область дії webexsquare: admin під час підготовки користувача.
-
Підтримується лише обмежений період вперед сумісність. Ми надамо додаткове сповіщення, перш ніж цю сумісність буде видалено.
Зміни схеми
Жодних змін у схемі цих 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/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{обліковий запис адміністратора вебсайту}</webExID>
<email>{Обліковий запис адміністратора вебсайту}</email>
<sessionTicket>xxxx</sessionTicket> або або
або , якщо використовується CI "accessToken", він має включати область webexsquare:admin під час підготовки користувача
</securityContext>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><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>
<права>
<організатор>дійсно</організатор>
</права>
<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>
Впливають на API:
-
CreateUser
-
Сет'юзер
-
DelUser
XML API підтримує пряму сумісність автентифікації користувача після перетворення класичного веб-сайту на керований сайт Control Hub
Уражені API
Після перетворення класичного вебсайту Webex на вебсайт під керуванням Control Hub значення елемента у має бути таким самим, як електронна пошта, деталі нижче.
-
Для існуючих користувачів, створених на класичному сайті Webex, ми підтримуємо обидва старих webExID (наприклад: Jack) і новий webExID (вміст, наприклад, такий самий, як і електронна пошта: Jack@xx.com) для входу, ця зворотна сумісність автентифікації призначена для всіх API XML.
-
Для нових користувачів, створених на керованих сайтах Control Hub, значення елемента webExID має збігатися з електронною поштою для входу.
{siteName}
{userName} –-- наявні користувачі були створені на класичному вебсайті webEx, це може бути: jack або jack@xx.com; новий користувач повинен використовувати jack@xx.com
xxxx або , або або
Впливають на API:
Усі API XML.
Після перетворення класичного вебсайту Webex на вебсайт під керуванням Control Hub значення елемента <bodyContent> має збігатися з електронною поштою. Деталі нижче:
-
Для наявних користувачів, створених на класичному вебсайті Webex, ми підтримуємо обидва старі webExId(наприклад: Jack) і новий webExId (вміст такий самий, як і електронна пошта, наприклад: Jack@xx.com) в тіліКонтент.
-
Для нових користувачів, створених на керованих вебсайтах Control Hub, значення елемента webExId має збігатися з значенням електронної пошти в
bodyContent
.
xxxx --- наявні користувачі були створені на класичному вебсайті webEx, це може бути: jack або jack@xx.com; новий користувач повинен використовувати jack@xx.com
Впливають на 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/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID>. Наявні користувачі були створені на класичному вебсайті webEx, це може бути: jack або jack@xx.com; новий користувач повинен використовувати jack@xx.com
xxxx або , або
xxxx. Це може бути: jack або jack@xx.com; новий користувач повинен використовувати jack@xx.com
приклад відповіді API:
...той самий, що і раніше
Покращення api звіту про історію записів переглядів для підтримки вебекс-зустрічей, подій Webex (новий) та вебекс-подій (класичний)
Уражені API
Поточний API: lstrecordaccessHistory
і lstrecordaccessDetailHistory
підтримують лише перегляд звіту про історію доступу до запису Webex Trainings. Нове вдосконалення також підтримує вебекс-зустрічі, вебекс-події (нове) та запис вебекс-подій (класичний) перегляду доступного звіту про історію.
Зміни схеми
Нижче ми підтримуємо нову схему в API lstrecordaccessHistory in API request body:
MeetingCenter
TrainingCenter
EventCenter
Відомості
The API: lstrecordaccessHistory
може повертати перегляд історії записів для Webex Meetings, Webex Events (нова версія), Webex Events (класична версія) і Webex Trainings.
-
Якщо в запиті API не задано serviceType , API
lstrecordaccessHistory
повертає подання запису Webex Trainings лише в історії доступних даних. -
Якщо ServiceType є MeetingCenter, API
lstrecordaccessHistory
повертає історію доступу до записів Webex Meetings і Webex Events (нового). -
Якщо ServiceType є EventCenter, API
lstrecordaccessHistory
повертає історію доступу до запису Webex Events (класична версія).
The API: lstrecordaccessDetailHistory
може повертати відомості за допомогою ідентифікатора запису
Webex Meetings, Webex Events (нова версія), Webex Events (класична версія) і Webex Trainings.
Приклад запиту та відповіді API
Запит і відповідь API lstrecordaccessHistory
<? xml version="1.0" encoding="UTF- 8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
<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>ЗАПИСАНО</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>НавчальнийЦентр</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</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: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</history:downloaded>
<history:переглянуто>1</history:переглянуто>
<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:переглянуто>3</history:переглянуто>
<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:переглянуто>1</history:переглянуто>
<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:переглянуто>1</history:переглянуто>
<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:переглянуто>1</history:переглянуто>
<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:переглянуто>1</history:переглянуто>
<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:переглянуто>1</history:переглянуто>
<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>
Запит і відповідь API lstrecordaccessDetailHistory
<? 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>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
<body>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</bodyContent>
<? 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>false</history:registered>
<history:downloaded>false</history:downloaded>
<history:переглянуто>дійсно</history:переглянуто>
<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>false</history:registered>
<history:downloaded>true</history:downloaded>
<history:переглянуто>хибно</history:переглянуто>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
Впливають на API:
-
lstrecordaccessHistory
-
lstrecordaccessВідомостіІсторія
Виправте проміжок максимально дозволеної довжини опису подій Webex (Classic) між XMLAPI та Webex Page.
Уражені API
API XML: Створити подію та SetEvent елемент з опис дозволить ввести максимум 10 000 символів. Якщо введення перевищує розмір, це призведе до нового коду помилки та повідомлення:
060068 Опис незаконного введення. Цей опис не може перевищувати 10000 символів.
Зміни схеми
Ніякої зміни схеми.
Приклад запиту та відповіді API
Запит і відповідь API CreateEvent
Приклад запиту #API:
...
<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/event http://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>ПРИВАТНИЙ</listing>
</accessControl>
<metaData>
<sessionName>Тест ЄС</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:result>ПОМИЛКА</serv:result>
Неправильний опис введених даних. Опис не може перевищувати 10 000 символів
PRIMARY
060068
Впливають на API:
-
Створитивизвернення
-
SetEvent
XML API: GetUser повертає новий елемент безкоштовногорахунку
Уражені API
GetUser
повертає новий елемент, який визначаєfreeAccount
, обліковий запис користувача є FreeAccount
чи ні.
Зміни схеми
Приклад відповіді GetUser
Відповідь
GetUser:
AW
false
3
false
Впливають на API:
GetUser
Оновлення API 41.10.0
У схемі XML API 41.10.0 немає змін у схемі.
Оновлення API 41.9.0
Оновлення XML API 41.9.0
Виведення з експлуатації XML API 10.0.0 для всіх сайтів T31
Webex планує завершити підтримку життя XML API ver 10.0.0 для всіх сайтів T31.
Ми виводимо з експлуатації xml API 10.0.0 код з усіх виробництв в оновленні 41.9.0.
Оновлення API 41.8.0
Оновлення XML API 41.8.0
Виведення з експлуатації XML API 10.0.0 для всіх сайтів T31
Webex планує завершити підтримку життя XML API ver 10.0.0 для всіх сайтів T31.
Webex виявив, що деякі клієнти отримують доступ до URL-адреси XML API неправильним способом, як: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, правильний спосіб доступу до URL-адреси XML API як: https://{siteName}.webex.com/WBXService/XMLService.
Будь ласка, змініть доступ до коду XML API, використовуючи правильний спосіб уникнути впливу до закінчення життєзабезпечення на XML API версії 10.0.0.
Оновлення API 41.7.0
Оновлення XML API 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>true</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
ОНОВЛЕННЯ API 41.6.3
Оновлення XML API 41.6.3
Відповідь GetSite
— новий елемент supportLargeEvent
Вплив змін API та схеми
GetSite: повертає нові елементи з іменем supportLargeEvent
у розділі siteCommonOptions
, щоб абонент, що телефонує, знав, чи підтримує вебсайт Large Event (нова подія Webex)) чи ні.
зміна схеми
Приклад відповіді
Відповідь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>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
Оновлення API 41.6.0
Оновлення XML API 41.6.0
Підтримка XMLAPI вебекс-подій 2.0 у підготовці
Уражені API
GetUser
: повертає новий елемент з іменем largeEventCapacity
, який показує місткість нової події 2.0 (EC 2.0) у цьому обліковому записі користувача. Наприклад, якщо обліковий запис користувача має ліцензію CI_EC3K, значення largeEventCapacity
буде 3000.
Зміни схеми
Приклад відповіді
GetUserResponse:
XMLAPI LstRecording's CreateTime застосовує час початку запису
Уражені API
Запис
: Відповідь LstRecording
CreateTime
— це час, коли користувач насправді натискає кнопку запису.
Відомості
У минулому XML API використовував відмітку часу, коли запис було створено в базі даних, як час створення у відповіді LstRecording
. Тепер настав час, коли користувач фактично починає робити запис. Ця зміна стосується всіх службових записів. Немає зміни схеми.
Оновлення API 41.5.0
Оновлення XML API 41.5.0
XMLAPI має можливість запускати заплановані веб-конференції з ТМЗК як хост
Уражені API
-
CreateUser
: генеруєPIN-код організатора
незалежно від того, чи ввімкнено PMR користувача, коли роль користувача є організатором, повним адміністратором вебсайту чи лише для читання чи керування користувачами. -
УстановитиКористувача
: встановлюєPIN-код організатора
за допомогоюphones.hostPIN
, колиpersonalMeetingRoom.hostPIN
відсутній у запиті XML (передумова: перемикач функціїAllowStartScheduledMtgFromPhone
увімкнено). -
GetUser
: повертаєphones.hostPIN
незалежно від ввімкнення PMR користувача чи ні. (передумова: перемикач функціїAllowStartScheduledMtgFromPhone
увімкнено).
Зміни схеми
Відповідь користувачаGetResponse
:
УстановитиКористувача
:
Приклад відповіді
Відповідь користувачаGetResponse
:
УстановитиКористувача
:
Відповідь XMLAPI GetSite
на два нових елементи для мобільного клієнта
Уражені API
-
GetSite
: ТеперGetSite
відповість на два нових елементи для підтримки мобільного клієнта, який має логіку відображення або не відображення вкладки запису.-
увімкнути доступ дозапису
: вірно або невірно, адміністратори Webex можуть вмикати або вимикати доступ до запису за допомогою перемикача (EnableRecordingAccess
). -
станПустогоСховища
: true або false, якщо обидва сайти не підтримують функцію NBR і виділили простір сховища мережевих записів як нуль, відповідь стану буде true, в іншому випадку буде false.
-
Зміни схеми
Запит зразка для GetSite
Приклад відповіді для Getsite
Тема повідомлення електронної пошти, яка містить символи, що не належать до ASCII, буде закодована за допомогою RFC2047. У випадку чистої теми електронної пошти символів ASCII кодування відсутнє
Уражені APIНемає жодного впливу на будь-який запит API, корисне навантаження відповідей, але це змінює поведінку кодування суб'єкта електронної пошти. Коли тема електронної пошти, яка містить символи, що не належать до ASCII, буде закодована RFC2047. У випадку чистої теми електронної пошти символів ASCII кодування відсутнє.
Зміни схеми
Змін у схемі немає.
Оновлення API 41.4.0
Оновлення XML API 41.4.0
Створення запланованих подій Webex Події можуть використовувати рівень сайту за замовчуванням для тону входу та виходу
XMLAPI вирівнюється з поточною новою логікою контролю вхідного та вихідного тону. Всі тони для Webex Events контролювалися іншою установкою в адміністрації сайту. У GetSite
XMLAPI повертає додаткове поле entryExitToneEC
, щоб указати значення. Спочатку, коли адміністратор сайту встановив тон за промовчанням, функція Create Event не використовуватиме цей параметр, застосовуючи за замовчуванням XMLAPI.
Уражені API
API XML: GetSite повертає один новий елемент entryExitToneEC
для позначення значення.
API XML: Бізнес-логіка CreateEvent, SetEvent, GetEvent читає значення entryExitToneEC
.
Зміни схеми
XML API: Зразок відповіді GetSite:
<ns1:за замовчуванням>
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>ОГОЛОСИТИ ІМ’Я</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>так</ns1:voip>
<ns1:телеконференція>
<ns1:telephonySupport>НЕМАЄ</ns1:telephonySupport>
</ns1:телеконференція>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>хибно</ns1:updateTSPAccount>
</ns1:default>
Впливають на API:
-
GetSite
-
Створитивизвернення
-
SetEvent
-
GetEvent
XMLAPI просто повертає відомості про велику подію (Webex Event 2.0)
-
Якщо нарада Webex — це велика подія або вебтрансляція,
GetSessionInfo
повертає деяку докладну інформацію, зокрема пароль наради, числовий пароль наради, пароль члена організаційної команди й числовий пароль члена організаційної команди (схему не можна змінювати). -
XMLAPI не підтримує створення й редагування великої події або вебтрансляції, тому
CreateMeeting
іSetMeeting
повертають новий виняток (110064, тип сеансу події та вебтрансляції не підтримуються) у випадку великої події або вебтрансляції.
Вплив API
Ім'я API |
Опис |
Зауваження |
---|---|---|
|
Якщо нарада Webex — це велика подія або вебтрансляція, |
Схема не може бути змінена. |
|
Якщо користувач спробує використовувати API |
Поведінка повинна бути змінена. |
Оновлення API 41.3.0
Оновлення XML API 41.3.0
Нові зміни в XML API підтримують функцію Webex Events 2.0
Уражені API
Обидва API: Елементи повернення GetSessionInfo і GetMeeting також enableEvent
і enableWebniar
.
Ім'я елемента |
Опис |
---|---|
enableEvent |
Підтримка EC 2.0 на зустрічі Webex |
увімкнутиWebniar |
Підтримує вебінар під час зустрічі Webex |
Підтримка XMLAPI повертається над двома елементами для EC 2.0. Поточний випуск XML API не підтримує планування та встановлення зустрічі EC2.0.
Зміни схеми
GetSessionInfo
повертає елементи enableEvent
і enableWebniar
для EC 2.0.
GetMeeting
повертає елементи enableEvent
і enableWebniar
для EC 2.0.
Зразок відповіді:
Відповідь GetSessionInfo
:
<ep:listStatus>ЗАГАЛЬНОДОСТУПНИЙ</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
Відповідь GetMeeting
:
хибно
true
дійсно
true
false
false
дійсно
Нові зміни XMLAPI підтримують функцію лобі перед зустріччю
Уражені API
API XML: GetSite
, LstSummarySession
, GetSessionInfo
і GetMeeting
відповідуть на новий елемент enablePreMeetingLobby
для холу перед нарадою.
Зміни схеми
API XML: GetSite
повертає елемент enablePreMeetingLobby
для режиму підготовки до наради.
API XML: LstSummarySession
повертає елемент enablePremeetingLobby
для холу перед нарадою.
API XML: GetSessionInfo
повертає елемент enablePreMeetingLobby
для холу перед нарадою.
API XML: GetMeeting
повертає елемент enablePremeetingLobby
для режиму підготовки до наради.
Зразок відповіді:
Відповідь GetSite
:
false
false
хибно
true
дійсно
true
true
хибно
true
дійсно
Відповідь LstSummarySession
:
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>false</ep:isScheduledPMR>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePremeetingLobby>
Відповідь GetSessionInfo
:
<ep:listStatus>ЗАГАЛЬНОДОСТУПНИЙ</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
Відповідь GetMeeting
:
хибно
true
дійсно
true
false
false
дійсно
XML API GetSite
відповідь Розкрито зміну поведінки інформації
Уражені API
API XML: Відповідь тільки GetSite
наведено нижче елементів для облікового запису адміністратора, які включають ролі: SiteAdmin
, RO_SiteAdmin
і UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>...</ns1:SCActiveUser
поведінка змінилася
Дозволити тільки ролі адміністратора мати дані ліцензії відповіді GetSite
. Організатор або відвідувач не отримає ці дані ліцензії у відповіді GetSite
.
Нижче наведено API: Приклад відповіді GetSite
для адміністратора вебсайту
або адміністратора вебсайту з доступом лише до готовності
або адміністратора керування користувачами:
Оновлення API 41.2.0
Оновлення XML API 41.2.0
XMLAPI повинен підтримувати "CMR Hybrid VOIP", якщо сайт підтримує Webex телефонію
Уражені API
-
GetSite
повертає новий елементIsWebexTelephony
у відповіді. -
CreateUser
іSetUser
можуть оновити елементcmrHybridVoip
, якщо значенняIsWebexTelephony
відповідає дійсності разом з іншими умовами. ФункціяIsTSPUsingTelephonyAPI
більше не є актуальною.
Зміни схеми
XML API: Відповідь GetSite
повертає додатковий елемент IsWebexTelephony
Відповідь GetSite
містить цей новий елемент:
<ns1:isWebexTelephony>true</ns1:isWebexTelephonyAPI>
<ns1:participantAccessCodeLabel>Код доступу відвідувача</ns1:subscriberAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Ідентифікатор відвідувача</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
Версія LstSummarySession
підтримує версію EC2.0
Впливайте на API XML
LstSummarySession
поверне два нові елементи для підтримки EC 2.0
Ім'я елемента |
Опис |
---|---|
enableEvent |
Підтримка EC 2.0 на зустрічі Webex |
увімкнутиWebniar |
Підтримує вебінар під час зустрічі Webex |
Зміни схеми
XML API: СеансЗведення
:Додати елементи <enableEvent
> і <enableWebniar
>
Відповідь XML API: ЗведенняСеансуLst
Відповідь для EC 2.0
true
0
false
true
true
XMLAPI підтримує повернення параметра Webex-voice-assistant
користувача вебсайту для інтеграції MCT
Уражений API
GetUser
повертає новий елемент WebexAssistantEnabled
(так чи ні) у відповіді.
Зміни схеми
getUserResponse
:
Приклад відповіді
Оновлення API 41.1.0
У схемі XML API 41.1 немає змін у схемі.