- Domov
- /
- Článok
Prehľad aktualizácií rozhrania API Cisco Webex Meetings (API 41)
Nájdite všetky dôležité informácie, ktoré potrebujete o Cisco Webex Meetings API, ako sú zmeny schémy a iné oznámenia.
Viac informácií o XML API 39 a XML API 11 nájdete v Prehľade aktualizácií rozhrania XML API Cisco Webex Meetings (XML API 39 a staršie).
Ďalšie informácie o XML API 40 nájdete v Prehľade aktualizácií rozhrania XML API Cisco Webex Meetings (XML API 40 a novšie).
Aktualizácie pre rozhranie XML API 11 SP9 a staršie nájdete na stránke Cisco DevNet.
Aktualizácie API 41.12.0
Aktualizácie XML API 41.12.0
XMLAPI zablokuje plán a úpravy Webex Events (Classic) podľa položky konfigurácie lokality EnableClassicEvent
, ktorá je nepravdivá
Ovplyvnené zmeny API a schém
Ak je na konfiguračnej stránke správy lokality začiarkavacie políčko Povoliť klasickú udalosť nepravdivé, táto lokalita už nebude podporovať schôdze Webex Events (klasické).
Ak je začiarkavacie políčko Povoliť classicEvent nepravdivé, na ovládanie schôdze Webex Events (klasické) zavoláte tieto rozhrania API:
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram, UploadEventImage
Rozhranie API odpovie na novú výnimku 010106 Klasická udalosť bola zakázaná.
Zmeny schémy
Žiadne zmeny schémy.
Príklad žiadosti a odpovede API
Žiadosť a odpoveď rozhrania API CreateEvent
Požiadavka na CreateEvent
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
< metaData>
<sessionName>Testovanie XMLAPI EC</sessionName>
<schedule>
<startDate>07/17/2021 01:29:15</startDate> <openTime>15</openTime>
</schedule>
</bodyContent>
Reakcia 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>ZLYHANIE</serv:result>
<serv:reason>Klasická udalosť bola zakázaná.</serv:reason>
<serv:gsbStatus>PRIMÁRNE</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv :body>
<serv:bodyContent/>
</serv:body>
CreateEvent3.1.3 ovplyvňuje rozhrania API:
-
SetEvent GetEvent
-
GetSessionInfo
-
LstsummaryEvent
-
LstrecordedEvent
-
LstsummaryProgram
-
UploadEventImage
XMLAPI LstMeetingType
odpovie na nový prvok subProductCodePrefix
Ovplyvnené rozhrania API
Aktuálny prvok odpovede rozhrania API LstMeetingType
prvku productionCodePrefix
: PRO, AUO a ďalšie, ktoré sú preddefinované Webex, spĺňajú predponu typu.
Po tomto novom vylepšení bude rozhranie API reagovať na nový prvok subProdctCodePrefix
:PRO1, PRO2 atď., ktorý je možné prispôsobiť podľa predpony typu.
Zmeny schémy na rozhraní API: LstMeetingType
Bude reagovať na nový prvok: subProdctCodePrefix
Príklad žiadosti a odpovede API
Žiadosť a odpoveď rozhrania API LstMeetingType
Žiadosť o LstMeetingType
13810
Odpoveď 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:meetingType>
< mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Nový prvok pre prispôsobený typ stretnutia
<mtgtype:active>AKTIVOVANÉ</mtgtype:active> <mtgtype:name>Cus_Chat_Zatvorené</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Zatvorené</mtgtype:displayName>
Aktualizácie API 41.11.0
Aktualizácie XML API 41.11.0
XML API podporuje doprednú kompatibilitu v používateľskom rozhraní API pre lokality spravované Control Hub
Ovplyvnené zmeny API a schém
Ak vaša integračná aplikácia momentálne používa rozhrania API na správu používateľov Webex XMLAPI: CreateUser
, SetUser
, DelUser
a GetUser
na poskytovanie alebo správu používateľov po konverzii vašej klasickej lokality Webex na lokalitu spravovanú Control Hub, tieto rozhrania API budú aj naďalej pracovať na doprednej kompatibilite. Existuje niekoľko zmien správania, ako je uvedené nižšie:
-
Pri použití funkcie createUser – ak stav používateľa v Control Hub nie je „aktívny“, potom stav používateľa na stránke nebude aktívny. Ak je stav používateľa v Control Hub aktívny, potom je aktívny aj stav používateľa na lokalite, pozrite si: Používateľský stav nových a konvertovaných používateľov v Control Hub.
-
Prvok heslo rozhraní API CreateUser a SetUser bude ignorovaný, novým používateľom začneme posielať aktivačný e-mail, používatelia môžu kliknutím na odkaz v e-maile aktivovať nový účet a zadať nové heslo.
-
Aktívny prvok rozhrania CreateUser API bude ignorovaný, nového používateľa (neoverený) nie je možné aktivovať pomocou tohto parametra pomocou rozhrania API Nastaviť používateľa.
-
Hodnota prvku webExId v bodyContent rozhraní API CreateUser musí byť rovnaká ako hodnota e-mailu. Ak sa webExId líši od e-mailu, pri ukladaní do WebDB budeme s webExId zaobchádzať rovnako ako s e-mailom a hodnota sa bude ignorovať.
-
Hodnota prvku webExId v prvku bodyContent rozhraní API SetUser musí byť identita používateľa alebo e-mailová adresa. Môžete ju zmeniť pomocou <email> v časti bodyContent.
-
Rozhranie API SetUser bude podporovať zmenu existujúceho e-mailu používateľa: je úspešná, ak je operačný účet v SecurityContext úplný správca lokality Control Hub. V opačnom prípade API hlási chybu s novým kódom chyby a správou nižšie:
-
030120 Ak chcete zmeniť e-mail, účet musí byť úplným správcom lokality.
-
Prvok newWebExId v časti bodyContent rozhrania SetUser API bude ignorovaný.
-
Rozhranie API SetUser sa pokúša zmeniť na e-mail, ktorý sa už používa. Rozhranie API nižšie zobrazí nový chybový kód a chybové hlásenie:
-
030118 E-mail sa už používa na lokalitách spravovaných Control Hub.
-
Rozhranie API DelUser deaktivuje používateľa na strane schôdze Webex a príslušná licencia na schôdzu sa odstráni z lokality Webex. Tento deaktivovaný používateľ môže byť znovu aktivovaný pomocou API: Nastaviť používateľa (AKTIVOVANÉ), pokiaľ je používateľ predtým overený.
-
Rozhrania API CreateUser a SetUser vyvolávajú nový chybový kód a chybové hlásenie, ako je uvedené nižšie:
-
030117, Tento používateľ existuje mimo vašej organizácie, a preto si musí byť nárokovaný, aby ste sa mohli presunúť do vašej organizácie prostredníctvom procesu nárokovania používateľa. Kroky na získanie používateľa vo vašej organizácii nájdete v časti Nárokovanie používateľov do vašej organizácie (konvertovať používateľov). Pred nárokovaním používateľa budete musieť overiť doménu, do ktorej používateľ patrí.
-
030119 Prístupový token CI musí zahŕňať rozsah webexsquare: admin pri poskytovaní používateľov.
Dopredná kompatibilita je podporovaná len na obmedzené obdobie. Pred odstránením tejto kompatibility vás vopred upozorníme.
Zmeny schémy
Žiadne zmeny schémy na týchto rozhraniach API: CreateUser
, SetUser
, DelUser
a GetUser
.
Príklad žiadosti a odpovede API
Žiadosť a odpoveď rozhrania API CreateUser
Požiadavka 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="<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{správca lokality účet}</webExID>
<email>{účet správcu stránky}</email>
<sessionTicket>xxxx</sessionTicket> alebo alebo
alebo , keď používate CI „accessToken“, musí pri poskytovaní používateľov zahŕňať rozsah webexsquare:admin
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@ qa.webex.com</webExId> --- mala by to byť identita používateľa e-mailovej adresy
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>....</password>
<privilege>
<host>true</host>
</privilege>
<active>ACTIVATED</active> ---tento parameter nemôže aktivovať používateľa priamo, kým sa používateľ sám neaktivuje aktiváciou e-mail.
</bodyContent>
</body>
Príklad odpovede rozhrania 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>ÚSPECH</serv:result>
<serv:gsbStatus>PRIMÁRNE</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>
http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
Ovplyvniť rozhrania API:
-
CreateUser
-
SetUser
-
DelUser
XML API podporuje doprednú kompatibilitu overenia existujúceho používateľa po konverzii klasickej lokality Webex na lokalitu spravovanú Control Hub
Ovplyvnené rozhrania API
Po konverzii klasickej lokality Webex na lokalitu spravovanú Control Hub musí byť hodnota prvku v rovnaká ako e-mail, podrobnosti sú uvedené nižšie:
-
Pre existujúcich používateľov vytvorených na klasickej stránke Webex podporujeme staré webExID (Napríklad: Jack) a nové webExID (obsah je rovnaký ako e-mail, príklad: Jack@xx.com) na prihlásenie, táto spätná kompatibilita overovania je pre všetky XML API.
-
Pre nových používateľov vytvorených na spravovaných lokalitách Control Hub musí byť hodnota prvku webExID rovnaká ako e-mail na prihlásenie.
{siteName}
{userName} --- existujúce používatelia boli vytvorení na klasickej stránke webEx, môže to byť: jack alebo jack@xx.com; nový používateľ musí použiť jack@xx.com
xxxx alebo alebo alebo
Ovplyvniť rozhrania API:
Všetky XML API.
Po konverzii klasickej lokality Webex na lokalitu spravovanú Control Hub musí byť hodnota prvku <bodyContent> rovnaká ako e-mail, podrobnosti sú uvedené nižšie:
-
Pre existujúcich používateľov vytvorených na klasickej stránke Webex podporujeme staré webExId (napr.: Jack) a nový webExId (obsah je rovnaký ako e-mail, napríklad: Jack@xx.com) v bodyContent.
-
Pre nových používateľov vytvorených na stránkach spravovaných Control Hub musí byť hodnota prvku webExId rovnaká ako hodnota e-mailu v bodyContent
.
xxxx --- existujúci používatelia boli vytvorení na klasickej stránke webEx, môže byť: jack alebo jack@xx.com; nový používateľ musí použiť adresu jack@xx.com
Ovplyvniť rozhrania API: GetUser
, SetUser
a DelUser
.
Zmeny schémy
Žiadne zmeny schémy na žiadnom rozhraní API.
Príklad žiadosti a odpovede API
Žiadosť a odpoveď rozhrania API GetUser
Požiadavka 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="
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- existujúci používatelia boli vytvorené na klasickej stránke webEx, môže to byť:http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
jack alebo jack@xx.com; nový používateľ musí použiť adresu jack@xx.com
<sessionTicket>xxxx</sessionTicket> alebo alebo alebo
< body>
<webExId>xxxx</webExId> --- existujúci používatelia boli vytvorení v klasická stránka webEx, môže to byť: jack alebo jack@xx.com; nový používateľ musí použiť adresu jack@xx.com
Príklad odpovede rozhrania API:
...rovnaké ako predtým
Rozhranie API na vylepšenie záznamu histórie zobrazení na podporu pri Webex Meetings, Webex Events (nové) a Webex Events (Classic)
Ovplyvnené rozhrania API
Aktuálne API: lstrecordaccessHistory
a lstrecordaccessDetailHistory
podporujú iba záznam histórie prístupov zo školenia Webex. Nové vylepšenie podporuje aj záznamy schôdzí Webex, Webex Events (nové) a Webex Events (klasické) s prístupom k histórii.
Zmeny schémy
Podporujeme nižšie uvedenú novú schému do API lstrecordaccessHistory v tele žiadosti API:
MeetingCenter
TrainingCenter
EventCenter
Podrobnosti
API: lstrecordaccessHistory
dokáže vrátiť históriu prístupov k záznamom pre stretnutia Webex, udalosti Webex (nové), udalosti Webex (klasické) a školenia Webex.
-
Ak v požiadavke rozhrania API nie je zadaný žiadny serviceType , rozhranie API funkcie lstrecordaccessHistory
vráti iba históriu prístupu k záznamu zo záznamu Webex Trainings.
-
Keď je serviceType MeetingCenter, rozhranie API funkcie lstrecordaccessHistory
vracia históriu prístupu k záznamom schôdzí Webex aj Webex Events (nové).
-
Keď je serviceType EventCenter, rozhranie API funkcie lstrecordaccessHistory
vráti históriu prístupu k záznamom udalostí Webex (klasické).
API: lstrecordaccessDetailHistory
dokáže vrátiť podrobnosti podľa recordID
stretnutí Webex, udalostí Webex (nové), udalostí Webex (klasické) a školení Webex.
Príklad žiadosti a odpovede API
Požiadavka a odpoveď rozhrania API lstrecordaccessHistory
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<webExID>{meno používateľa</webExID>
<password>{heslo}</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>28. 9. 2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom> 1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy>RECORDID</orderBy>
<orderAD>ASC</orderAD >
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</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>ÚSPECH
<serv:gsbStatus>PRIMÁRNE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv :bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTCHistory -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:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>TestErollment_001-20210610 1905-1
<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 okamžitého prehrávania 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>
<história: zobrazené>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>LstrecordaccessHistory test 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>LstrecordaccessHistory test MC- 20210924 1319-1</history:recordName>
<history:creationTime>24.09.2021 13:25:12</history:creationTime>
<history:registered>0</history:registered> <history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history :recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test EC classic-202109241331-1 107} <history:creationTime>24.09.2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history :downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</serv:bodyContent>
</serv:body>
Požiadavka a odpoveď rozhrania 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">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{heslo}</password>
<siteName>{siteName}</siteName> </securityContext>
</header>
<body>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
< recondID>1XXXXXX7
<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>ÚSPECH</serv:result>
<serv:gsbStatus>PRIMÁRNE</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:zobrazené >true</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</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>pravda</history:downloaded>
<história :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>
</serv:body>
Ovplyvniť rozhrania API:
-
lstrecordaccessHistória
-
lstrecordaccessDetailHistory
Opravte medzeru v maximálnej povolenej dĺžke popisu udalostí Webex (Classic) medzi XMLAPI a Webex Page.
Ovplyvnené rozhrania API
XML API: Element descriptionCreateEvent a SetEvent povolí zadanie maximálne 10 000 znakov. Ak bude zadávanie nadmernej veľkosti, bude to mať za následok nový chybový kód a hlásenie:
060068 Neplatný popis vstupu. Tento popis nemôže presiahnuť 10 000 znakov.
Zmeny schémy
Žiadna zmena schémy.
Príklad žiadosti a odpovede API
Žiadosť a odpoveď rozhrania API CreateEvent
#Príklad žiadosti API:
...
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent"
xmlns:att=" 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>SÚKROMNÉ</listing>
</accessControl>
<metaData> <sessionName>test EC</sessionName>
<description>.......Predpokladajme, že vyplníte 10 000 znakov v popise.......</description>
</metaData>...
-------------------------------------<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>FAILURE</serv:result>
Neplatný popis vstupu.http://www.webex.com/schemas/2002/06/service/event"
Popis nemôže presiahnuť 10 000 znakov
PRIMÁRNE
060068
Ovplyvniť rozhrania API:
-
CreateEvent
-
SetEvent
XML API: GetUser vracia nový prvok freeAccount
Ovplyvnené rozhrania API
GetUser
vráti nový prvok, ktorý identifikujefreeAccount
, či je používateľský účet FreeAccount
alebo nie.
Zmeny schémy
Príklad odpovede GetUser
Odpoveď GetUser:
<use:initials>AW</use:initials>
<use:isUploaded>false</use:isUploaded>
<use :largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>false</use:freeAccount>
Ovplyvniť rozhrania API:
GetUser
Aktualizácie API 41.10.0
V schéme XML API 41.10.0 nie sú žiadne zmeny schémy.
Aktualizácie API 41.9.0
Aktualizácie XML API 41.9.0
Decommission XML API 10.0.0 pre všetky lokality T31
Webex plánuje ukončiť podporu XML API ver. 10.0.0 pre všetky stránky T31.
V aktualizácii 41.9.0 vyraďujeme kód XML API 10.0.0 zo všetkých produkcií.
Aktualizácie API 41.8.0
Aktualizácie XML API 41.8.0
Decommission XML API 10.0.0 pre všetky lokality T31
Webex plánuje ukončiť podporu XML API ver. 10.0.0 pre všetky stránky T31.
Webex zistil, že niektorí zákazníci pristupujú k URL XML API nesprávnym spôsobom ako: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, správny spôsob prístupu k adrese URL rozhrania API XML ako: https://{názov stránky}.webex.com/WBXService/XMLService.
Zmeňte, prosím, svoj kód XML API na prístup správnym spôsobom, aby ste sa vyhli dopadu pred ukončením podpory XML API verzie 10.0.0.
Aktualizácie API 41.7.0
Aktualizácie XML API 41.7.0
Mobilné mazanie a úprava záznamu by mala byť riadená možnosťou správy stránky: Umožnite hostiteľom zmeniť priradenie, upraviť, zakázať a odstrániť nahrávky
Ovplyvnené zmeny API a schém
GetSite
: vráti nové prvky s názvom enableNBRMCModify
a separateNoRecordingEdit
pod nástrojmi.
Príklad odpovede
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>ÚSPECH</serv:result>
<serv:gsbStatus>PRIMÁRNE</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>
Aktualizácie API 41.6.3
Aktualizácie XML API 41.6.3
GetSite
Response nový prvok supportLargeEvent
Ovplyvnené zmeny API a schém
GetSite: vráti nové prvky s názvom supportLargeEvent
v časti siteCommonOptions
, aby volajúci vedel, či stránka podporuje veľkú udalosť (Webex Event (nové)) alebo nie.
Zmena schémy
Príklad odpovede
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>ÚSPECH</serv:result>
<serv:gsbStatus>PRIMÁRNE</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>pravda</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
Aktualizácie API 41.6.0
Aktualizácie XML API 41.6.0
XMLAPI podporuje Webex Events 2.0 pri poskytovaní
Ovplyvnené rozhrania API
GetUser
: vráti nový prvok s názvom largeEventCapacity
, ktorý zobrazuje kapacitu novej udalosti 2.0 (EC 2.0) pod týmto používateľským účtom. Ak má používateľský účet napríklad licenciu CI_EC3K, hodnota largeEventCapacity
je 3 000.
Zmeny schémy
Príklad odpovede
GetUserResponse:
CreateTime XMLAPI LstRecording aplikuje čas začiatku nahrávania
Ovplyvnené rozhrania API
LstRecording
: Odpoveď LstRecording
CreateTime
ako čas, kedy používateľ skutočne stlačí tlačidlo záznamu.
Podrobnosti
V minulosti používalo XML API ako čas vytvorenia v odpovedi LstRecording
časovú pečiatku, kedy bol záznam vytvorený v databáze. Teraz je čas, kedy užívateľ skutočne začne nahrávať. Táto zmena sa týka všetkých servisných nahrávok. Nedochádza k žiadnej zmene schémy.
Aktualizácie API 41.5.0
Aktualizácie XML API 41.5.0
XMLAPI má schopnosť spúšťať plánované stretnutia Webex z PSTN ako hostiteľa
Ovplyvnené rozhrania API
-
Vytvoriť používateľa
: generuje hostPIN
bez ohľadu na to, či je PMR používateľa povolené alebo nie, keď je rola používateľa hostiteľ alebo úplná alebo iba na čítanie alebo správcovia stránok na správu používateľov.
-
Nastaviť používateľa
: nastaví hostPIN
pomocou phones.hostPIN
, keď personalMeetingRoom.hostPIN
nie je v požiadavke XML (predpoklad: prepínač funkcií AllowStartScheduledMtgFromPhone
je povolený).
-
GetUser
: vráti phones.hostPIN
bez ohľadu na to, či je PMR používateľa povolené alebo nie. (predpoklad: prepínač funkcií AllowStartScheduledMtgFromPhone
je povolený).
Zmeny schémy
GetUserResponse:
Nastaviť používateľa
:
Príklad odpovede
GetUserResponse:
Nastaviť používateľa
:
XMLAPI GetSite
odozva dva nové prvky pre mobilného klienta
Ovplyvnené rozhrania API
-
GetSite
: Služba GetSite
bude teraz reagovať na dva nové prvky, aby podporila mobilného klienta, ktorý má logiku zobrazovať alebo nezobrazovať kartu záznamu.
-
enableRecordingAccess
: pravda alebo nepravda, supersprávcovia Webex môžu povoliť alebo zakázať prístup k nahrávaniu pomocou prepínača (EnableRecordingAccesses
).
-
storageEmptyStatus
: pravda alebo nepravda, ak obe lokality nepodporujú funkciu NBR a pridelili úložný priestor NBR ako nulu, potom je odpoveď stavu pravdivá, v opačnom prípade je nepravda.
Zmeny schémy
Vzorová žiadosť o GetSite
Vzorová odpoveď pre Getssite
Predmet e-mailu, ktorý má iné znaky ako ASCII, bude zakódovaný pomocou RFC2047. V prípade predmetu e-mailu s čistým znakom ASCII neexistuje žiadne kódovanie
Ovplyvnené rozhrania API Nemá to žiadny vplyv na žiadnu požiadavku API, obsah odpovedí, ale mení to správanie kódovania predmetu e-mailu. Keď predmet e-mailu, ktorý má iné znaky ako ASCII, bude zakódovaný pomocou RFC2047. V prípade predmetu e-mailu s čistým znakom ASCII neexistuje žiadne kódovanie.
Zmeny schémy
Neexistujú žiadne zmeny schémy.
Aktualizácie API 41.4.0
Aktualizácie XML API 41.4.0
Vytvoriť udalosť naplánovanú Webex Events môže využiť predvolené nastavenie na úrovni lokality pri vstupnom a výstupnom tóne
XMLAPI je v súlade so súčasnou novou logikou ovládania vstupného a výstupného tónu. Všetky tóny pre Webex Events boli riadené iným nastavením v administrácii stránky. V GetSite
vracia XMLAPI ďalšie pole entryExitToneEC
na označenie hodnoty. Pôvodne, keď správca lokality nastavil predvolený tón, vytvorenie udalosti nevyužije toto nastavenie použitím predvoleného nastavenia XMLAPI.
Ovplyvnené rozhrania API
XML API: GetSite vráti jeden nový prvok entryExitToneEC
na označenie hodnoty.
XML API: Koncová obchodná logika CreateEvent, SetEvent, GetEvent číta hodnotu entryExitToneEC
.
Zmeny schémy
XML API: Príklad odpovede GetSite:
pravda
ANNOUNCENAME
NOTONE
pravda
ŽIADNE
pravda
false
Ovplyvniť rozhrania API:
-
GetSite
-
CreateEvent
-
SetEvent
-
GetEvent
XMLAPI len vráti podrobné informácie o veľkej udalosti (Webex Event 2.0).
-
Ak je schôdza Webex veľká udalosť alebo webové vysielanie, funkcia GetSessionInfo
vráti niektoré podrobné informácie vrátane hesla stretnutia, číselného hesla stretnutia, hesla člena panelu a číselného hesla člena panelu (žiadna schéma sa nemení).
-
XMLAPI nepodporuje vytváranie a úpravu žiadnej veľkej udalosti alebo funkcie webového vysielania, takže funkcie CreateMeeting
a SetMeeting
vrátia novú výnimku (110064, Udalosť a typ relácie webového vysielania nie sú podporované.) pre prípad veľkej udalosti alebo webového vysielania.
Impact API
Názov API
Opis
Poznámka
GetSessionInfo
Ak je schôdza Webex veľká udalosť alebo webové vysielanie, funkcia GetSessionInfo
vráti heslo stretnutia, číselné heslo stretnutia, heslo člena panelu a číselné heslo člena panelu.
Žiadna schéma sa nesmie meniť.
Vytvoriť stretnutie
SetMeeting
Ak sa používateľ pokúsi použiť rozhranie API CreateMeeting
na vytvorenie schôdze Webex s veľkým typom relácie udalosti alebo zavolá funkciu SetMeeting
na úpravu schôdze Webex, ktorá je v skutočnosti veľkou udalosťou alebo webovým vysielaním, vráťte nová výnimka 110064. Typ relácie Udalosť a Webcast nie sú podporované.
Správanie sa zmeniť.
Aktualizácie API 41.3.0
Aktualizácie XML API 41.3.0
Nové zmeny XML API podporujú funkciu Webex Events 2.0
Ovplyvnené rozhrania API
Obe rozhrania API: GetSessionInfo a GetMeeting vrátia aj prvky enableEvent
a enableWebniar
.
Názov prvku
Opis
enableEvent
Podporuje EC 2.0 na stretnutí Webex
povoliťWebniar
Podporuje webový seminár na stretnutí Webex
Podpora XMLAPI sa vracia nad dva prvky pre EC 2.0. Aktuálne vydanie XML API nepodporuje plánovanie a nastavenie stretnutia EC2.0.
Zmeny schémy
GetSessionInfo
vráti prvky enableEvent
a enableWebniar
pre EC 2.0.
GetMeeting
vráti prvky enableEvent
a enableWebniar
pre EC 2.0.
Vzor odpovede:
Odpoveď GetSessionInfo
:
VEREJNÉ
false
pravda
false
false
false
false
true
Odpoveď GetMeeting
:
false
pravda
pravda
true
false
false
pravda
Nové zmeny XMLAPI podporujú funkciu lobby pred stretnutím
Ovplyvnené rozhrania API
XML API: GetSite
, LstSummarySession
, GetSessionInfo
a GetMeeting
budú reagovať na nový prvok enablePreMeetingLobby
pre lobby pred stretnutím.
Zmeny schémy
XML API: GetSite
vráti prvok enablePreMeetingLobby
pre vstupnú halu pred stretnutím.
XML API: LstSummarySession
vráti prvok enablePreMeetingLobby
pre lobby pred stretnutím.
XML API: GetSessionInfo
vráti prvok enablePreMeetingLobby
pre vstupnú halu pred stretnutím.
XML API: GetMeeting
vráti prvok enablePreMeetingLobby
pre vstupnú halu pred stretnutím.
Vzor odpovede:
Odpoveď GetSite
:
<ns1:SupportCustomDialRestriction>false</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>false</ns1:SupportTelePresence>
<ns1:SupportTelePresence>1Plus>falsePenceP
<ns1:EnableCloudTelepresence>true</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>true</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>true</ns1:enablePersonalMeetingRoom>
MeetingRoom <ns1:SupportAlternateHost>pravda</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturnScheduledPMR>nepravda</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>Sportny} 9</nsMeetings
<ns1:enablePreMeetingLobby>pravda</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
Odpoveď LstSummarySession
:
false
true
0
nepravda
false
false
pravda
Odpoveď GetSessionInfo
:
VEREJNÉ
false
pravda
false
false
false
false
true
Odpoveď GetMeeting
:
false
pravda
pravda
true
false
false
pravda
Odpoveď rozhrania XML API GetSite
Odhaľovanie zmien v správaní informácií
Ovplyvnené rozhrania API
XML API: GetSite
iba odpoveď pod prvkami pre účet správcu, ktoré zahŕňajú roly: SiteAdmin
, RO_SiteAdmin
a UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost><ns 1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Správanie sa zmenilo
Údaje o licencii služby GetSite
povoliť iba rolu správcu. Hostiteľ alebo účastník nedostane tieto licenčné údaje v odpovedi GetSite
.
Nižšie sú uvedené API: Príklad odpovede GetSite
pre správcu stránok
alebo pripraveného iba pre správcu stránok
alebo správcu na správu používateľov:
Aktualizácie API 41.2.0
Aktualizácie XML API 41.2.0
XMLAPI by malo podporovať „CMR Hybrid VOIP“, ak stránka podporuje telefonovanie Webex
Ovplyvnené rozhrania API
-
GetSite
vráti v odpovedi nový prvok IsWebexTelephony
.
-
CreateUser
a SetUser
môžu aktualizovať prvok cmrHybridVoip
, ak je hodnota IsWebexTelephony
pravdivá spolu s ďalšími podmienkami. ISTSPUsingTelephonyAPI
už nie je dôsledné.
Zmeny schémy
XML API: Odpoveď GetSite
vracia ďalší prvok IsWebexTelephony
Odpoveď GetSite
obsahuje tento nový prvok:
<ns1:isWebexTelephony>pravda</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Osobná konferencia Č.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Prístupový kód účastníka</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Prístupový kód hostiteľa</ns1:subscriberAccessCodeLabel>
<ns1:attendeeID účastník ID</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
podporuje EC2.0
XML API bude ovplyvnené
LstSummarySession
vráti nové dva prvky na podporu EC 2.0
Názov prvku
Opis
enableEvent
Podporuje EC 2.0 na stretnutí Webex
povoliťWebniar
Podporuje webový seminár na stretnutí Webex
Zmeny schémy
XML API: LstSummarySession
: Pripojte prvky <enableEvent
> a <enableWebniar
>
Odozva XML API: LstSummarySession
Reakcia na EC 2.0
pravda
0
false
true
true
XMLAPI podporuje možnosť vrátiť používateľovi stránky možnosť Webex-voice-assistant
pre integráciu MCT
Ovplyvnené rozhranie API
GetUser
vráti v odpovedi nový prvok webexAssistantEnabled
(pravda alebo nepravda).
Zmeny schémy
getUserResponse
:
Príklad odpovede
Aktualizácie API 41.1.0
V schéme XML API 41.1 nie sú žiadne zmeny schémy.