- Strona główna
- /
- Artykuł
Znajdź wszystkie ważne potrzebne informacje na temat interfejsu API Cisco Webex Meetings, 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 dla interfejsu XML API 11 SP9 i starszych wersji, przejdź na stronę Cisco DevNet.
Aktualizacja interfejsu API 41.12.0
Aktualizacje interfejsu API XML 41.12.0
XMLAPI zablokuje harmonogram i edycję zdarzeń Webex (Classic) zgodnie z elementem konfiguracji witryny EnableClassicEvent
to jest fałszywe
Zmiany dotyczące interfejsów API i schematu
Jeśli pole wyboru Włącz klasyczne wydarzenie jest nieprawdziwe na stronie konfiguracji administrowania witryną, ta witryna nie będzie już obsługiwać spotkań Webex Events (klasycznych).
Jeśli pole wyboru Włącz wydarzenie klasyczne jest fałszywe, zadzwoń do tych interfejsów API, aby obsługiwać spotkanie Webex Events (klasyczne):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
API odpowie na nowy wyjątek 010106Klasyczne Wydarzenie zostało wyłączone.
Zmiany schematu
Brak zmian schematu.
Przykład żądania i odpowiedzi API
CreateEvent Żądanie API i odpowiedź
Żądanie CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>XMLAPI EC Testing</sessionName>
</metaData>
<schedule>
<startDate>07/17/2021 01:29:15</startDate>
<openTime>15</openTime>
</schedule>
</bodyContent>
Odpowiedź na 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>NIEWYDOLNOŚĆ</serv:result>
<serv:reason>Klasyczne Wydarzenie zostało wyłączone.</serv:reason>
<serv:gsbStatus>PODSTAWOWY</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 Wpływa na interfejsy API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
odpowiedzą na nowy element subProductCodePrefix
Interfejsy API, których dotyczy problem
Bieżące API LstMeetingType
element odpowiedzi productionCodePrefix
: PRO, AUO i inne prefiksy typu spotkań Webex.
Po tym nowym ulepszeniu API odpowie na nowy element subProdctCodePrefix
:PRO1, PRO2 itd., które można dostosować do prefiksu typu spotkania.
Zmiany schematu w API: LstMeetingType
Odpowie on na nowy element: subProdctCodePrefix
Przykład żądania i odpowiedzi API
LstMeetingType
Żądanie i odpowiedź interfejsu API
Żądanie LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
Odpowiedź LstMeetingType
<serv:body>
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:meetingType>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Nowy element na miarę typu spotkania
<mtgtype:active>AKTYWOWANY</mtgtype:active>
<mtgtype:name>Cus_Chat_Zamknięty</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Zamknięty</mtgtype:displayName>
Aktualizacje interfejsu API 41.11.0
Aktualizacje interfejsu API XML 41.11.0
Zgodność interfejsu API XML w interfejsie zarządzania użytkownikami API dla witryn zarządzanych przez Control Hub
Zmiany dotyczące interfejsów API i schematu
Jeśli Twoja aplikacja integracyjna obecnie korzysta z interfejsów API zarządzania użytkownikami Webex XMLAPI: CreateUser
, SetUser
, DelUser
i GetUser
aby zapewnić lub zarządzać 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 kompatybilności do przodu. Istnieją pewne zmiany zachowania, 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, wtedy stan użytkownika w witrynie jest również aktywny, odniesienie: Stan 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ć aktywacyjną wiadomość e-mail do nowych użytkowników, użytkownicy mogą kliknąć łącze w wiadomości e-mail do aktywnego nowego konta i wprowadzić nowe hasło.
Informacje aktywnyelementinterfejsuCreateUser API zostanie zignorowany, nowego użytkownika (niezweryfikowanego) nie można aktywować za pomocą tego parametru za pomocą interfejsu API SetUser.
Wartość webExId element w treści interfejsów API CreateUser musi być taki sam jak adres e-mail. Jeśli webExId różni się od e-mail, zajmiemy się webExId tak samo jak e-mail podczas przechowywania go w WebDB, a wartość zostanie zignorowana.
Wartość webExId elementem w treści interfejsów API SetUser musi być tożsamość użytkownika adresu e-mail, można ją zmienić za pomocą <e-mail> w treści ciała.
Interfejs API SetUser będzie obsługiwał zmianę wiadomości e-mail istniejącego użytkownika: to jest skuteczne, jeśli konto operacyjne w SecurityContext jest Control Hub pełny administrator witryny. W przeciwnym razie API zgłasza błąd z nowym kodem błędu i poniższym komunikatem:
030120 Konto musi być pełnoprawnym administratorem witryny, aby zmienić adres e-mail.
Element newWebExId w treści interfejsu API SetUser zostanie zignorowany.
Interfejs API SetUser próbuje zmienić adres e-mail, który jest już używany. Interfejs API wyświetla poniżej nowy kod błędu i komunikat o błędzie:
Adres e-mail 030118 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. Ten dezaktywowany użytkownik może zostać ponownie aktywowany za pomocą interfejsu API: SetUser (<active>AKTYWOWANY</active>) tak długo, jak użytkownik zostanie wcześniej zweryfikowany.
Interfejsy API CreateUser i SetUser wywołują nowy kod błędu i komunikat o błędzie, jak pokazano poniżej:
030117, Ten użytkownik istnieje poza Twoją organizacją, więc musi zostać zgłoszony, aby przejść do Twojej organizacji w procesie użytkownika zgłoszenia. Aby uzyskać informacje na temat zgłaszania użytkowników do organizacji, zobacz temat Zgłaszanie użytkowników do organizacji (Konwertowanie użytkowników). Przed zgłoszeniem użytkownika należy zweryfikować domenę, do której należy użytkownik.
030119 Token dostępu CI musi zawierać zakres webexsquare: administrator podczas konfigurowania użytkownika.
Obsługiwana jest tylko przez ograniczony okres zgodności do przodu. Przed usunięciem tej zgodności zapewnimy wcześniejsze powiadomienie. |
Zmiany schematu
Brak zmian schematu tych interfejsów API: CreateUser
, SetUser
, DelUser
i GetUser
.
Przykład żądania i odpowiedzi 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/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{konto administratora witryny}</webExID>
<email>{konto administratora witryny}</email>
<sessionTicket>xxxx</sessionTicket> lub <password> lub <webExAccessToken>
lub <accessToken>, podczas korzystania z CI "accessToken", musi zawierać zakres webexsquare:admin podczas obsługi administracyjnej użytkownika
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<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>
<privilege>
<host>prawdziwy</host>
</privilege>
<active>AKTYWOWANY</active> --- ten parametr nie może aktywować użytkownika bezpośrednio, dopóki użytkownik nie uaktywni się samodzielnie poprzez aktywacyjną wiadomość e-mail.
</bodyContent>
</body>
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>
</serv:body>
</serv:message>
Wpływające interfejsy API:
Kreator użytkownika
Ustawianie użytkownika
DelUser
Interfejs XML API obsługuje zgodność przekazywania uwierzytelniania istniejącego użytkownika po konwersji klasycznej witryny Webex na witrynę zarządzaną przez Control Hub
Interfejsy API, których dotyczy problem
Po konwersji klasycznej witryny Webex na witrynę zarządzaną przez Control Hub wartość <webExID> elementu w <securityContext> 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 stare webExID (Na przykład: Jack) i nowy webExID (zawartość jest taka sama jak w wiadomości e-mail, przykład: Jack@xx.com), aby się zalogować, ta kompatybilność wsteczna uwierzytelniania jest dla 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 wartość adresu e-mail do logowania.
<header>
<securityContext>
<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
<sessionTicket>xxxx</sessionTicket> lub <password> lub <webExAccessToken> lub <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
Wpływające interfejsy API:
Wszystkie interfejsy API XML.
Po przekształceniu klasycznej witryny Webex w witrynę zarządzaną przez Control Hub wartość <webExID> elementu <bodyContent> 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 stare webExId(np.: Jack) i nowe webExId (zawartość jest taka sama jak w wiadomości e-mail, na przykład: Jack@xx.com) w treści bodyContent.
Dla nowych użytkowników utworzonych w witrynach zarządzanych przez Control Hub wartość webExId element musi być taki sam jak adres e-mail w
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</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
</bodyContent>
Wpływające interfejsy API:GetUser
, SetUser
i DelUser
.
Zmiany schematu
Brak zmian schematu w interfejsach API.
Przykład żądania i odpowiedzi 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/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<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
<sessionTicket>xxxx</sessionTicket> lub <password> lub <webExAccessToken> lub <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- obecni 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
</bodyContent>
</body>
Przykład odpowiedzi API:
... taki sam jak wcześniej
Ulepszenie raportu historii widoku nagrania API do obsługi w Webex Meetings, Webex Events (nowy) i Webex Events (klasyczny)
Interfejsy API, których dotyczy problem
Bieżący API: lstrecordaccessHistory
oraz lstrecordaccessDetailHistory
obsługują tylko widok nagrań Webex Trainings z dostępem do raportu historii. Nowe ulepszenie obsługuje również widok historii dostępu do Webex Meetings, Webex Events (nowy) i Webex Events (klasyczny).
Zmiany schematu
Obsługujemy poniżej nowy schemat w API lstrecordaccessHistory w treści żądania API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Szczegóły
Interfejs API: lstrecordaccessHistory
umożliwia przywrócenie historii dostępu do widoku nagrania dla Webex Meetings, Webex Events (nowy), Webex Events (klasyczny) i Webex Trainings.
Jeśli nie Rodzaj usługi określone w żądaniu API, API
lstrecordaccessHistory
zwraca widok nagrania Webex Trainings tylko do historii dostępu.Gdy serviceType to MeetingCenter, API
lstrecordaccessHistory
zwraca historię dostępu zarówno do Webex Meetings, jak i Webex Events (nowy) widok nagrania.Kiedy Rodzaj usługi jest EventCenter, API
lstrecordaccessHistory
zwraca historię dostępu do 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 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>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>9/20/2021 00:00:00</viewTimeStart>
<viewTimeEnd>9/28/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1 1 1 1</startFrom>
<maximumNum>100 100 100</maximumNum>
</listControl>
<order>
<orderBy>NAGRYWANY</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</bodyContent>
</body>
</serv:message>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>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 0 0 0</history:registered>
<history:downloaded>2 2.</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>0 0 0 0</history:downloaded>
<history:viewed>3 3</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>0 0 0 0</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>0 0 0 0</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>1 1 1 1</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>1 1 1 1</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 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 0 0 0</history:registered>
<history:downloaded>1 1 1 1</history:downloaded>
<history:viewed>1 1 1 1</history:viewed>
<history:timeZoneID>20 20 20 20</history:timeZoneID>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8 8</serv:total>
<serv:returned>7 7</serv:returned>
<serv:startFrom>1 1 1 1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
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>
<body>
<bodyContent xsi:type="">
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20 20 20 20</timeZoneID>
</body>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>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>fałsz</history:registered>
<history:downloaded>fałsz</history:downloaded>
<history:viewed>prawdziwy</history:viewed>
<history:timeZoneID>20 20 20 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>fałsz</history:registered>
<history:downloaded>prawdziwy</history:downloaded>
<history:viewed>fałsz</history:viewed>
<history:timeZoneID>20 20 20 20</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2 2.</serv:total>
<serv:returned>2 2.</serv:returned>
<serv:startFrom>1 1 1 1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
Wpływające interfejsy API:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Usunąć lukę maksymalnej dozwolonej długości opisu Webex Events (Classic) między XMLAPI a Webex Page.
Interfejsy API, których dotyczy problem
API XML : Element CreateEvent i SetEvent opis umożliwi wprowadzenie maksymalnie 10000 znaków, jeśli wprowadzona zostanie wielkość ponad, spowoduje to podanie nowego kodu błędu i komunikatu:
060068 Nielegalny opis danych wejściowych. Ten opis nie może przekraczać 10 000 znaków.
Zmiany schematu
Brak zmian w schemacie.
Przykład żądania i odpowiedzi API
Żądanie interfejsu API CreateEvent i odpowiedź
Przykład żądania #API:
...
<body>
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
xmlns:att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service/eventhttp://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>EC test</sessionName>
<description>.......Załóżmy, że wypełnisz 10000 znaków w opisie.......</description>
</metaData>
...
Przykład odpowiedzi ------------------------------------
#API, gdy opis przekracza 10 000 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:header>
<serv:response>
<serv:result>NIEPOWODZENIE</serv:result>
<serv:reason>Nielegalny opis danych wejściowych. Opis nie może przekraczać 10 000 znaków</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
Wpływające interfejsy API:
CreateEvent
SetEvent
API XML : GetUser zwraca nowy element freeAccount
Interfejsy API, których dotyczy problem
GetUser
zwraca nowy element identyfikujący freeAccount
konto użytkownika to FreeAccount
lub nie.
Zmiany schematu
Przykład odpowiedzi użytkownika GetUser
Odpowiedź użytkownika Get:
<use:initials>AW</use:initials>
<use:isUploaded>fałszywy</use:isUploaded>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>fałszywy</use:freeAccount>
Wpływające interfejsy API:
GetUser
Aktualizacja interfejsu API 41.10.0
W schemacie XML API 41.10.0 nie ma zmian schematu. |
Aktualizacja interfejsu API 41.9.0
Aktualizacje interfejsu API XML 41.9.0
Decommission XML API 10.0.0 dla wszystkich witryn T31
Webex planuje zakończenie okresu eksploatacji obsługuje interfejs XML API ver 10.0.0 dla wszystkich witryn T31.
Wycofujemy kod XML API 10.0.0 ze wszystkich produkcji w aktualizacji 41.9.0.
Aktualizacja interfejsu API 41.8.0
Aktualizacje interfejsu API XML 41.8.0
Decommission XML API 10.0.0 dla wszystkich witryn T31
Webex planuje zakończenie okresu eksploatacji obsługuje interfejs XML API ver 10.0.0 dla wszystkich witryn T31.
Webex znalazł klienta klienta korzystającego z adresu URL interfejsu XML API w niepoprawny sposób, np.: 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://{siteName}.webex.com/WBXService/XMLService.
Przełącz swój dostęp do kodu API XML w odpowiedni sposób, aby uniknąć wpływu przed zakończeniem obsługi przez całe życie na XML API w wersji 10.0.0.
Aktualizacja interfejsu API 41.7.0
Aktualizacje interfejsu API XML 41.7.0
Telefony do usuwania i edytowania nagrania powinny być kontrolowane za pomocą opcji administrowania witryną: Zezwalaj prowadzącym na ponowne przypisywanie, edytowanie, wyłączanie i usuwanie nagrań
Zmiany dotyczące interfejsów API i schematu
GetSite
: zwróci nowe elementy z nazwą 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>fałszywa</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>prawda</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Aktualizacja interfejsu API 41.6.3
Aktualizacje interfejsu API XML 41.6.3
GetSite
Odpowiedź nowy element supportLargeEvent
Zmiany dotyczące interfejsów API i schematu
GetSite: zwraca nowe elementy nazewnictwa supportLargeEvent
w obszarze siteCommonOptions
informowanie 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>fałszywa</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>prawda</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Aktualizacje interfejsu API 41.6.0
Aktualizacje interfejsu API XML 41.6.0
XMLAPI obsługuje usługę Webex Events 2.0 w inicjowaniu obsługi administracyjnej
Interfejsy API, których dotyczy problem
GetUser
: zwraca nowy element nazwy largeEventCapacity
która pokazuje pojemność nowego wydarzenia 2.0 (EC 2.0) na tym koncie użytkownika. Na przykład, jeśli konto użytkownika ma licencję CI_EC3K, wartość largeEventCapacity
jest 3000.
Zmiany schematu
Przykład odpowiedzi
GetUserResponse:
XMLAPI LstRecording's CreateTime stosuje czas rozpoczęcia nagrywania
Interfejsy API, których dotyczy problem
LstRecording
: LstRecording
odpowiedź CreateTime
jako czas, w którym użytkownik faktycznie naciśnie przycisk rekordu.
Szczegóły
W przeszłości API XML używało znacznika czasu, gdy nagranie zostało utworzone w bazie danych jako czasu tworzenia w LstRecording
odpowiedź. Teraz użytkownik zaczyna nagrywać. Ta zmiana dotyczy wszystkich nagrań serwisowych. Nie ma zmiany schematu.
Aktualizacje interfejsu API 41.5.0
Aktualizacje interfejsu API XML 41.5.0
XMLAPI ma możliwość uruchamiania zaplanowanych spotkań Webex z PSTN jako gospodarz
Interfejsy API, których dotyczy problem
CreateUser
: generujehostPIN
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
: zestawyhostPIN
korzystaniephones.hostPIN
kiedypersonalMeetingRoom.hostPIN
nie jest w żądaniu XML (warunek wstępny: przełącznik funkcjiAllowStartScheduledMtgFromPhone
jest włączona).GetUser
: zwrotyphones.hostPIN
niezależnie od tego, czy PMR użytkownika jest włączony, czy nie. (warunek wstępny: przełącznik funkcjiAllowStartScheduledMtgFromPhone
jest włączona).
Zmiany schematu
GetUserResponse
:
SetUser
:
Przykład odpowiedzi
GetUserResponse
:
SetUser
:
XMLAPI GetSite
odpowiedź na dwa nowe elementy dla klienta mobilnego
Interfejsy API, których dotyczy problem
GetSite
:GetSite
będzie teraz odpowiedzieć na dwa nowe elementy, aby obsługiwać klienta mobilnego ma logikę do wyświetlania lub nie wyświetlać kartę nagrywania.enableRecordingAccess
: prawdziwe lub fałszywe, super administratorzy Webex mogą włączyć lub wyłączyć dostęp do nagrywania za pomocą przełącznika(EnableRecordingAccesses
).storageEmptyStatus
: prawda lub fałsz, jeśli obie strony nie obsługują funkcji NBR i przydzieliły miejsce do przechowywania NBR jako zero, wtedy odpowiedź stanu jest prawdziwa, inaczej jest fałszywa.
Zmiany schematu
Przykładowe żądanie dla GetSite
Przykładowa odpowiedź dla Getsite
Temat wiadomości e-mail zawierający znaki inne niż ASCII zostanie zakodowany w formacie RFC2047. W przypadku czystego tematu wiadomości e-mail o charakterze ASCII nie ma kodowania
Interfejsy API, których dotyczy problemNie ma żadnego wpływu na żądanie API, obciążenie odpowiedzi, ale zmienia zachowanie kodowania adresu e-mail. Gdy podmiot wiadomości e-mail, który ma znaki inne niż ASCII, zostanie zakodowany RFC2047. W przypadku czystego tematu e-mail postaci ASCII, nie ma kodowania.
Zmiany schematu
Nie ma zmian w schemacie.
Aktualizacje interfejsu API 41.4.0
Aktualizacje interfejsu API XML 41.4.0
Utwórz zaplanowane wydarzenie Webex Events może wykorzystać domyślne ustawienie poziomu witryny na poziomie wejścia i wyjścia
XMLAPI dostosowuje się do aktualnej nowej logiki sterowania dźwiękiem 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 ustawia domyślne ustawienie sygnału dźwiękowego, utworzenie zdarzenia nie spowoduje wykorzystania tego ustawienia przez zastosowanie domyślnego interfejsu XMLAPI.
Interfejsy API, których dotyczy problem
API XML : GetSite zwraca jeden nowy element entryExitToneEC
aby wskazać wartość.
API XML : CreateEvent, SetEvent, GetEvent back end logika biznesowa odczytuje wartość entryExitToneEC
.
Zmiany schematu
API XML : Próbka odpowiedzi GetSite:
<ns1:defaults>
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>ANNOUNCENAMY</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NIKT</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
Wpływające interfejsy API:
GetSite
Utwórz zdarzenie
SetEvent
GetEvent
XMLAPI zwraca informacje szczegółowe o dużym zdarzeniu (Webex Event 2.0)
Jeśli spotkanie Webex jest dużym wydarzeniem lub webcastem,
GetSessionInfo
zwraca kilka szczegółowych informacji, w tym hasło 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
orazSetMeeting
zwróć 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, | Nie należy zmieniać schematu. |
| Jeśli użytkownik próbuje użyć | Zachowanie należy zmienić. |
Aktualizacje interfejsu API 41.3.0
Aktualizacje interfejsu API XML 41.3.0
Nowe zmiany interfejsu API XML obsługują funkcję Webex Events 2.0
Interfejsy API, których dotyczy problem
Oba interfejsy API: Elementy zwrotu GetSessionInfo i GetMeeting enableEvent
oraz enableWebniar
Też.
Nazwa elementu | Opis |
---|---|
enableEvent | Obsługuje EC 2.0 podczas spotkania Webex |
enableWebniar | Obsługuje webinarium podczas spotkania Webex |
Obsługa XMLAPI zwraca 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
oraz enableWebniar
dla EC 2.0.
GetMeeting
zwraca elementy enableEvent
oraz enableWebniar
dla EC 2.0.
Próbka odpowiedzi:
GetSessionInfo
odpowiedź:
<ep:accessControl>
<ep:listStatus>PUBLICZNE</ep:listStatus>
<ep:registration>fałszywe</ep:registration>
<ep:passwordReq>prawdziwe</ep:passwordReq>
<ep:isEnforceAudioPassword>fałszywe</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>fałszywe</ep:isEnforceAudioLogin>
<ep:enableEvent>fałszywe</ep:enableEvent>
<ep:enableWebniar>fałszywe</ep:enableWebniar>
<ep:enablePreMeetingLobby>prawdziwe</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
odpowiedź:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>true</meet:HQvideo>
<meet:HDvideo>true</meet:HDvideo>
<meet:viewVideoThumbs>true</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
Nowe zmiany XMLAPI obsługują funkcję poczekalni przed spotkaniem
Interfejsy API, których dotyczy problem
API XML : GetSite
, LstSummarySession
, GetSessionInfo
i GetMeeting
zareaguje na nowy element enablePreMeetingLobby
w poczekalni przed spotkaniem.
Zmiany schematu
API XML : GetSite
element zwrotny enablePreMeetingLobby
w poczekalni przed spotkaniem.
API XML : LstSummarySession
element zwrotny enablePreMeetingLobby
w poczekalni przed spotkaniem.
API XML : GetSessionInfo
element zwrotny enablePreMeetingLobby
w poczekalni przed spotkaniem.
API XML : GetMeeting
element zwrotny enablePreMeetingLobby
w poczekalni przed spotkaniem.
Próbka odpowiedzi:
GetSite
odpowiedź:
<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:SupportXMLAPIReturnScheduledPMR>false</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>true</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>true</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
odpowiedź:
<ep:isException>fałszywy</ep:isException>
<ep:isNextUpcomingInstance>prawdziwy</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>fałszywy</ep:isScheduledPMR>
<ep:enableEvent>fałszywy</ep:enableEvent>
<ep:enableWebniar>fałszywy</ep:enableWebniar>
<ep:enablePreMeetingLobby>prawdziwy</ep:enablePreMeetingLobby>
GetSessionInfo
odpowiedź:
<ep:accessControl>
<ep:listStatus>PUBLICZNE</ep:listStatus>
<ep:registration>fałszywe</ep:registration>
<ep:passwordReq>prawdziwe</ep:passwordReq>
<ep:isEnforceAudioPassword>fałszywe</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>fałszywe</ep:isEnforceAudioLogin>
<ep:enableEvent>fałszywe</ep:enableEvent>
<ep:enableWebniar>fałszywe</ep:enableWebniar>
<ep:enablePreMeetingLobby>prawdziwe</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
odpowiedź:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>true</meet:HQvideo>
<meet:HDvideo>true</meet:HDvideo>
<meet:viewVideoThumbs>true</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
Interfejs API XML GetSite
ujawnij zmianę zachowania informacji
Interfejsy API, których dotyczy problem
API XML : GetSite
tylko odpowiedzi poniżej elementów konta administratora, które obejmują role: SiteAdmin
, RO_SiteAdmin
i UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Zmienione zachowanie
Zezwalaj tylko roli administratora na dane licencyjne odpowiedzi GetSite
. Prowadzący lub uczestnik nie otrzyma tych danych licencyjnych w GetSite
odpowiedź.
Poniżej znajdują się API: GetSite's
przykład odpowiedzi dla siteadmin
lub tylko gotowy siteadmin
lub administrator zarządzania użytkownikami:
Aktualizacje interfejsu API 41.2.0
Aktualizacje interfejsu API XML 41.2.0
XMLAPI powinien obsługiwać „CMR Hybrid VOIP”, jeśli witryna obsługuje telefonię Webex
Interfejsy API, których dotyczy problem
GetSite
zwraca nowy elementIsWebexTelephony
w odpowiedzi.CreateUser
orazSetUser
może zaktualizowaćcmrHybridVoip
element, jeśliIsWebexTelephony
jest prawdą wraz z innymi warunkami.IsTSPUsingTelephonyAPI
nie ma już konsekwencji.
Zmiany schematu
API XML : GetSite
odpowiedź zwraca dodatkowy element IsWebexTelephony
GetSite
odpowiedź zawiera ten nowy element:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Personal Conference No.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Kod dostępu uczestnika</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Kod dostępu prowadzącego</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Identyfikator uczestnika</ns1:attendeeIDLabel>
....
</ns1:telephonyConfig>
LstSummarySession
obsługuje EC2.0
Interfejsy API XML mają wpływ na
LstSummarySession
zwrócą nowe dwa elementy w celu wsparcia EC 2.0
Nazwa elementu | Opis |
---|---|
enableEvent | Obsługuje EC 2.0 podczas spotkania Webex |
enableWebniar | Obsługuje webinarium podczas spotkania Webex |
Zmiany schematu
API XML : LstSummarySession
: Dołącz do < enableEvent
> i < enableWebniar
> elementy
Odpowiedź interfejsu API XML: LstSummarySession
Odpowiedź dla EC 2.0
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>false</ep:isScheduledPMR>
<ep:enableEvent>true</ep:enableEvent>
<ep:enableWebniar>true</ep:enableWebniar>
XMLAPI obsługuje powrót użytkownika witryny Webex-voice-assistant
opcja integracji MCT
Dotknięty interfejs API
GetUser
zwraca nowy element webexAssistantEnabled
(prawdziwe lub fałszywe) w odpowiedzi.
Zmiany schematu
getUserResponse
:
Przykład odpowiedzi
Aktualizacja interfejsu API 41.1.0
W schemacie XML API 41.1 nie ma zmian schematu. |