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.
Ďalšie informácie o XML API 39 a XML API 11 nájdete na Prehľad aktualizácií rozhrania XML API Cisco Webex Meetings (XML API 39 a staršie).
Ďalšie informácie o XML API 40 nájdete na Prehľad aktualizácií rozhrania XML API Cisco Webex Meetings (XML API 40 a novšie).
Aktualizácie pre XML API 11 SP9 a staršie nájdete na Cisco DevNet.
Aktualizácie API 41.12.0
Aktualizácie XML API 41.12.0
XMLAPI zablokuje plán a úpravu Webex Events (Classic) podľa položky konfigurácie stránky EnableClassicEvent
to je nepravda
Ovplyvnené zmeny API a schém
Na konfiguračnej stránke správy lokality, ak Povoliť klasickú udalosť políčko je nepravdivé, táto stránka už nebude podporovať (klasické) stretnutia Webex Events.
Ak Povoliť classicEvent začiarkavacie políčko je nepravdivé, tieto rozhrania API voláte na prevádzkovanie stretnutia Webex Events (klasické):
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
CreateEvent Žiadosť a odpoveď API
Požiadavka na 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>
</body>
</serv:message>
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>FAILURE</serv:result>
<serv:reason>The classic Event has been disabled.</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 ovplyvňuje rozhrania API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
bude reagovať na nový prvok subProductCodePrefix
Ovplyvnené rozhrania API
Aktuálne API LstMeetingType
prvok odozvy productionCodePrefix
: PRO, AUO a ďalšie, ktoré sú preddefinované Webex, spĺňajú predponu typu.
Po tomto novom vylepšení bude 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
LstMeetingType
Žiadosť a odpoveď API
Žiadosť o LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
</body>
</serv:message>
Odpoveď na 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> //New element for customized meeting
type
<mtgtype:active>ACTIVATED</mtgtype:active>
<mtgtype:name>Cus_Chat_Closed</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Closed</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 budú tieto rozhrania API naďalej fungovať, aby bola zabezpečená dopredná kompatibilita. Existuje niekoľko zmien správania, ako je uvedené nižšie:
Pri použití createUser- ak stav používateľa v Control Hub nie je „aktívny“, potom stav používateľa na lokalite nebude aktívny. Ak je stav používateľa v Control Hub aktívny, potom je stav používateľa na stránke tiež aktívny, odkaz: Stav používateľa nových a konvertovaných používateľov v Control Hub.
The heslo prvok CreateUser a SetUser Rozhrania API budú ignorované, začneme posielať aktivačný e-mail novým používateľom, používatelia môžu kliknúť na odkaz v e-maile na aktiváciu nového účtu a zadať nové heslo.
The aktívny element z CreateUser API bude ignorovaný, nového používateľa (neoverený) nie je možné aktivovať prostredníctvom tento parameter pomocou API SetUser .
Hodnota webExId prvok v teleObsah CreateUser Rozhrania API musia byť rovnaké ako e-mail. Ak webExId sa líši od email , ošetríme webExId rovnako ako e-mail pri ukladaní do WebDB a hodnota bude ignorovaná.
Hodnota webExId prvok v teleObsah SetUser Rozhrania API musia byť identitou používateľa alebo e-mailovou adresou, môžete ju zmeniť pomocou < email > v bodyContent.
The SetUser Rozhranie API 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 teleObsah SetUser API budú ignorované.
The SetUser Rozhranie API sa pokúša zmeniť na e-mail, ktorý sa už používa, rozhranie API zobrazí nižšie nový kód chyby a chybové hlásenie:
030118 E-mail sa už používa na lokalitách spravovaných Control Hub.
The DelUser Rozhranie API deaktivuje používateľa na strane stretnutia Webex a príslušná licencia na stretnutie sa odstráni zo stránky Webex. Tento deaktivovaný používateľ môže byť znovu aktivovaný pomocou API: SetUser (<active>AKTIVOVANÉ</active>), pokiaľ je používateľ predtým overený.
The CreateUser a SetUser Rozhrania API 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ároku na používateľa. Kroky na získanie používateľa do vašej organizácie nájdete na stránke Nárokovať 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
CreateUser Žiadosť a odpoveď API
API request:
<?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">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{site Admin account}</webExID>
<email>{site Admin account}</email>
<sessionTicket>xxxx</sessionTicket> or <password> or <webExAccessToken>
or <accessToken>, when using CI "accessToken", it must include scope webexsquare:admin when provisioning
user
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- it should is user identity of email address
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>....</password>
<privilege>
<host>true</host>
</privilege>
<active>ACTIVATED</active> ---this parameter can't active the user directly until the user self activate itself via activation
email.
</bodyContent>
</body>
</serv:message>
API response example:
<?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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</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>
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 sa hodnota <webExID> prvok v <securityContext> musí byť rovnaký ako e-mail, podrobnosti nižšie:
Pre existujúcich používateľov vytvorených na klasickej stránke Webex podporujeme obe 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 je hodnota webExID prvok musí byť rovnaký ako e-mail na prihlásenie.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com;
new user must use jack@xx.com
<sessionTicket>xxxx</sessionTicket> or <password> or <webExAccessToken> or <accessToken>
</securityContext>
</header>
Ovplyvniť rozhrania API:
Všetky XML API.
Po konverzii klasickej lokality Webex na lokalitu spravovanú Control Hub sa hodnota <webExID> prvok <bodyContent> musí byť rovnaký ako e-mail, podrobnosti nižšie:
Pre existujúcich používateľov vytvorených na klasickej stránke Webex podporujeme obe staré webExId (napr.: Jack) a nové webExId (obsah je rovnaký ako e-mail, napr. Jack@xx.com) in bodyContent.
Pre nových používateľov vytvorených na spravovaných lokalitách Control Hub je hodnota webExId prvok musí byť rovnaký ako e-mail v
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com; new user
must use jack@xx.com
</bodyContent>
Ovplyvniť rozhrania API:GetUser
, SetUser
, a DelUser
.
Zmeny schémy
Žiadne zmeny schémy na žiadnom rozhraní API.
Príklad žiadosti a odpovede API
GetUser Žiadosť a odpoveď API
API request:
<?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">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com;
new user must use jack@xx.com
<sessionTicket>xxxx</sessionTicket> or <password> or <webExAccessToken> or <accessToken>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com; new user
must use jack@xx.com
</bodyContent>
</body>
</serv:message>
API response example:
...same as before
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
podporuje iba záznam tréningov Webex, zobrazenie prehľadu histórie prístupu. 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:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Podrobnosti
API: lstrecordaccessHistory
je schopný vrátiť históriu prístupov k záznamom pre Webex Meetingy, Webex Eventy (nové), Webex Eventy (klasické) a Webex Trainings.
Ak nie je typ služby špecifikované v požiadavke API, API of
lstrecordaccessHistory
vráti záznam tréningov Webex zobraziť iba históriu prístupu.Keď typ služby je MeetingCenter, API
lstrecordaccessHistory
vráti históriu prístupu k záznamom schôdzí Webex a udalostí Webex (nové).Keď typ služby je EventCenter, API
lstrecordaccessHistory
vráti Webex Events (klasický) záznam zobrazenia histórie prístupu.
API: lstrecordaccessDetailHistory
je schopný vrátiť podrobnosti o recordID
Webex Meetings, Webex Events (nové), Webex Events (klasické) a Webex Trainings.
Príklad žiadosti a odpovede API
lstrecordaccessHistory
Požiadavka a odpoveď 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</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>
</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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test TC-20210924 1324-1</history:recordName>
<history:creationTime>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 instant playback 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>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>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>LstrecordaccessHistory test 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>
</serv:body>
</serv:message>
lstrecordaccessDetailHistory
Požiadavka a odpoveď 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</timeZoneID>
</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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</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>
</serv:body>
</serv:message>
Ovplyvniť rozhrania API:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Opravte medzeru v maximálnej povolenej dĺžke popisu udalostí Webex (Classic) medzi XMLAPI a Webex Page.
Ovplyvnené rozhrania API
XML API: CreateEvent a SetEvent's prvok popis umožní zadanie maximálne 10 000 znakov, ak zadáte nadmernú veľkosť, bude to mať za následok nový chybový kód a správu:
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
CreateEvent Žiadosť a odpoveď API
#API request example:
...
<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/event
http://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>EC test</sessionName>
<description>.......Suppose you filling in 10000 characters in description.......</description>
</metaData>
...
------------------------------------
#API response example when the description exceeds 10000 characters:
<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>Illegal input description. The description can't exceed 10000 characters</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
Ovplyvniť rozhrania API:
CreateEvent
SetEvent
XML API: GetUser vracia nový prvok freeAccount
Ovplyvnené rozhrania API
GetUser
vráti nový prvok, ktorý identifikuje freeAccount
používateľský účet je FreeAccount
alebo nie.
Zmeny schémy
Príklad odpovede GetUser
GetUser response:
<use:initials>AW</use:initials>
<use:isUploaded>false</use:isUploaded>
</use:avatar>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>false</use:freeAccount>
</serv:bodyContent>
</serv:body>
</serv:message>
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 URL XML API ako: https://{siteName}.webex.com/WBXService/XMLService.
Zmeňte svoj prístupový kód XML API 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é názvy prvkov 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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</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>
</serv:body>
</serv:message>
Aktualizácie API 41.6.3
Aktualizácie XML API 41.6.3
GetSite
Reakcia na nový prvok supportLargeEvent
Ovplyvnené zmeny API a schém
GetSite: vráti pomenovanie nových prvkov supportLargeEvent
pod siteCommonOptions
aby volajúci vedel, či stránka podporuje veľké udalosti (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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</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>
</serv:body>
</serv:message>
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é pomenovanie prvku largeEventCapacity
ktorý zobrazuje kapacitu nového Eventu 2.0 (EC 2.0) pod týmto užívateľským účtom. Napríklad, ak má používateľský účet CI_Licencia EC3K v hodnote largeEventCapacity
je 3000.
Zmeny schémy
Príklad odpovede
GetUserResponse:
CreateTime XMLAPI LstRecording aplikuje čas začiatku nahrávania
Ovplyvnené rozhrania API
LstRecording
: LstRecording
odpoveď CreateTime
ako čas, kedy používateľ skutočne stlačí tlačidlo záznamu.
Podrobnosti
V minulosti používalo XML API ako čas vytvorenia časovú pečiatku, kedy bol záznam vytvorený v databáze LstRecording
odpoveď. 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
CreateUser
: generujehostPIN
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 lokality na správu používateľov.SetUser
: súpravyhostPIN
použitímphones.hostPIN
kedypersonalMeetingRoom.hostPIN
nie je v požiadavke XML (predpoklad: prepínač funkciíAllowStartScheduledMtgFromPhone
je umožnené).GetUser
: vraciaphones.hostPIN
bez ohľadu na to, či je PMR používateľa povolené alebo nie. (predpoklad: prepínač funkciíAllowStartScheduledMtgFromPhone
je umožnené).
Zmeny schémy
GetUserResponse
:
SetUser
:
Príklad odpovede
GetUserResponse
:
SetUser
:
XMLAPI GetSite
dva nové prvky pre mobilného klienta
Ovplyvnené rozhrania API
GetSite
:GetSite
bude teraz reagovať na dva nové prvky na podporu mobilného klienta má logiku zobraziť alebo nezobraziť kartu nahrávania.enableRecordingAccess
: pravda alebo nepravda, supersprávcovia Webexu 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, odpoveď na stav je pravdivá, v opačnom prípade je nepravda.
Zmeny schémy
Vzor žiadosti pre GetSite
Vzorová odpoveď pre Getsite
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 APINemá 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. In GetSite
, XMLAPI vráti pole navyše 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: CreateEvent, SetEvent, GetEvent back-end obchodná logika číta hodnotu entryExitToneEC
.
Zmeny schémy
XML API: Príklad odpovede GetSite:
<ns1:defaults>
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>ANNOUNCENAME</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NONE</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
Ovplyvniť rozhrania API:
GetSite
CreateEvent
SetEvent
GetEvent
XMLAPI len vráti podrobné informácie o veľkej udalosti (Webex Event 2.0).
Ak je Webex Meeting veľká udalosť alebo webcast,
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
CreateMeeting
aSetMeeting
vrátiť 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 |
Popis |
Poznámka |
---|---|---|
|
Ak je Webex Meeting veľká udalosť alebo webcast, |
Žiadna schéma sa nesmie meniť. |
|
Ak sa používateľ pokúsi použiť |
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 návratové prvky enableEvent
a enableWebniar
tiež.
Názov prvku |
Popis |
---|---|
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
vracia prvky enableEvent
a enableWebniar
pre EC 2.0.
GetMeeting
vracia prvky enableEvent
a enableWebniar
pre EC 2.0.
Vzor odpovede:
GetSessionInfo
odpoveď:
<ep:accessControl>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
odpoveď:
<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>
</meet:enableOptions>
Nové zmeny XMLAPI podporujú funkciu lobby pred stretnutím
Ovplyvnené rozhrania API
XML API: GetSite
, LstSummarySession
, GetSessionInfo
, a GetMeeting
bude reagovať na nový prvok enablePreMeetingLobby
pre lobby pred stretnutím.
Zmeny schémy
XML API: GetSite
vracia prvok enablePreMeetingLobby
pre lobby pred stretnutím.
XML API: LstSummarySession
vracia prvok enablePreMeetingLobby
pre lobby pred stretnutím.
XML API: GetSessionInfo
vracia prvok enablePreMeetingLobby
pre lobby pred stretnutím.
XML API: GetMeeting
vracia prvok enablePreMeetingLobby
pre lobby pred stretnutím.
Vzor odpovede:
GetSite
odpoveď:
<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
odpoveď:
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>false</ep:isScheduledPMR>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:session>
GetSessionInfo
odpoveď:
<ep:accessControl>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
odpoveď:
<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>
</meet:enableOptions>
XML API GetSite
odozva Informácie o zmene správania zverejniť
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>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Správanie sa zmenilo
Povoliť odozvu iba role správcu licenčné údaje z GetSite
. Hostiteľ alebo účastník nedostane tieto licenčné údaje GetSite
odpoveď.
Nižšie sú uvedené API: GetSite's
príklad odpovede na siteadmin
alebo len pripravené siteadmin
alebo správca správy 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 nový prvokIsWebexTelephony
v odpovedi.CreateUser
aSetUser
môže aktualizovaťcmrHybridVoip
prvok akIsWebexTelephony
je pravda spolu s ďalšími podmienkami.IsTSPUsingTelephonyAPI
už nie je dôsledné.
Zmeny schémy
XML API: GetSite
odpoveď vráti ďalší prvok IsWebexTelephony
GetSite
odpoveď obsahuje tento nový prvok:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Personal Conference No.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Attendee access code</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Host access code</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Attendee 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 |
Popis |
---|---|
enableEvent |
Podporuje EC 2.0 na stretnutí Webex |
povoliťWebniar |
Podporuje webový seminár na stretnutí Webex |
Zmeny schémy
XML API: LstSummarySession
: Pripojte enableEvent
> a enableWebniar
> prvky
Odozva XML API: LstSummarySession
Reakcia na 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>
</ep:session>
XMLAPI podporuje návrat používateľa lokality Webex-voice-assistant
možnosť integrácie MCT
Ovplyvnené rozhranie API
GetUser
vráti nový prvok webexAssistantEnabled
(pravda alebo nepravda) v odpovedi.
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. |