- Strona główna
- /
- Artykuł
Omówienie aktualizacji interfejsu API Cisco Webex Meetings (API 41)
Znajdź wszystkie ważne potrzebne informacje o interfejsie Cisco Webex Meetings API, takie jak zmiany schematu i inne ogłoszenia.
Aby uzyskać więcej informacji na temat interfejsu XML API 39 i XML API 11, zobacz Omówienie aktualizacji interfejsu XML API Cisco Webex Meetings (XML API 39 i starszych).
Aby uzyskać więcej informacji na temat interfejsu XML API 40, zobacz Omówienie aktualizacji interfejsu API XML Cisco Webex Meetings (XML API 40 i nowszych).
Aby uzyskać aktualizacje interfejsu XML API 11 z dodatkiem SP9 i starszych wersji, przejdź do cisco DevNet.
Aktualizacje interfejsu API 41.12.0
Aktualizacje XML API 41.12.0
XMLAPI zablokuje harmonogram i edycję Webex Events (Classic) zgodnie z elementem konfiguracyjnym witryny EnableClassicEvent
, który jest fałszywy
Zmiany interfejsów API i schematu, których to dotyczy
Na stronie konfiguracji administracji witryny, jeśli pole wyboru Włącz klasyczne zdarzenie ma wartość false, ta witryna nie będzie już obsługiwać spotkań Webex Events (klasycznych).
Jeśli pole wyboru Włącz klasyczne ujście ma wartość false, należy wywołać następujące interfejsy API w celu obsługi spotkania Webex Events (classic):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstrecyEvent
, LstrecordedEvent
, LstrecyProgram
, UploadEventImage
Interfejs API odpowie na nowy wyjątek 010106 Klasyczne wydarzenie zostało wyłączone.
Zmiany schematu
Brak zmian schematu.
Przykład żądania i odpowiedzi interfejsu API
Żądanie interfejsu API CreateEvent i odpowiedź
Prośba o CreateEvent
XXXXXXXX
XMLAPI EC Testing
07/17/2021 01:29:15
15
Odpowiedź 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>FAILURE</serv:result>
<serv:reason>Klasyczne Wydarzenie zostało wyłączone.</serv:reason>
<serv:gsbStatus>GŁÓWNY</serv:gsbStatus>
<serv:WyjątkoweID>010106</serv:WyjątkoweID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateEvent3.1.3 Wpływa na interfejsy API:
-
SetEvent GetEvent
-
GetSessionInfo
-
LstsummaryEvent
-
LstrecedEvent
-
LstsummaryProgram
-
UploadEventImage
XMLAPI LstMeetingType
odpowie na nowy element podProductCodePrefix
Interfejsy API, których dotyczy problem
Bieżące API LstMeetingType
element odpowiedzi produktyCodePrefix
: PRO, AUO i inne, które są prefiksem typu spotkania Webex.
Po tym nowym ulepszeniu API odpowie na nowy element subProdctCodePrefix
:PRO1, PRO2 itd., który można dostosować do prefiksu typu spotkania.
Zmiany schematu w interfejsie API: Rodzaj LstMeetingTypu
Odpowie na nowy element: subProdctCodePrefix
Przykład żądania i odpowiedzi interfejsu API
Żądanie i odpowiedź interfejsu API
typu LstMeetingType
Żądanie typu LstMeetingType
13810
Odpowiedź typu 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> //Nowy element dla niestandardowego typu spotkania
<mtgtype:active>AKTYWOWANE</mtgtype:active>
<mtgtype:name>Cus_Chat_Zamknięty</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Typ zamknięcia</mtgtype:displayName>
Aktualizacje API 41.11.0
Aktualizacje XML API 41.11.0
Zgodność interfejsu XML API z interfejsem API zarządzania użytkownikami dla witryn zarządzanych przez centrum Control Hub
Zmiany interfejsów API i schematu, których to dotyczy
Jeśli aplikacja integracyjna korzysta obecnie z interfejsów API zarządzania użytkownikami Webex XMLAPI: CreateUser
, SetUser
, DelUser
i GetUser
w celu dostarczania lub zarządzania użytkownikami, po przekształceniu klasycznej witryny Webex w witrynę zarządzaną przez Control Hub te interfejsy API będą nadal działać w celu zapewnienia zgodności do przodu. Istnieją pewne zmiany w zachowaniu, jak wspomniano poniżej:
-
Podczas korzystania z createUser- jeśli stan użytkownika w Control Hub nie jest "aktywny", status użytkownika w witrynie nie będzie aktywny. Jeśli stan użytkownika w Control Hub jest aktywny , to stan użytkownika wwitrynie jest również aktywny, odniesienie: Status użytkownika nowych i skonwertowanych użytkowników w Control Hub.
-
Element hasła interfejsów API CreateUser i SetUser zostanie zignorowany, zaczniemy wysyłać e-mail aktywacyjny do nowych użytkowników, użytkownicy mogą kliknąć link w wiadomości e-mail do aktywnego nowego konta i wprowadzić nowe hasło.
-
Aktywny element interfejsu API CreateUser zostanie zignorowany, nowego użytkownika (niezweryfikowanego) nie można aktywować za pomocą tego parametru za pomocą interfejsu API SetUser.
-
Wartość elementu webExId w bodyContent interfejsów API CreateUser musi być taka sama jak w wiadomości e-mail. Jeśli webExId różni się od e-maila, podczas przechowywania go w WebDB będziemy traktować webExId tak samo jak e-mail, a wartość zostanie zignorowana.
-
Wartość elementu webExId w treści interfejsów API SetUser musi być tożsamością użytkownika adresu e-mail, można ją zmienić za pomocą <email> w treści.
-
Interfejs API SetUser będzie obsługiwał zmianę adresu e-mail istniejącego użytkownika: powiedzie się, jeśli konto operacji w SecurityContext to Control Hub pełny administrator witryny. W przeciwnym razie interfejs API zgłasza błąd z nowym kodem błędu i komunikatem poniżej:
-
030120 Aby zmienić adres e-mail, konto musi być pełnoprawnym administratorem witryny.
-
-
Element newWebExId w bodyContent interfejsu API SetUser zostanie zignorowany.
-
Interfejs API SetUser próbuje zmienić na adres e-mail, który jest już używany, interfejs API podnosi poniżej nowy kod błędu i komunikat o błędzie:
-
030118 E-mail jest już używany w witrynach zarządzanych przez Control Hub.
-
-
Interfejs API DelUser dezaktywuje użytkownika po stronie spotkania Webex, a odpowiednia licencja na spotkanie jest usuwana z witryny Webex. Tego dezaktywowanego użytkownika można ponownie aktywować za pomocą interfejsu API: SetUser (AKTYWOWANY) tak długo, jak użytkownik zostanie wcześniej zweryfikowany.
-
Interfejsy API CreateUser i SetUser wyświetlają nowy kod błędu i komunikat o błędzie, jak pokazano poniżej:
-
030117, Ten użytkownik istnieje poza Twoją organizacją, więc należy go zgłosić, aby przejść do swojej organizacji w procesie użytkownika żądania. Aby zapoznać się z instrukcjami zgłaszania praw użytkownika do organizacji, zobacz Zgłaszanie praw do użytkowników w organizacji (konwertowanie użytkowników). Musisz zweryfikować domenę, do której należy użytkownik, zanim zgłosisz prawa do użytkownika.
-
030119 Token dostępu CI musi zawierać zakres webexsquare: admin podczas inicjowania obsługi administracyjnej użytkownika.
-
Tylko przez ograniczony czas obsługiwana jest zgodność z przyszłością. Powiadomimy z wyprzedzeniem, zanim ta zgodność zostanie usunięta.
Zmiany schematu
Brak zmian schematu w tych interfejsach API: CreateUser
, SetUser
, DelUser
i GetUser
.
Przykład żądania i odpowiedzi interfejsu API
Żądanie i odpowiedź interfejsu API CreateUser
Żądanie 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:schemaLokalizacja="http://www.webex.com/schemas/2002/06/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{site Admin account}</webExID>
<email>{site Admin account}</email>
<sessionTicket>xxxx</sessionTicket> lub lub
lub , przy użyciu CI "accessToken", musi zawierać zakres webexsquare:admin podczas obsługi administracyjnej użytkownika
</securityContext>
</header>
<ciało>
<webExId>Jack@qa.webex.com</webExId> --- powinna to być tożsamość użytkownika adresu e-mail
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>...</password>
<przywilej>
<host>true</host>
</przywilej>
<active>AKTYWOWANY</active> -- ten parametr nie może aktywować użytkownika bezpośrednio, dopóki użytkownik nie uaktywni się samodzielnie za pomocą aktywacyjnej wiadomości e-mail.
</ciało>
Przykład odpowiedzi 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>SUKCES</serv:result>
<serv:gsbStatus>GŁÓWNY</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>
Wpływa na interfejsy API:
-
Stwórz użytkownika
-
Ustaw użytkownika
-
DelUser
Interfejs API XML obsługuje zgodność z istniejącym uwierzytelnianiem użytkownika po przekonwertowaniu klasycznej witryny Webex na witrynę zarządzaną przez Control Hub
Interfejsy API, których dotyczy wpływ
Po konwersji klasycznej witryny Webex na witrynę zarządzaną przez Control Hub wartość elementu w musi być taka sama jak wiadomość e-mail, szczegóły poniżej:
-
Dla istniejących użytkowników utworzonych w klasycznej witrynie Webex obsługujemy zarówno stary webExID (na przykład: Jack) i nowy webExID (treść jest taka sama jak e-mail, przykład: Jack@xx.com) do logowania, ta zgodność uwierzytelniania z poprzednimi wersjami dotyczy wszystkich interfejsów API XML.
-
W przypadku nowych użytkowników utworzonych w witrynach zarządzanych przez Control Hub wartość elementu webExID musi być taka sama jak w przypadku adresu e-mail do logowania.
{siteName}
{userName} --- istniejący użytkownicy zostali utworzeni w klasycznej witrynie webEx, może to być: jack lub jack@xx.com; nowy użytkownik musi korzystać z jack@xx.com
xxxx lub lub lub
Wpływ na interfejsy API:
Wszystkie interfejsy API XML.
Po przekształceniu klasycznej witryny Webex w witrynę zarządzaną przez Control Hub wartość elementu <bodyContent> musi być taka sama jak wiadomość e-mail, szczegóły poniżej:
-
W przypadku istniejących użytkowników utworzonych w klasycznej witrynie Webex obsługujemy zarówno stary webExId(np.: Jack) i nowy webExId (treść jest taka sama jak e-mail, na przykład: Jack@xx.com) w bodyContent.
-
W przypadku nowych użytkowników utworzonych w witrynach zarządzanych przez Control Hub wartość elementu webExId musi być taka sama jak adres e-mail w
treści ciała
.
xxxx --- istniejący użytkownicy zostali utworzeni w klasycznej witrynie webEx, może to być: jack lub jack@xx.com; nowy użytkownik musi korzystać z jack@xx.com
Wpływa na interfejsy API: GetUser
, SetUser
i DelUser
.
Zmiany schematu
Brak zmian schematu w żadnych interfejsach API.
Przykład żądania i odpowiedzi interfejsu API
Żądanie i odpowiedź interfejsu API GetUser
żądanie 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> --- istniejący użytkownicy zostali utworzeni w klasycznej witrynie webEx, może to być: jack lub jack@xx.com; nowy użytkownik musi korzystać z jack@xx.com
xxxx lub lub lub
xxxx --- istniejący użytkownicy zostali utworzeni w klasycznej witrynie webEx, może to być: jack lub jack@xx.com; nowy użytkownik musi użyć jack@xx.com
Przykład odpowiedzi
API:
...taki sam jak wcześniej
Ulepszenie rejestrowania raportu historii widoku API do obsługi w Webex Meetings, Webex Events (Nowy) i Webex Events (Classic)
Interfejsy API, których dotyczy wpływ
Aktualne API: lstrecordaccessHistory
i lstrecordaccessDetailHistory
obsługują tylko dostęp do raportu historii do widoku nagrania Webex Trainings. Nowe ulepszenie obsługuje również webex Meetings, Webex Events (nowy) i Webex Events (klasyczny) widok nagrywania raportu historii.
Zmiany schematu
Obsługujemy poniższy nowy schemat do API lstrecordaccessHistory w treści żądania API:
MeetingCenter
TrainingCenter
EventCenter
Szczegóły
Interfejs API: lstrecordaccessHistory
jest w stanie przywrócić dostęp do widoku nagrania historii dla Webex Meetings, Webex Events (nowy), Webex Events (klasyczny) i Webex Trainings.
-
Jeśli żądanie API nie zawiera typu serwomechanizmów , API
lstrecordaccessHistory
zwraca widok nagrania Webex Trainings tylko do historii dostępu. -
Gdy serviceType to MeetingCenter, interfejs API
lstrecordaccessHistory
zwraca dostęp do historii zarówno do Webex Meetings, jak i Webex Events (nowy). -
Gdy serviceType jest EventCenter, API
lstrecordaccessHistory
zwraca dostęp do historii widoku nagrania Webex Events (klasycznego).
Interfejs API: lstrecordaccessDetailHistory
jest w stanie zwrócić szczegóły przez recordID
Webex Meetings, Webex Events (nowy), Webex Events (klasyczny) i Webex Trainings.
Przykład żądania i odpowiedzi interfejsu API
lstrecordaccessHistory
żądanie i odpowiedź interfejsu API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<ciało>
<viewTimeScope>
<viewTimeStart>9/20/2021 00:00:00</viewTimeStart>
<viewTimeEnd>9/28/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<zamówienie>
<orderBy>RECORDID</orderBy>
<orderAD>ASC</orderAD>
</zamówienie>
<serwisiceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serwisyTypy>
</ciało>
<?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:historia="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>SUKCES</serv:result>
<serv:gsbStatus>GŁÓWNY</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>LstrecordaccessTest historii TC-20210924 1324-1</history:recordName>
<history:creationTime>09/24/2021 13:28:13</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>2</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>TestErollment_001-20210610 1905-1</history:recordName>
<history:creationTime>06/10/2021 19:10:15</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>3</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Test natychmiastowego odtwarzania 2-20210705 0709-1</history:recordName>
<history:creationTime>07/05/2021 07:15:06</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>EC2.0_232423-20210922 0447-1</history:recordName>
<history:creationTime>09/22/2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest historii EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>09/24/2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest historyczny MC-20210924 1319-1</history:recordName>
<history:creationTime>09/24/2021 13:25:12</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest historii EC classic-20210924 1331-1</history:recordName>
<history:creationTime>09/24/2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
lstrecordaccessDetailHistory
żądanie i odpowiedź interfejsu API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<ciało>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</ciało>
<?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:historia="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>SUKCES</serv:result>
<serv:gsbStatus>GŁÓWNY</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>09/24/2021 13:27:26</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>false</history:downloaded>
<history:viewed>true</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>09/24/2021 13:27:39</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>true</history:downloaded>
<history:viewed>false</history:viewed>
<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>
Wpływa na interfejsy API:
-
lstrecordaccessHistoria
-
lstrecordaccessDetailHistory
Napraw lukę maksymalnej dozwolonej długości opisu zdarzeń Webex (classic) między XMLAPI a stroną Webex.
Interfejsy API, których dotyczy wpływ
Interfejs API XML: Element opisuCreateEvent i SetEvent pozwoli na wprowadzenie maksymalnie 10000 znaków, jeśli wpiszesz wielkość, spowoduje to powstanie nowego kodu błędu i komunikatu:
060068 Opis nielegalnych danych wejściowych. Ten opis nie może przekraczać 10000 znaków.
Zmiany schematu
Bez zmiany schematu.
Przykład żądania i odpowiedzi interfejsu API
Żądanie interfejsu API CreateEvent i odpowiedź
Przykład żądania #API:
...
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent"
xmlns:att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLokalizacja="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>PRYWATNY</listing>
</accessControl>
<metaData>
<sessionName>Test EC</sessionName>
<description>........Załóżmy, że wypełnisz 10000 znaków w opisie.......</description>
</metaData>
...
------------------------------------
Przykład odpowiedzi #API, gdy opis przekracza 10000 znaków:
<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>NIEPOWODZENIE</serv:result>
Nielegalny opis danych wejściowych. Opis nie może przekraczać 10 000 znaków
PRIMARY
060068
Wpływa na interfejsy API:
-
CreateEvent
-
SetEvent
Interfejs API XML: GetUser zwraca nowy element freeAccount
Interfejsy API, których dotyczy wpływ
GetUser
zwraca nowy element, który identyfikujefreeAccount
, konto użytkownika jest FreeAccount
lub nie.
Zmiany schematu
Przykład odpowiedzi GetUser
Odpowiedź użytkownika GetUser:
AW
false
3
false
Wpływa na interfejsy API:
GetUser
Aktualizacje interfejsu API 41.10.0
Nie ma żadnych zmian schematu w schemacie XML API 41.10.0.
Aktualizacje api 41.9.0
Aktualizacje XML API 41.9.0
Likwidacja interfejsu API XML 10.0.0 dla wszystkich lokacji T31
Webex planuje zakończyć obsługę XML API ver 10.0.0 dla wszystkich witryn T31.
W aktualizacji 41.9.0 likwidujemy kod XML API 10.0.0 ze wszystkich produkcji.
Aktualizacje api 41.8.0
Aktualizacje XML API 41.8.0
Likwidacja interfejsu API XML 10.0.0 dla wszystkich lokacji T31
Webex planuje zakończyć obsługę XML API ver 10.0.0 dla wszystkich witryn T31.
Webex znalazł niektórych klientów uzyskujących dostęp do adresu URL XML API przy użyciu nieprawidłowego sposobu: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, właściwy sposób uzyskiwania dostępu do adresu URL interfejsu API XML jako: https://{nazwa_witryny}.webex.com/WBXService/XMLService.
Przełącz interfejs XML API dostępu do kodu we właściwy sposób, aby uniknąć wpływu przed zakończeniem wsparcia technicznego XML w wersji 10.0.0.
Aktualizacje interfejsu API 41.7.0
Aktualizacje XML API 41.7.0
Mobilne usuwanie i edycja nagrań powinna być kontrolowana przez opcję administrowania witryną: Zezwalanie hostom na ponowne przypisywanie, edytowanie, wyłączanie i usuwanie nagrań
Zmiany interfejsów API i schematu, których to dotyczy
GetSite
: zwróci nowe elementy nazewnictwa enableNBRMCModify
, i separateNoRecordingEdit
pod narzędziami.
Przykład odpowiedzi
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>SUKCES</serv:result>
<serv:gsbStatus>GŁÓWNY</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>false</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>true</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
Aktualizacje api 41.6.3
Aktualizacje XML API 41.6.3
GetSite
Response nowy element supportLargeEvent
Zmiany interfejsów API i schematu, których to dotyczy
GetSite: zwraca nowe elementy o nazwie supportLargeEvent
w obszarze siteCommonOptions
, aby powiadomić dzwoniącego, czy witryna obsługuje duże wydarzenie (Webex Event (nowe)), czy też nie.
Zmiana schematu
Przykład odpowiedzi
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>SUKCES</serv:result>
<serv:gsbStatus>GŁÓWNY</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>false</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
Aktualizacje interfejsu API 41.6.0
Aktualizacje XML API 41.6.0
Obsługa interfejsu XMLAPI Webex Events 2.0 w inicjowaniu obsługi administracyjnej
Interfejsy API, których dotyczy wpływ
GetUser
: zwraca nowy element o nazwie largeEventCapacity
, który pokazuje pojemność nowego Event 2.0 (EC 2.0) na tym koncie użytkownika. Na przykład, jeśli konto użytkownika ma licencję CI_EC3K, wartość largeEventCapacity
wynosi 3000.
Zmiany schematu
Przykład odpowiedzi
GetUserResponse:
XMLAPI LstRecording's CreateTime stosuje czas rozpoczęcia nagrywania
Interfejsy API, których dotyczy wpływ
Nagrywanie LstRecording
: Odpowiedź nagrania
LstRecording CreateTime
to czas, w którym użytkownik faktycznie naciśnie przycisk nagrywania.
Szczegóły
W przeszłości API XML używało znacznika czasu, kiedy nagranie zostało utworzone w bazie danych, jako czasu tworzenia w odpowiedzi LstRecording
. Teraz jest to czas, w który użytkownik faktycznie zaczyna nagrywać. Ta zmiana dotyczy wszystkich nagrań serwisowych. Schemat nie został uchytny.
Aktualizacje interfejsu API 41.5.0
Aktualizacje XML API 41.5.0
XMLAPI ma możliwość uruchamiania zaplanowanych spotkań Webex z PSTN jako hosta
Interfejsy API, których dotyczy wpływ
-
Kreator użytkownika:
generuje
kod PIN hosta
niezależnie od tego, czy funkcja PMR użytkownika jest włączona, czy nie, gdy rolą użytkownika są administratorzy witryny prowadzącego, administratorzy witryny tylko do odczytu lub administratorzy witryny zarządzania użytkownikami. -
SetUser:
ustawia
hostPIN
za pomocątelefonów.hostPIN
gdypersonalMeetingRoom.hostPIN
nie jest w żądaniu XML (warunek wstępny: włączono przełącznik funkcjiAllowStartScheduledMtgFromPhone
). -
GetUser
: zwracatelefony.hostPIN
niezależnie od tego, czy PMR użytkownika jest włączony, czy nie. (warunek wstępny: włączono przełącznik funkcjiAllowStartScheduledMtgFromPhone
).
Zmiany schematu
GetUserResponse
:
SetUser:
Przykład odpowiedzi
GetUserResponse
:
SetUser:
XMLAPI GetSite
odpowiedzi dwa nowe elementy dla klienta mobilnego
Interfejsy API, których dotyczy problem
-
GetSite
:GetSite
odpowie teraz na dwa nowe elementy wspierające klienta mobilnego, który ma logikę do wyświetlania lub nie wyświetlania karty nagrywania.-
enableRecordingAccess
: true lub false, superadministratorzy Webex mogą włączyć lub wyłączyć dostęp do nagrywania za pomocą przełącznika (EnableRecordingAccesses
). -
storageEmptyStatus
: true lub false, jeśli obie strony nie obsługują funkcji NBR i nie przydzieliły miejsca do przechowywania NBR jako zero, wtedy odpowiedź stanu jest prawdziwa, w przeciwnym razie jest fałszywa.
-
Zmiany schematu
Przykładowe żądanie GetSite
Przykładowa odpowiedź dla Getsite
Temat wiadomości e-mail zawierający znaki inne niż ASCII zostanie zakodowany w dokumencie RFC2047. W przypadku czystego tematu wiadomości e-mail ze znakiem ASCII nie ma kodowania
Interfejsy API, których dotyczy wpływNie ma wpływu na żadne żądanie interfejsu API, ładunek odpowiedzi, ale zmienia zachowanie kodowania tematu wiadomości e-mail. Gdy temat wiadomości e-mail zawierający znaki inne niż ASCII zostanie zakodowany za pomocą specyfikacji RFC2047. W przypadku czystego tematu wiadomości e-mail ze znakiem ASCII nie ma kodowania.
Zmiany schematu
Nie ma żadnych zmian schematu.
Aktualizacje API 41.4.0
Aktualizacje XML API 41.4.0
Tworzenie zdarzeń Webex zaplanowanych na wydarzenia może wykorzystywać domyślne ustawienia na poziomie witryny przy wejściu i wyjściu
Interfejs XMLAPI jest zgodny z bieżącą nową logiką sterowania tonem wejścia i wyjścia. Wszystkie dźwięki dla Webex Events były kontrolowane przez inne ustawienie w administracji witryny. W GetSite
, XMLAPI zwraca dodatkowe pole entryExitToneEC
, aby wskazać wartość. Pierwotnie, gdy administrator witryny ustawi domyślny dźwięk, opcja Utwórz zdarzenie nie wykorzysta tego ustawienia, stosując domyślny interfejs XMLAPI.
Interfejsy API, których dotyczy wpływ
Interfejs API XML: GetSite zwraca jeden nowy element entryExitToneEC
w celu wskazania wartości.
Interfejs API XML: CreateEvent, SetEvent, GetEvent back end logika biznesowa odczytuje wartość entryExitToneEC
.
Zmiany schematu
Interfejs API XML: Przykład odpowiedzi GetSite:
true
ANNOUNCENAME
NOTONE
true
NONE
true
false
Wpływa na interfejsy API:
-
GetSite
-
CreateEvent
-
SetEvent
-
GetEvent
XMLAPI zwraca tylko informacje szczegółowe o dużym zdarzeniu (Webex Event 2.0)
-
Jeśli spotkanie Webex jest dużym wydarzeniem lub webcastem,
GetSessionInfo
zwraca szczegółowe informacje, w tym hasło do spotkania, hasło numeryczne spotkania, hasło panelisty i hasło numeryczne panelisty (nie należy zmieniać schematu). -
XMLAPI nie obsługuje tworzenia i edytowania dowolnego dużego wydarzenia lub funkcji webcastu, więc
CreateMeeting
iSetMeeting
zwracają nowy wyjątek (110064, Typ wydarzenia i sesji webcastu nie są obsługiwane) dla dużego wydarzenia lub przypadku webcastu.
Interfejsy API wpływu
Nazwa interfejsu API |
Opis |
Uwaga |
---|---|---|
|
Jeśli spotkanie Webex jest dużym wydarzeniem lub webcastem, |
Schemat nie może zostać zmieniony. |
|
Jeśli użytkownik próbuje użyć interfejsu API |
Zachowanie należy zmienić. |
Aktualizacje api 41.3.0
Aktualizacje XML API 41.3.0
Nowe zmiany w interfejsie API XML obsługują funkcję Webex Events 2.0
Interfejsy API, których dotyczy wpływ
Oba interfejsy API: GetSessionInfo i GetMeeting zwracają elementy enableEvent
i enableWebniar
też.
Nazwa elementu |
Opis |
---|---|
enableEvent |
Obsługa EC 2.0 na spotkaniu Webex |
enableWebniar |
Obsługuje webinarium na spotkaniu Webex |
Obsługa XMLAPI zwraca wartość powyżej dwóch elementów dla EC 2.0. Bieżąca wersja interfejsu API XML nie obsługuje planowania i ustawiania spotkania EC2.0.
Zmiany schematu
GetSessionInfo
zwraca elementy enableEvent
i enableWebniar
dla EC 2.0.
GetMeeting
zwraca elementy enableEvent
i enableWebniar
dla EC 2.0.
Próbka odpowiedzi:
Odpowiedź GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
true
Odpowiedź GetMeeting
:
false
true
true
true
false
false
true
Nowe zmiany XMLAPI obsługują funkcję lobby przed spotkaniem
Interfejsy API, których dotyczy wpływ
Interfejs API XML: GetSite
, LstSummarySession
, GetSessionInfo
, i GetMeeting
odpowiedzą na nowy element enablePreMeetingLobby
dla lobby przed spotkaniem.
Zmiany schematu
Interfejs API XML: GetSite
zwraca element enablePreMeetingLobby
dla poczekalni przed spotkaniem.
Interfejs API XML: LstSummarySession
zwraca element enablePreMeetingLobby
dla poczekalni przed spotkaniem.
Interfejs API XML: GetSessionInfo
zwraca element enablePreMeetingLobby
dla poczekalni przed spotkaniem.
Interfejs API XML: GetMeeting
zwraca element enablePreMeetingLobby
dla poczekalni przed spotkaniem.
Próbka odpowiedzi:
Odpowiedź firmy GetSite
:
<ns1:siteCommonOptions>
<ns1:SupportCustomDialRestriction>false</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>false</ns1:SupportTelePresence>
<ns1:SupportTelePresencePlus>false</ns1:SupportTelePresencePlus>
<ns1:EnableCloudTelepresence>true</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>true</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>true</ns1:enablePersonalMeetingRoom>
<ns1:SupportAlternateHost>true</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturn nScheduledPMR>false</ns1:SupportXMLAPIReturn nScheduledPMR>
<ns1:SupportAnyoneHostMeetings>prawda</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>prawda</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
response:
false
true
0
false
false
false
true
Odpowiedź GetSessionInfo
:
PUBLIC
false
true
false
false
false
false
true
Odpowiedź GetMeeting
:
false
true
true
true
false
false
true
Interfejs API XML GetSite
Zmiana zachowania informacji o odpowiedzi ujawnia
Interfejsy API, których dotyczy wpływ
Interfejs API XML: GetSite
odpowiada tylko na poniższe elementy konta administratora, które obejmują role: SiteAdmin
, RO_SiteAdmin
i UserAdmin
.
...
...
...
...
...
...
...
...
Zachowanie zmienione
Zezwól tylko roli administratora mieć odpowiedzi dane licencjiGetSite
. Prowadzący lub uczestnik nie otrzyma tych danych licencji w odpowiedzi na GetSite
.
Poniżej znajdują się API: Przykład odpowiedzi firmy GetSite
dla siteadmin
lub siteadmin
gotowy lub administrator zarządzania użytkownikami:
Aktualizacje api 41.2.0
Aktualizacje XML API 41.2.0
XMLAPI powinien obsługiwać "CMR Hybrid VOIP", jeśli witryna obsługuje telefonię Webex
Interfejsy API, których dotyczy wpływ
-
GetSite
zwraca nowy elementIsWebexTelephony
w odpowiedzi. -
CreateUser
iSetUser
mogą zaktualizować elementcmrHybridVoip
, jeśliIsWebexTelephony
jest prawdziwa wraz z innymi warunkami.IsTSPUsingTelephonyAPI
nie ma już konsekwencji.
Zmiany schematu
Interfejs API XML: Odpowiedź GetSite
zwraca dodatkowy element IsWebexTelephony
Odpowiedź firmy GetSite
zawiera ten nowy element:
true
false
Osobisty numer konferencji
Kod dostępu uczestnika
Kod dostępu prowadzącego
ID uczestnika
.....
LstSummarySession
obsługuje EC2.0
Wpływ na interfejsy API XML
LstSummarySession
zwróci dwa nowe elementy w celu wsparcia EC 2.0
Nazwa elementu |
Opis |
---|---|
enableEvent |
Obsługa EC 2.0 na spotkaniu Webex |
enableWebniar |
Obsługuje webinarium na spotkaniu Webex |
Zmiany schematu
Interfejs API XML: LstSummarySession
: Załączanie elementów <enableEvent
> i <enableWebniar
>
Odpowiedź XML API: LstSummarySession
Odpowiedź dla EC 2.0
true
0
false
true
true
XMLAPI obsługuje zwrot opcji asystenta głosowego
użytkownika witryny dla integracji MCT
Interfejs API, którego dotyczy problem
GetUser
zwraca nowy element webexAssistantEnabled
(true lub false) w odpowiedzi.
Zmiany schematu
getUserResponse:
Przykład odpowiedzi
Aktualizacje api 41.1.0
W schemacie XML API 41.1 nie ma żadnych zmian schematu.