Qui sono riportate tutte le importanti informazioni necessarie sull'API Cisco Webex Meetings, come le modifiche allo schema e altri annunci.
Per ulteriori informazioni sull'API XML 39 e sull'API XML 11, vedere panoramica sugli aggiornamenti dell'API XML Cisco Webex Meetings (API XML 39 e precedenti).
Per ulteriori informazioni sull'API XML 40, vedere panoramica sugli Cisco Webex Meetings sugli aggiornamenti dell'API XML (API XML 40 e versioni successive).
Per gli aggiornamenti per l'API XML 11 SP9 e precedenti, andare a Cisco DevNet.
Aggiornamenti API 41.12.0
Aggiornamenti all'API XML 41.12.0
XMLAPI blocca la pianificazione Webex Events (classica) e la modifica in base alla voce di configurazione del sito di EnableClassicEvent
che è falso
Modifiche alle API e allo schema sulle
Nella pagina di configurazione dell'amministrazione sito, se la casella di controllo Abilita evento classico è false, questo sito non supportare più le Webex Events (classica).
Se la casella di controllo Enable classicEvent (Abilita classicEvent) è false, chiamare queste API per Webex Events riunione (classica):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
L'API risponderà a una nuova 010106l'evento classico è stato disabilitato.
Modifiche allo schema
Nessuna modifica allo schema.
Esempio di richiesta e risposta API
Richiesta e risposta API CreateEvent
Richiesta di 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>
Risposta di 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 influisce sulle API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
risponderà al nuovo elemento di subProductCodePrefix
API su cui si è impatto
Corrente API LstMeetingType
elemento risposta di productionCodePrefix
: PRO, AUO e altri prefissi di tipo meetex predefiniti di Webex.
Dopo questo nuovo miglioramento, l'API risponderà a un nuovo elemento di subProdctCodePrefix
:P RO1, PRO2, ecc. che può essere personalizzato prefisso di tipo meet.
Modifiche allo schema sull'API: LstMeetingType
Verrà risposta nuovo elemento: subProdctCodePrefix
Esempio di richiesta e risposta API
LstMeetingType
Richiesta e risposta API
Richiesta di LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
</body>
</serv:message>
Risposta di 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>
Aggiornamenti API 41.11.0
Aggiornamenti all'API XML 41.11.0
Compatibilità del supporto DELL'API XML nell'API di gestione utenti per i siti gestiti da Control Hub
Modifiche alle API e allo schema sulle
Se l'applicazione di integrazione sta attualmente utilizzando le API di gestione degli utenti XMLAPI Webex: CreateUser
, SetUser
, DelUser
e GetUser
per eseguire il provisioning o la gestione degli utenti, dopo la conversione del sito classico Webex nel sito gestito da Control Hub, queste API continueranno a funzionare per la compatibilità con gli inoltro. Esistono alcune modifiche di funzionamento come indicato di seguito:
Quando si utilizza createUser: se lo stato dell'utente in Control Hub non è "attivo", lo stato dell'utente sul sito non sarà attivo. Se lo stato dell'utente in Control Hub è attivo, lo stato dell'utente sul sito è attivo, fare riferimento a: Stato utente degli utenti nuovi e convertiti in Control Hub.
L'elemento password delle API CreateUser e SetUser verrà ignorato; l'invio del messaggio e-mail di attivazione ai nuovi utenti verrà ignorato; gli utenti potranno fare clic sul collegamento nel messaggio e-mail al nuovo account attivo e inserire la nuova password.
L'elemento attivo dell'API CreateUser verrà ignorato. Il nuovo utente (non verificato) non può essere attivato attraverso questo parametro utilizzando l'API SetUser.
Il valore dell'elemento webExId nel corpo Del contenuto delle API CreateUser deve essere uguale all'indirizzo e-mail. Se webExId è diverso dall'e-mail, il valore di webExId verrà trattato come l'e-mail nella memorizzazione in WebDB e il valore verrà ignorato.
Il valore dell'elemento webExId nel bodyContent delle API SetUser deve essere l'identità utente dell'indirizzo e-mail; è possibile modificarlo utilizzando le e-mail > inbodyContent.
L'API SetUser supporterà la modifica del messaggio e-mail dell'utente esistente: se l'account dell'operazione in SecurityContext è l'amministratore del sito completo di Control Hub. Altrimenti, l'API segnala un errore con il nuovo codice di errore e messaggio seguente:
030120 L'account deve essere un amministratore del sito completo per la modifica dell'e-mail.
L'elemento newWebExId nel corpoContent dell'API SetUser verrà ignorato.
L'API SetUser tenta di passare a un messaggio e-mail già in uso; l'API genera sotto il nuovo codice di errore e messaggio di errore:
030118-mail di controllo è già utilizzato nei siti gestiti da Control Hub.
L'API DelUser disattiva l'utente sul lato riunione Webex e la licenza della riunione corrispondente viene rimossa dal sito Webex. Questo utente disattivato può essere riattivato utilizzando l'API: SetUser ( ACTIVATED ) purché<active></active>l'utente sia stato verificato prima.
Le API CreateUser e SetUser generano un nuovo codice di errore e un messaggio di errore come mostrato di seguito:
030117 , questo utente esiste al di fuori della propria organizzazione, pertanto deve essere richiesto, perpassare all'organizzazione attraverso il processo di richiesta utente. Per le procedure su come richiedere l'utente nella propria organizzazione, vedere Richiesta di utenti per la propria organizzazione (conversione degli utenti). Sarà necessario verificare il dominio a cui appartiene l'utente prima di richiedere l'utente.
030119 token di accesso CI deve includere l'ambito webexsquare: quando si esegue il provisioning dell'utente.
È supportata solo la compatibilità con gli inoltro per un periodo limitato. Forniremo un avviso avanzato prima della rimozione di questa compatibilità. |
Modifiche allo schema
Nessuna modifica allo schema su tali API: CreateUser
, SetUser
, DelUser
e GetUser
.
Esempio di richiesta e risposta API
Richiesta e risposta API CreateUser
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>
Incide sulle API:
Createuser
Setuser
Utente Del
L'API XML supporta la compatibilità con l'autenticazione in avanti dell'utente esistente in seguito alla conversione del sito classico Webex nel sito gestito da Control Hub
API su cui si è impatto
Una volta convertito il sito classico Webex in un sito gestito da Control Hub, il valore dell'elemento in deve essere uguale all'e-mail, <webExID> <securityContext> dettagli seguenti:
Per gli utenti esistenti creati nel sito classico Webex, sono supportati entrambi i webExID precedente (ad esempio: Jack) e il nuovo webExID (il contenuto è uguale all'e-mail, esempio: Jack@xx.com) per l'accesso, questa compatibilità con le versioni precedenti dell'autenticazione è per tutte le API XML.
Per i nuovi utenti creati nei siti gestiti da Control Hub, il valore dell'elemento webExID deve essere uguale all'e-mail per l'accesso.
<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>
Incide sulle API:
Tutte le API XML.
Una volta convertito il sito classico Webex in un sito gestito da Control Hub, il valore dell'elemento bodyContent > deve essere uguale all'e-mail, <webExID> dettagliseguenti:
Per gli utenti esistenti creati nel sito classico Webex, sono supportati entrambi i webExIdprecedente (ad esempio, Jack) e il nuovo webExId (il contenuto è uguale all'e-mail, ad esempio: Jack@xx.com) in bodyContent.
Per i nuovi utenti creati nei siti gestiti da Control Hub, il valore dell'elemento webExId deve essere uguale all'indirizzo e-mail in
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>
Incide sulle API:GetUser
, SetUser
e DelUser
.
Modifiche allo schema
Nessuna modifica allo schema su API.
Esempio di richiesta e risposta API
Richiesta e risposta API GetUser
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
Miglioramenti all'API del report di visualizzazione della registrazione per il supporto in versioni Webex Meetings, Webex Events (nuovo) e Webex Events (classica)
API su cui si è impatto
API corrente: lstrecordaccessHistory
e lstrecordaccessDetailHistory
supporta solo report cronologia accesso a cronologia registrazioni Webex Trainings. Il nuovo miglioramento supporta l'accesso Webex Meetings, Webex Events (nuovo) e la cronologia delle registrazioni Webex Events (classica) anche nei report della cronologia di accesso.
Modifiche allo schema
Il nuovo schema nell'API lstrecordaccessHistory è riportato di seguito nel corpo della richiesta API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Dettagli
L'API: lstrecordaccessHistory
è in grado di ripristinare la cronologia di accesso alla visualizzazione della registrazione per Webex Meetings, Webex Events (nuovo), Webex Events (classica) e le sessioni di formazione Webex.
Se non è specificato serviceType nella richiesta API, l'API di
lstrecordaccessHistory
restituisce solo la cronologia di accesso alla visualizzazione delle registrazioni di Webex Training.Se serviceType è MeetingCenter, l'API di
lstrecordaccessHistory
restituisce sia la Webex Meetings registrazione Webex Events (nuova) della cronologia a cui è stato eseguito l'accesso alla visualizzazione della registrazione.Se serviceType è EventCenter, l'API di
lstrecordaccessHistory
restituisce Webex Events cronologia accesso alla vista della registrazione (classica).
L'API: lstrecordaccessDetailHistory
è in grado di restituire i dettagli tramite recordID
di Webex Meetings, Webex Events (nuove), Webex Events (classica) e Webex Training.
Esempio di richiesta e risposta API
lstrecordaccessHistory
Richiesta e risposta dell'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
Richiesta e risposta dell'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>
Incide sulle API:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Correggere la differenza della lunghezza massima Webex Events descrizione consentita (classica) tra XMLAPI e pagina Webex.
API su cui si è impatto
L'API XML: L'elemento di descrizione di CreateEvent e SetEvent consentirà massimo 10000 input di caratteri; se immessa su dimensione, verranno restituiti nuovi codice di errore e messaggio:
060068 descrizione input non valida. Questa descrizione non può superare i 10000 caratteri.
Modifiche allo schema
Nessuna modifica allo schema.
Esempio di richiesta e risposta API
Richiesta e risposta API CreateEvent
#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>
Incide sulle API:
CreateEvent
SetEvent
API XML: GetUser restituisce un nuovo elemento di freeAccount
API su cui si è impatto
GetUser
restituisce un nuovo elemento che identifica freeAccount
la account utente è FreeAccount
o meno.
Modifiche allo schema
Esempio di risposta 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>
Incide sulle API:
GetUser
Aggiornamenti API 41.10.0
Non è stata apportata alcuna modifica allo schema dell'API XML 41.10.0. |
Aggiornamenti API 41.9.0
Aggiornamenti all'API XML 41.9.0
Rimozione autorizzazioni API XML 10.0.0 per tutti i siti T31
Webex prevede l'intenzione di non supportare l'API XML ver 10.0.0 per tutti i siti T31.
Stiamo per rimuovere le autorizzazioni del codice API XML 10.0.0 da tutte le produzione nell'aggiornamento 41.9.0.
Aggiornamenti API 41.8.0
Aggiornamenti all'API XML 41.8.0
Rimozione autorizzazioni API XML 10.0.0 per tutti i siti T31
Webex prevede l'intenzione di non supportare l'API XML ver 10.0.0 per tutti i siti T31.
Webex ha rilevato alcuni clienti che accedono all'URL dell'API XML utilizzando un metodo errato come: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, il modo corretto per accedere all'URL API XML come: https://{siteName}.webex.com/WBXService/XMLService.
Passare l'API XML di accesso al codice utilizzando il modo giusto per evitare l'impatto prima di terminare il supporto dell'API XML versione 10.0.0.
Aggiornamenti API 41.7.0
Aggiornamenti all'API XML 41.7.0
Le registrazioni di eliminazione e modifica mobile devono essere controllate dall'opzione di amministrazione del sito: Consenti agli ospiti di riassegnare, modificare, disabilitare ed eliminare le registrazioni
Modifiche alle API e allo schema sulle
GetSite
: restituirà i nuovi elementi di denominazione enableNBRMCModify
e separateNoRecordingEdit
in strumenti.
Esempio di risposta
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>
Aggiornamenti API 41.6.3
Aggiornamenti all'API XML 41.6.3
GetSite
Nuovo elemento risposta di supportLargeEvent
Modifiche alle API e allo schema sulle
GetSite: restituisce nuovi elementi di denominazione supportLargeEvent
sotto siteCommonOptions
per in modo che il chiamante sappia se il sito supporta l'evento di grandi dimensioni (nuovo) o meno.
Modifica schema
Esempio di risposta
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>
Aggiornamenti API 41.6.0
Aggiornamenti all'API XML 41.6.0
Supporto XMLAPI Webex Events 2.0 nel provisioning
API su cui si è impatto
GetUser
: restituisce il nuovo nome per gli elementi largeEventCapacity
che mostra la capacità del nuovo Evento 2.0 (EC 2.0) in questo account utente. Ad esempio, se il account utente dispone di una licenza CI_EC3K, il valore di largeEventCapacity
è 3000.
Modifiche allo schema
Esempio di risposta
GetUserResponse:
Ora di inizio applicazione registrazione di XMLAPI LstRecording
API su cui si è impatto
LstRecording
: LstRecording
Risposta CreateTime
l'ora in cui l'utente preme effettivamente il pulsante Registra.
Dettagli
In passato, l'API XML utilizzava indicatore di data/ora di quando la registrazione era stata creata nel database come ora di creazione in LstRecording
Risposta. Ora è l'ora in cui l'utente inizia a effettuare la registrazione. Questa modifica si applica a tutte le registrazioni dei servizi. Nessuna modifica di schema.
Aggiornamenti API 41.5.0
Aggiornamenti all'API XML 41.5.0
XMLAPI è in grado di avviare riunioni pianificate Webex PSTN come organizzatore
API su cui si è impatto
CreateUser
: generahostPIN
indipendentemente dal fatto che PMR sia abilitato o meno quando il ruolo utente è organizzatore o amministratore del sito di gestione utenti completo o di sola lettura.SetUser
: impostahostPIN
Utilizzandophones.hostPIN
QuandopersonalMeetingRoom.hostPIN
non è in richiesta XML (pre-condizione: attivazione/disattivazione funzioneAllowStartScheduledMtgFromPhone
è abilitato).GetUser
: restituiscephones.hostPIN
indipendentemente dall'PMR dell'utente sia abilitata o meno. (pre-condizione: attivazione/disattivazione funzioneAllowStartScheduledMtgFromPhone
è abilitato).
Modifiche allo schema
GetUserResponse
:
SetUser
:
Esempio di risposta
GetUserResponse
:
SetUser
:
XMLAPI GetSite
risposta due nuovi elementi per client mobile
API su cui si è impatto
GetSite
:GetSite
ora risponderanno a due nuovi elementi al client mobile con la logica di visualizzazione o non visualizzazione della scheda di registrazione.enableRecordingAccess
: true (vero o falso), i super amministratori Webex possono abilitare o disabilitare l'accesso alle registrazioni attivando l'interruttore(EnableRecordingAccesses
).storageEmptyStatus
: true o false (falso), se entrambi i siti non supportano la funzione NBR e allocato lo spazio di storage NBR come zero, la risposta allo stato è vera oppure è falso.
Modifiche allo schema
Richiesta di esempio per GetSite
Risposta di esempio per Getsite
L'oggetto e-mail con caratteri non ASCII verrà codificato con RFC2047. Per l'oggetto di un messaggio e-mail in carattere ASCII puro, non esiste alcuna codifica
API su cui si è impattoNon vi è alcun impatto su qualsiasi richiesta API, carico utile per le risposte, ma modifica il funzionamento della codifica dell'oggetto dell'e-mail. Quando l'oggetto dell'e-mail con caratteri non ASCII viene codificato con RFC2047. Per l'oggetto di un messaggio e-mail in carattere ASCII puro, non esiste alcuna codifica.
Modifiche allo schema
Nessuna modifica allo schema.
Aggiornamenti API 41.4.0
Aggiornamenti all'API XML 41.4.0
Crea evento pianificato Webex Events possibile sfruttare il valore predefinito a livello di sito al segnale acustico di entrata e uscita
XMLAPI si allinea alla nuova logica attuale per il controllo del segnale di entrata e uscita. Tutti i toni per Webex Events erano controllati da una diversa impostazione in Amministrazione sito. In GetSite
, XMLAPI restituisce un campo aggiuntivo entryExitToneEC
per indicare il valore. Originariamente, quando l'amministratore del sito ha impostato un valore predefinito per il segnale acustico, la creazione di Event non sfrutta questa impostazione applicando il valore predefinito XMLAPI.
API su cui si è impatto
L'API XML: GetSite restituisce un nuovo elemento entryExitToneEC
per indicare il valore.
L'API XML: CreateEvent, SetEvent, GetEvent back end logica aziendale legge il valore di entryExitToneEC
.
Modifiche allo schema
API XML: Esempio di risposta 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>
Incide sulle API:
GetSite
Crea evento
Evento impostato
Ottieni evento
XMLAPI restituisce solo le informazioni dettagliate sull'evento di grandi dimensioni (Webex Event 2.0)
Se il App Webex Meetings è l'evento di grandi dimensioni o la trasmissione Webcast,
GetSessionInfo
restituisce alcune informazioni dettagliate come la password per la riunione, la password numerica della riunione, la password numerica del pannello e la password numerica del pannello (non è possibile modificare lo schema).XMLAPI non supporta la creazione e la modifica di eventi di grandi dimensioni o funzionalità Webcast, pertanto,
CreateMeeting
eSetMeeting
restituisce una nuova eccezione (110064, l'evento e le trasmissioni webcast tipo di sessione non sono supportate).
Impatto sulle API
Nome API |
Descrizione |
Osservazione |
---|---|---|
|
Se il App Webex Meetings è l'evento di grandi dimensioni o la trasmissione Webcast, |
Nessuno schema da modificare. |
|
Se l'utente tenta di utilizzare |
Funzionamento modificato. |
Aggiornamenti API 41.3.0
Aggiornamenti all'API XML 41.3.0
Le nuove modifiche apportate dall'API XML Webex Events funzione 2.0
API su cui si è impatto
Entrambe le API: Elementi restituiti GetSessionInfo e GetMeeting enableEvent
e enableWebniar
Anche.
Nome elemento |
Descrizione |
---|---|
abilitaEvento |
Supporta EC 2.0 in una riunione Webex |
enableWebniar |
Supporta webinar in una riunione Webex |
Il supporto XMLAPI restituisce sopra due elementi per EC 2.0. La release dell'API XML corrente non supporta la pianificazione e l'impostazione della riunione EC2.0. |
Modifiche allo schema
GetSessionInfo
restituisce elementi enableEvent
e enableWebniar
per EC 2.0.
GetMeeting
restituisce elementi enableEvent
e enableWebniar
per EC 2.0.
Esempio di risposta:
GetSessionInfo
Risposta:
<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
Risposta:
<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>
Le nuove modifiche XMLAPI supportano la funzione di area di ingresso pre-riunione
API su cui si è impatto
L'API XML: GetSite
, LstSummarySession
, GetSessionInfo
e GetMeeting
risponderà al nuovo elemento enablePreMeetingLobby
per l'area di ingresso pre-riunione.
Modifiche allo schema
L'API XML: GetSite
restituisce elemento enablePreMeetingLobby
per l'area di ingresso pre-riunione.
L'API XML: LstSummarySession
restituisce elemento enablePreMeetingLobby
per l'area di ingresso pre-riunione.
L'API XML: GetSessionInfo
restituisce elemento enablePreMeetingLobby
per l'area di ingresso pre-riunione.
L'API XML: GetMeeting
restituisce elemento enablePreMeetingLobby
per l'area di ingresso pre-riunione.
Esempio di risposta:
GetSite
Risposta:
<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
Risposta:
<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
Risposta:
<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
Risposta:
<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>
The XML API GetSite
risposta Informazioni comportamento modifica divulgare
API su cui si è impatto
L'API XML: GetSite
solo gli elementi seguenti per l'account amministratore, che includono i ruoli: SiteAdmin
, RO_SiteAdmin
e 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>
Funzionamento modificato
Consenti solo al ruolo amministratore di disporre dei dati di licenza di risposta di GetSite
. L'organizzatore o il partecipante non otterrà tali dati di licenza in GetSite
Risposta.
Di seguito è riportata l'API: GetSite's
esempio di risposta per siteadmin
o solo pronto siteadmin
o amministratore di gestione utenti:
Aggiornamenti API 41.2.0
Aggiornamenti all'API XML 41.2.0
XMLAPI deve supportare "CMR Hybrid VOIP" se il sito supporta la telefonia Webex
API su cui si è impatto
GetSite
restituisce un nuovo elementoIsWebexTelephony
nella risposta.CreateUser
eSetUser
può aggiornarecmrHybridVoip
elemento seIsWebexTelephony
è vero insieme ad altre condizioni.IsTSPUsingTelephonyAPI
non è più consequenziale.
Modifiche allo schema
API XML: GetSite
risposta restituisce un elemento aggiuntivo IsWebexTelephony
GetSite
risposta include questo nuovo elemento:
<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
supporta EC2.0
Sulle API XML
LstSummarySession
restituirà nuovi due elementi per supportare EC 2.0
Nome elemento |
Descrizione |
---|---|
abilitaEvento |
Supporta EC 2.0 in una riunione Webex |
enableWebniar |
Supporta webinar in una riunione Webex |
Modifiche allo schema
API XML: LstSummarySession
: Aggiungere il campo < enableEvent
> e enableWebniar
> modello
Risposta dell'API XML: LstSummarySession
Risposta per 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>
SUPPORTO XMLAPI per la restituzione dell'utente del sito Webex-voice-assistant
opzione per l'integrazione MCT
API interessata
GetUser
restituisce un nuovo elemento webexAssistantEnabled
(true o false) nella risposta.
Modifiche allo schema
getUserResponse
:
Esempio di risposta
Aggiornamenti API 41.1.0
Non sono state apportate modifiche allo schema dello schema API XML 41.1. |