- Home
- /
- Articolo
Qui sono riportate tutte le informazioni importanti necessarie sull'API Cisco Webex Meetings, come le modifiche dello schema e altri annunci.
Per ulteriori informazioni sull'API XML 39 e sull'API XML 11, vedi Panoramica sugli aggiornamenti dell'API XML Cisco Webex Meetings (API XML 39 e precedenti).
Per ulteriori informazioni sull'API XML 40, vedi Panoramica sugli aggiornamenti dell'API XML Cisco Webex Meetings (API XML 40 e successive).
Per aggiornamenti dell'API XML 11 SP9 e precedenti, vai a Cisco DevNet.
Aggiornamenti API 41.12.0
Aggiornamenti dell'API XML 41.12.0
XMLAPI bloccherà la pianificazione e la modifica di Webex Events (classica) in base alla voce di configurazione del sito di EnableClassicEvent
è falso
API e modifiche allo schema interessate
Nella pagina di configurazione di amministrazione sito, se la casella di controllo Abilita evento classico è falsa, questo sito non supporta più le riunioni Webex Events (classico).
Se la casella di controllo Abilita evento classico è falsa, si chiamano queste API per utilizzare la riunione Webex Events (classica):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
L'API risponderà alla nuova eccezione 010106Evento classico disabilitato.
Modifiche allo schema
Nessuna modifica dello schema.
Esempio di richiesta e risposta API
CreateEvent (Crea evento) Richiesta e risposta API
Richiesta di CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>XMLAPI EC Test</sessionName>
</metaData>
<schedule>
<startDate>07/17/2021 01:29:15</startDate>
<openTime>15</openTime>
</schedule>
</bodyContent>
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>ERRORE</serv:result>
<serv:reason>L'Evento classico è stato disabilitato.</serv:reason>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 Incide sulle API:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
risponderà al nuovo elemento di subProductCodePrefix
API interessate
API corrente LstMeetingType
elemento di risposta productionCodePrefix
: PRO, AUO e altri prefissi tipo di riunione predefiniti Webex.
Dopo questo nuovo miglioramento, l'API risponderà al nuovo elemento di subProdctCodePrefix
:PRO1, PRO2, ecc. che può essere personalizzato prefisso del tipo di riunione.
Modifiche dello schema su API: LstMeetingType
Risponderà a un 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>
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> //Nuovo elemento per tipo di riunione personalizzato
<mtgtype:active>ATTIVATO</mtgtype:active>
<mtgtype:name>Cus_Chat_Closed</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Chiuso</mtgtype:displayName>
Aggiornamenti API 41.11.0
Aggiornamenti dell'API XML 41.11.0
L'API XML supporta la compatibilità di inoltro nell'API di gestione utenti per i siti gestiti da Control Hub
API e modifiche allo schema interessate
Se l'applicazione di integrazione sta attualmente utilizzando le API di gestione utenti Webex XMLAPI: CreateUser
, SetUser
, DelUser
e GetUser
per eseguire il provisioning o gestire gli utenti, dopo la conversione del sito Webex classico nel sito gestito da Control Hub, queste API continueranno a funzionare per l'inoltro della compatibilità. Ci sono alcune modifiche al comportamento 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, anche lo stato dell'utente sul sito è attivo, riferimento: Stato utente di nuovi utenti e convertiti in Control Hub.
L'elemento password delle API CreateUser e SetUser verrà ignorato. Iniziamo a inviare e-mail di attivazione a nuovi utenti. Gli utenti possono fare clic sul collegamento nel messaggio e-mail per attivare un nuovo account e inserire una nuova password.
Il attivoelementodell'API CreateUser verrà ignorato; il nuovo utente (non deve essere verificato) non può essere attivato attraverso questo parametro utilizzando l'API Imposta utente.
Il valore di webExId elemento nel bodyContent delle API CreateUser deve essere uguale all'e-mail. Se webExId è diverso da e-mail, tratteremo i webExId come per l'e-mail quando viene memorizzata su WebDB e il valore verrà ignorato.
Il valore di webExId elemento nel bodyContent delle API SetUser deve essere l'identità utente dell'indirizzo e-mail, è possibile modificarlo utilizzando <e-mail> in bodyContent.
L'API SetUser supporta la modifica dell'e-mail dell'utente esistente: se l'account di operazione in SecurityContext è amministratore sito completo di Control Hub. In caso contrario, l'API segnala un errore con il nuovo codice di errore e il messaggio seguente:
030120 Per modificare il messaggio e-mail, l'account deve essere un amministratore completo del sito.
L'elemento newWebExId nel bodyContent di SetUser API verrà ignorato.
L'API SetUser tenta di passare a un messaggio e-mail già in uso; l'API si solleva sotto il nuovo codice di errore e messaggio di errore:
030118 Indirizzo e-mail già utilizzato nei siti gestiti da Control Hub.
L'API DelUser disattiva l'utente lato riunione Webex e la licenza di riunione corrispondente viene rimossa dal sito Webex. Questo utente disattivato può essere riattivato utilizzando l'API: SetUser (<active>ATTIVATO</active>) purché l'utente sia stato verificato in precedenza.
Le API CreateUser e SetUser generano un nuovo codice di errore e un nuovo messaggio di errore, come mostrato di seguito:
030117, Questo utente esiste all'esterno della tua organizzazione, pertanto deve essere richiesto, per passare alla tua organizzazione attraverso il processo di richiesta utente. Per la procedura di richiesta dell'utente nella tua organizzazione, vedi Richiesta di utenti nella tua organizzazione (Converti utenti). Dovrai verificare il dominio a cui appartiene l'utente prima di richiedere l'utente.
030119 Il token di accesso CI deve includere l'ambito webexsquare: amministratore durante il provisioning dell'utente.
È supportata solo per un periodo limitato la compatibilità forward. Verrà fornito un avviso anticipato prima della rimozione di questa compatibilità. |
Modifiche allo schema
Nessuna modifica dello schema su tali API: CreateUser
, SetUser
, DelUser
e GetUser
.
Esempio di richiesta e risposta API
Richiesta e risposta API CreateUser
Richiesta API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{account di amministrazione sito}</webExID>
<email>{account di amministrazione sito}</email>
<sessionTicket>xxxx</sessionTicket> oppure <password> oppure <webExAccessToken>
oppure <accessToken>, quando si utilizza CI "accessToken", deve includere scope webexsquare:admin durante il provisioning dell'utente
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- dovrebbe essere l'identità utente dell'indirizzo e-mail
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>...</password>
<privilege>
<host>vero</host>
</privilege>
<active>ATTIVATO</active> --- questo parametro non può attivare l'utente direttamente fino a quando l'utente si autoattiva tramite e-mail di attivazione.
</bodyContent>
</body>
Esempio di risposta 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></serv:result>
<serv:gsbStatus>PRINCIPALE</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:
Crea utente
Imposta utente
DelUser
L'API XML supporta la compatibilità di inoltro dell'autenticazione dell'utente esistente dopo la conversione del sito classico Webex in sito gestito da Control Hub
API interessate
Una volta convertito il sito classico Webex in un sito gestito da Control Hub, il valore dell'<webExID> elemento in <securityContext> deve essere uguale all'e-mail, dettagli di seguito:
Per gli utenti esistenti creati nel sito classico Webex, supportiamo entrambi i vecchi webExID (Ad esempio: Jack) e nuovo webExID (il contenuto è uguale all'e-mail, ad esempio: Jack@xx.com) per eseguire l'accesso, questa compatibilità di 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 a quello dell'e-mail per l'accesso.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- gli utenti esistenti sono stati creati nel sito webEx classic, può essere: jack o jack@xx.com; il nuovo utente deve utilizzare jack@xx.com
<sessionTicket>xxxx</sessionTicket> o <password> o <webExAccessToken> o <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
Incide sulle API:
Tutte le API XML.
Dopo la conversione del sito classico Webex in un sito gestito da Control Hub, il valore dell'<webExID> elemento <bodyContent> deve essere uguale al messaggio e-mail, dettagli di seguito:
Per gli utenti esistenti creati nel sito classico Webex, supportiamo entrambi i vecchi webExId(es.: Jack) e nuovo webExId (il contenuto è uguale all'e-mail, per esempio: Jack@xx.com) in bodyContent.
Per i nuovi utenti creati nei siti gestiti da Control Hub, il valore di webExId elemento deve essere uguale all'e-mail in
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- utenti esistenti sono stati creati nel sito webEx classico, può essere: jack o jack@xx.com; il nuovo utente deve utilizzare jack@xx.com
</bodyContent>
Incide sulle API:GetUser
, SetUser
e DelUser
.
Modifiche allo schema
Nessuna modifica dello schema su qualsiasi API.
Esempio di richiesta e risposta API
Richiesta e risposta API GetUser
Richiesta API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- gli utenti esistenti sono stati creati nel sito webEx classic, può essere: jack o jack@xx.com; i nuovi utenti devono utilizzare jack@xx.com
<sessionTicket>xxxx</sessionTicket> o <password> o <webExAccessToken> o <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- gli utenti esistenti sono stati creati nel sito webEx classic, può essere: jack o jack@xx.com; il nuovo utente deve utilizzare jack@xx.com
</bodyContent>
</body>
esempio di risposta API:
...come prima
API di report cronologia della registrazione migliorata per il supporto in Webex Meetings, Webex Events (nuovo) e Webex Events (classico)
API interessate
API corrente: lstrecordaccessHistory
e lstrecordaccessDetailHistory
supporta solo la visualizzazione della registrazione di Webex Training al report di cronologia a cui è stato eseguito l'accesso. Il nuovo miglioramento supporta anche la vista di registrazione Webex Meetings, Webex Events (nuovo) e Webex Events (classica) a cui è stato eseguito l'accesso al report della cronologia.
Modifiche allo schema
Di seguito è riportato il nuovo schema in API lstrecordaccessHistory nel corpo della richiesta API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Dettagli
L'API: lstrecordaccessHistory
è in grado di restituire la cronologia di accesso alle registrazioni per Webex Meetings, Webex Events (nuovo), Webex Events (classico) e Webex Training.
Se non c'è tipo di servizio specificato nella richiesta API, l'API di
lstrecordaccessHistory
restituisce solo la vista della registrazione di Webex Training a cui è stato eseguito l'accesso nella cronologia.Quando il Tipo di servizio è MeetingCenter, l'API di
lstrecordaccessHistory
restituisce sia Webex Meetings che la vista registrazione Webex Events (nuova) a cui è stato eseguito l'accesso nella cronologia.Quando il tipo di servizio è EventCenter, l'API di
lstrecordaccessHistory
restituisce la vista della registrazione Webex Events (classica) a cui è stato eseguito l'accesso nella cronologia.
L'API: lstrecordaccessDetailHistory
è in grado di restituire i dettagli tramite recordID
di Webex Meetings, Webex Events (nuovo), Webex Events (classico) e Webex Training.
Esempio di richiesta e risposta API
lstrecordaccessHistory
Richiesta e risposta 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>20/09/2021 00:00:00</viewTimeStart>
<viewTimeEnd>28/09/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy>REGISTRAZIONE</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>OPERAZIONE RIUSCITA</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest cronologia TC-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: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>Prova riproduzione istantanea 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>CE2.0_232423-20210922 0447-1</history:recordName>
<history:creationTime>22/09/2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest storico EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>24/09/2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest della storia 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:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessTest storico EC classic-20210924 1331-1</history:recordName>
<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>
<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 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>
</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>OPERAZIONE RIUSCITA</serv:result>
<serv:gsbStatus>PRINCIPALE</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>24/09/2021 13:27:26</history:accessTime>
<history:registered>falso</history:registered>
<history:downloaded>falso</history:downloaded>
<history:viewed>vero</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>24/09/2021 13:27:39</history:accessTime>
<history:registered>falso</history:registered>
<history:downloaded>vero</history:downloaded>
<history:viewed>falso</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 lo spazio massimo consentito della lunghezza della descrizione Webex Events (classica) tra XMLAPI e pagina Webex.
API interessate
L' API XML : Elemento di CreateEvent e SetEvent di descrizione consentirà l'inserimento di max. 10000 caratteri, se le dimensioni sono superiori, risulterà nel nuovo codice di errore e messaggio:
060068 Descrizione ingresso 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
Esempio di richiesta #API:
...
<body>
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
xmlns:att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service/eventhttp://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVATO</listing>
</accessControl>
<metaData>
<sessionName>Test CE</sessionName>
<description>.......Supponiamo di riempire 10000 caratteri nella descrizione.......</description>
</metaData>
...
------------------------------------
#Esempio di risposta API quando la descrizione supera i 10000 caratteri:
<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>ERRORE</serv:result>
<serv:reason>Descrizione input non valida. La descrizione non può superare 10000 caratteri</serv:reason>
<serv:gsbStatus>PRINCIPALE</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 il nuovo elemento di freeAccount
API interessate
GetUser
restituisce un nuovo elemento che identifica freeAccount
l'account utente è FreeAccount
oppure no.
Modifiche allo schema
Esempio di risposta GetUser
Risposta GetUser:
<use:initials>AW</use:initials>
<use:isUploaded>falso</use:isUploaded>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>falso</use:freeAccount>
Incide sulle API:
GetUser
Aggiornamenti API 41.10.0
Non sono presenti modifiche allo schema dell'API XML 41.10.0. |
Aggiornamenti API 41.9.0
Aggiornamenti dell'API XML 41.9.0
Disattivazione dell'API XML 10.0.0 per tutti i siti T31
Webex prevede di terminare il servizio di supporto dell'API XML ver 10.0.0 per tutti i siti T31.
Stiamo smantellando il codice API XML 10.0.0 da tutte le produzioni nell'aggiornamento 41.9.0.
Aggiornamenti API 41.8.0
Aggiornamenti dell'API XML 41.8.0
Disattivazione dell'API XML 10.0.0 per tutti i siti T31
Webex prevede di terminare il servizio di supporto dell'API XML ver 10.0.0 per tutti i siti T31.
Webex ha rilevato che alcuni client accedono all'URL dell'API XML utilizzando un metodo errato come: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, il modo corretto di accedere all'URL API XML come: https://{siteName}.webex.com/WBXService/XMLService.
Cambiare l'API XML di accesso al codice utilizzando il modo giusto per evitare l'impatto prima di terminare il supporto sull'API XML versione 10.0.0.
Aggiornamenti API 41.7.0
Aggiornamenti dell'API XML 41.7.0
La registrazione di eliminazione e modifica per dispositivi mobili deve essere controllata dall'opzione di amministrazione del sito: Consenti agli organizzatori di riassegnare, modificare, disabilitare ed eliminare le registrazioni
API e modifiche allo schema interessate
GetSite
: restituirà nuovi elementi nominativi enableNBRMCModify
e separateNoRecordingEdit
sotto gli 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>SUCCESSO</serv:result>
<serv:gsbStatus>PRIMARIO</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>falso</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>vero</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Aggiornamenti API 41.6.3
Aggiornamenti dell'API XML 41.6.3
GetSite
Nuovo elemento di risposta di supportLargeEvent
API e modifiche allo schema interessate
GetSite: restituisce nuovi elementi nominativi supportLargeEvent
alla lettera siteCommonOptions
per informare il chiamante se il sito supporta o meno un evento di grandi dimensioni (evento Webex (nuovo)).
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>SUCCESSO</serv:result>
<serv:gsbStatus>PRIMARIO</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>falso</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>vero</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Aggiornamenti API 41.6.0
Aggiornamenti dell'API XML 41.6.0
XMLAPI supporta Webex Events 2.0 nel provisioning
API interessate
GetUser
: restituisce il nome di un nuovo elemento largeEventCapacity
che mostra la capacità del nuovo Event 2.0 (EC 2.0) in questo account utente. Ad esempio, se l'account utente dispone di licenza CI_EC3K, il valore di largeEventCapacity
è 3000.
Modifiche allo schema
Esempio di risposta
GetUserResponse:
XMLAPI LstRecording's CreateTime applica l'ora di inizio della registrazione
API interessate
LstRecording
: LstRecording
risposta CreateTime
come il momento in cui l'utente preme il pulsante Registra.
Dettagli
In passato, l'API XML utilizzava l'indicatore orario di quando la registrazione veniva creata nel database come ora di creazione in LstRecording
risposta. Ora è il momento in cui l'utente inizia effettivamente a effettuare la registrazione. Questa modifica si applica a tutte le registrazioni dei servizi. Non è previsto alcun cambiamento di schema.
Aggiornamenti API 41.5.0
Aggiornamenti dell'API XML 41.5.0
XMLAPI può avviare riunioni pianificate Webex da PSTN come organizzatore
API interessate
CreateUser
: generahostPIN
indipendentemente dalla PMR utente abilitata o meno quando il ruolo utente è organizzatore o amministratore del sito di gestione utenti o di sola lettura o completo.SetUser
: seriehostPIN
usophones.hostPIN
quandopersonalMeetingRoom.hostPIN
non è nella richiesta XML (pre-condizione: tasto di alternanza funzioneAllowStartScheduledMtgFromPhone
è abilitato).GetUser
: rendimentiphones.hostPIN
indipendentemente dalla PMR utente abilitata o meno. (pre-condizione: tasto di alternanza funzioneAllowStartScheduledMtgFromPhone
è abilitato).
Modifiche allo schema
GetUserResponse
:
SetUser
:
Esempio di risposta
GetUserResponse
:
SetUser
:
XMLAPI GetSite
risposta due nuovi elementi per client mobile
API interessate
GetSite
:GetSite
ora risponderà a due nuovi elementi per supportare il client mobile con la logica di visualizzazione o meno della scheda di registrazione.enableRecordingAccess
: vero o falso, i super amministratori Webex possono abilitare o disabilitare l'accesso alle registrazioni mediante il tasto di alternanza(EnableRecordingAccesses
).storageEmptyStatus
: vero o falso, se entrambi i siti non supportano la funzione NBR e assegnano lo spazio di storage NBR come zero, la risposta di stato è vera, altrimenti è 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. In caso di un oggetto e-mail con carattere ASCII puro, non è presente alcuna codifica
API interessateNessun impatto su richieste API, payload risposte, ma modifica il comportamento di codifica dell'oggetto e-mail. Quando l'oggetto dell'e-mail con caratteri non ASCII viene codificato con RFC2047. In caso di un oggetto e-mail con carattere ASCII puro, non è presente alcuna codifica.
Modifiche allo schema
Non sono presenti modifiche allo schema.
Aggiornamenti API 41.4.0
Aggiornamenti dell'API XML 41.4.0
La creazione di eventi pianificati Webex Events può sfruttare l'impostazione predefinita a livello di sito in base al segnale acustico di entrata e uscita
XMLAPI si allinea con la nuova logica attuale per il controllo del tono di entrata e di uscita. Tutti i toni per Webex Events sono stati controllati da una diversa impostazione in Amministrazione sito. In GetSite
, XMLAPI restituisce un campo extra entryExitToneEC
per indicare il valore. Originariamente, quando l'amministratore del sito ha impostato un tono predefinito, la creazione dell'evento non sfrutta questa impostazione applicando l'impostazione predefinita XMLAPI.
API interessate
L' API XML : GetSite restituisce un nuovo elemento entryExitToneEC
per indicare il valore.
L' API XML : CreateEvent, SetEvent, GetEvent la logica di back end aziendale legge il valore di entryExitToneEC
.
Modifiche allo schema
API XML : Esempio di risposta GetSite:
<ns1:defaults>
<ns1:emailReminders>vero</ns1:emailReminders>
<ns1:entryExitTone>ANNUNCIA</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>vero</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NESSUNO</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>vero</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>falso</ns1:updateTSPAccount>
</ns1:defaults>
Incide sulle API:
GetSite
Creaevento
SetEvent
GetEvent
XMLAPI restituisce solo le informazioni dettagliate sull'evento di grandi dimensioni (Webex Event 2.0)
Se la riunione Webex è l'evento o il webcast di grandi dimensioni,
GetSessionInfo
restituisce alcune informazioni dettagliate, tra cui password della riunione, password numerica della riunione, password del coordinatore e password numerica del coordinatore (nessuno schema deve essere modificato).XMLAPI non supporta la creazione e la modifica di alcun evento o funzione webcast di grandi dimensioni, pertanto
CreateMeeting
eSetMeeting
restituisci una nuova eccezione (110064, Il tipo di sessione dell'evento e del webcast non è supportato) per un caso di evento o webcast di grandi dimensioni.
API a impatto
Nome API | Descrizione | Osservazione |
---|---|---|
| Se la riunione Webex è l'evento o il webcast di grandi dimensioni, | Nessun schema da modificare. |
| Se l'utente tenta di utilizzare | Comportamento da modificare. |
Aggiornamenti API 41.3.0
Aggiornamenti dell'API XML 41.3.0
Le nuove modifiche dell'API XML supportano la funzione Webex Events 2.0
API interessate
Entrambe le API: Elementi di ritorno GetSessionInfo e GetMeeting enableEvent
e enableWebniar
anche.
Nome elemento | Descrizione |
---|---|
abilita evento | Supporta EC 2.0 in una riunione Webex |
abilita webinar | Supporta il webinar in una riunione Webex |
Il supporto XMLAPI restituisce al di sopra di due elementi per EC 2.0. La versione corrente dell'API XML non supporta la pianificazione e l'impostazione della riunione EC2.0. |
Modifiche allo schema
GetSessionInfo
elementi di rendimento enableEvent
e enableWebniar
per CE 2.0.
GetMeeting
elementi di rendimento enableEvent
e enableWebniar
per CE 2.0.
Esempio di risposta:
GetSessionInfo
risposta:
<ep:accessControl>
<ep:listStatus>PUBBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>vero</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>vero</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
risposta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>vero</meet:HQvideo>
<meet:HDvideo>vero</meet:HDvideo>
<meet:viewVideoThumbs>vero</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>vero</meet:enablePreMeetingLobby>
Le nuove modifiche XMLAPI supportano la funzione di area di ingresso virtuale pre-riunione
API interessate
L' API XML : GetSite
, LstSummarySession
, GetSessionInfo
e GetMeeting
risponderà al nuovo elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
Modifiche allo schema
L' API XML : GetSite
elemento restituisce enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L' API XML : LstSummarySession
elemento restituisce enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L' API XML : GetSessionInfo
elemento restituisce enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L' API XML : GetMeeting
elemento restituisce enablePreMeetingLobby
per l'area di ingresso virtuale 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></ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>true</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
risposta:
<ep:isException>falso</ep:isException>
<ep:isNextUpcomingInstance>vero</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>vero</ep:enablePreMeetingLobby>
GetSessionInfo
risposta:
<ep:accessControl>
<ep:listStatus>PUBBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>vero</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>vero</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
risposta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>vero</meet:HQvideo>
<meet:HDvideo>vero</meet:HDvideo>
<meet:viewVideoThumbs>vero</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>vero</meet:enablePreMeetingLobby>
L'API XML GetSite
segnalazione del cambiamento di comportamento delle informazioni
API interessate
L' API XML : GetSite
solo risposta sotto gli elementi 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>
Comportamento modificato
Consenti solo il ruolo di amministratore con dati licenza di risposta di GetSite
. L'organizzatore o il partecipante non otterrà tali dati di licenza in GetSite
risposta.
Di seguito sono riportate le API: GetSite's
esempio di risposta per siteadmin
o solo pronto siteadmin
o amministrazione gestione utenti:
Aggiornamenti API 41.2.0
Aggiornamenti dell'API XML 41.2.0
XMLAPI deve supportare "VOIP CMR Hybrid" se il sito supporta la telefonia Webex
API interessate
GetSite
restituisce un nuovo elementoIsWebexTelephony
nella risposta.CreateUser
eSetUser
può aggiornare ilcmrHybridVoip
elemento seIsWebexTelephony
è vero insieme ad altre condizioni.IsTSPUsingTelephonyAPI
non è più consequenziale.
Modifiche allo schema
API XML : GetSite
risposta restituisce un elemento aggiuntivo IsWebexTelephony
GetSite
la risposta include questo nuovo elemento:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>N. conferenza personale.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Codice di accesso partecipante</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Codice di accesso organizzatore</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>ID partecipante</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
supporta EC2.0
Impatto sulle API XML
LstSummarySession
restituirà nuovi due elementi a sostegno della CE 2.0
Nome elemento | Descrizione |
---|---|
abilita evento | Supporta EC 2.0 in una riunione Webex |
abilita webinar | Supporta il webinar in una riunione Webex |
Modifiche allo schema
API XML : LstSummarySession
: Aggiungere la < enableEvent
> e < enableWebniar
> elementi
Risposta di API XML: LstSummarySession
Risposta per EC 2.0
<ep:isNextUpcomingInstance>vero</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>vero</ep:enableEvent>
<ep:enableWebniar>vero</ep:enableWebniar>
XMLAPI supporta la restituzione dell'utente del sito Webex-voice-assistant
opzione per l'integrazione MCT
API interessata
GetUser
restituisce un nuovo elemento webexAssistantEnabled
(vero o falso) nella risposta.
Modifiche allo schema
getUserResponse
:
Esempio di risposta
Aggiornamenti API 41.1.0
Non sono presenti modifiche allo schema dell'API XML 41.1. |