- Home
- /
- Articolo
Cisco Webex Meetings panoramica degli aggiornamenti dell'API (API 41)
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, 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 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 bloccherà la pianificazione e la modifica di Webex Events (classica) in base all'elemento di configurazione del sito di EnableClassicEvent
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à alla nuova eccezione 010106 L'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
XXXXXXXX
XMLAPI EC Testing
17/07/2021 01:29:15
15
Risposta di CreateEvent
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:messaggio xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:evento="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:risposta>
<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:risposta>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateEvent3.1.3 influisce sulle API:
-
SetEvent GetEvent
-
GetSessionInfo
-
LstsummaryEvent
-
EventoLstrecorded
-
LstsummaryProgram
-
Carica evento evento
XMLAPI LstMeetingType
risponderà al nuovo elemento di subProductCodePrefix
API su cui si è impatto
Attivare l'elemento di risposta API LstMeetingType
di 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 con il prefisso del tipo di riunione.
Modifiche allo schema sull'API: TipoRiunioneLst
Verrà risposta nuovo elemento: subprodctCodePrefix
Esempio di richiesta e risposta API
Richiesta e risposta API LstMeetingType
Richiesta di LstMeetingType
13810
Risposta di LstMeetingType
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Nuovo elemento per il tipo di riunione personalizzato
<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 il provisioning o la gestione degli utenti, dopo la conversione del sito classico Webex in sito gestito da Control Hub, queste API continueranno a funzionare per la compatibilità di 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 di 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 di CreateUser API verrà ignorato; il nuovo utente (non deve essere verificato) non può essere attivato attraverso questo parametro utilizzando API SetUser.
-
Il valore dell'elemento webExId nel corpo Del contenuto delle API CreateUser deve essere uguale all'indirizzo e-mail. Se webExId è diverso da email, tratteremo il webExId come e-mail quando lo memorizzeremo 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 <email> in bodyContent.
-
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 Per modificare l'e-mail, l'account deve essere un amministratore completo del sito.
-
-
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 Indirizzo e-mail 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 (ATTIVATO) purché 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 all'esterno della tua organizzazione, pertanto deve essere richiesto, per passare alla tua 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 Il token di accesso CI deve includere scope 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
Richiesta API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio 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">
<intestazione>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{account di amministrazione sito}</webExID>
<email>{account Amministrazione sito}</email>
<sessionTicket>xxxx</sessionTicket> o o
o , quando si utilizza CI "accessToken", deve includere scope webexsquare:admin durante il provisioning dell'utente
</securityContext>
</intestazione>
<corpo>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId>: deve essere l'identità utente dell'indirizzo e-mail
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<cognome>Smith</cognome>
<password>...</password>
<privilegio>
<host>vero</host>
</privilegio>
<active>ACTIVATED</active>: questo parametro non può attivare l'utente direttamente fino a quando l'utente non si autoattiva tramite e-mail di attivazione.
</bodyContent>
</corpo>
Esempio di risposta API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio 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:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</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>
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. Dettagli di seguito:
-
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.
{siteName}
{userName} --- 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
xxxx o o o
Incide sulle API:
Tutte le API XML.
Dopo la conversione del sito classico Webex in un sito gestito da Control Hub, il valore dell'elemento <bodyContent> deve essere uguale a quello dell'e-mail, dettagli di seguito:
-
Per gli utenti esistenti creati nel sito classico Webex, supportiamo entrambi i vecchi webExId(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 a quello dell'e-mail in
bodyContent
.
xxxx --- gli utenti esistenti sono stati creati nel sito webEx classico, può essere: jack o jack@xx.com; il nuovo utente deve utilizzare jack@xx.com
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
Richiesta API:
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio 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">
<siteName>{siteName}</siteName>
<webExID>{userName}</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
xxxx o o o
xxxx --- gli utenti esistenti sono stati creati nel sito webEx classico, può essere: jack o jack@xx.com; il nuovo utente deve utilizzare jack@xx.com
Esempio di risposta API:
...come prima
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
supportano solo la visualizzazione della registrazione di Webex Training al report di cronologia a cui è stato eseguito l'accesso. 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:
MeetingCenter
TrainingCenter
EventCenter
Dettagli
L'API: lstrecordaccessHistory
è in grado di restituire la vista della registrazione a cui è stato eseguito l'accesso per Webex Meetings, Webex Events (nuovo), Webex Events (classico) e Webex Training.
-
Se non è specificato alcun Tipo di servizio nella richiesta API, l'API di
lstrecordaccessHistory
restituisce solo la vista della registrazione di Webex Training a cui è stato eseguito l'accesso. -
Quando il TipoDiServizio è MeetingCenter, l'API di
lstrecordaccessHistory
restituisce la cronologia di accesso sia a Webex Meetings che a Webex Events (nuovo). -
Quando il TipoDiServizio è EventCenter, l'API di
lstrecordaccessHistory
restituisce la vista della registrazione Webex Events (classica) a cui è stato eseguito l'accesso alla cronologia.
L'API: lstrecordaccessDetailHistory
è in grado di restituire i dettagli per recordID
di Webex Meetings, Webex Events (nuovo), Webex Events (classico) e Webex Training.
Esempio di richiesta e risposta API
lstrecordaccessHistory
richiesta e risposta dell'API
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<intestazione>
<securityContext>
<webExID>{username}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</intestazione>
<corpo>
<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>
<ordine>
<orderBy>RECORDID</orderBy>
<orderAD>ASC</orderAD>
</ordinare>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</bodyContent>
</corpo>
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio 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:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</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>24/09/2021 13:28:13</history:creationTime>
<history:registered>0</history:registered>
<history:download>2</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<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:download>0</history:download>
<cronologia:visualizzati>3</cronologia:visualizzati>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Test della riproduzione istantanea 2-20210705 0709-1</history:recordName>
<history:creationTime>05/07/2021 07:15:06</history:creationTime>
<history:registered>0</history:registered>
<history:download>0</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<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>22/09/2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:download>0</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<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>24/09/2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:download>1</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory test MC-20210924 1319-1</history:recordName>
<history:creationTime>24/09/2021 13:25:12</history:creationTime>
<history:registered>0</history:registered>
<history:download>1</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<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>24/09/2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:download>1</history:download>
<cronologia:visualizzata>1</cronologia:visualizzata>
<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>
lstrecordaccessDetailHistory
richiesta e risposta dell'API
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<intestazione>
<securityContext>
<webExID>{username}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type=
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
20
</corpo>
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio 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:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</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:download>false</history:download>
<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>24/09/2021 13:27:39</history:accessTime>
<history:registered>falso</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>
Incide sulle API:
-
lstrecordaccessHistory
-
lstrecordaccessCronologiaDettagli
Correggere la differenza della lunghezza massima Webex Events descrizione consentita (classica) tra XMLAPI e pagina Webex.
API su cui si è impatto
L'API XML: CreateEvent e l'elemento di descrizione di SetEvent consentiranno l'inserimento di max. 10000 caratteri; se viene aggiunta una dimensione superiore, verrà visualizzato il nuovo codice di errore e il 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 esempio di richiesta:
...
<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>PRIVATO</listing>
</accessControl>
<metaData>
<sessionName>Test EC</sessionName>
<description>.......Supponiamo di dover riempire 10000 caratteri nella descrizione.......</description>
</metaData>
...
------------------------------------
#API esempio di risposta quando la descrizione supera 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:result>FAILURE</serv:result>
Illegal input description. La descrizione non può superare 10000 caratteri
PRIMARY
060068
Incide sulle API:
-
Crea evento
-
Evento impostato
API XML: GetUser restituisce un nuovo elemento di freeAccount
API su cui si è impatto
GetUser
restituisce un nuovo elemento che identifica freeAccount
l'account utente è FreeAccount
o meno.
Modifiche allo schema
Esempio di risposta GetUser
Risposta GetUser:
AW
false
3
false
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à nuovi elementi nominando enableNBRMCModify
e separateNoRecordingEdit
sotto gli strumenti.
Esempio di risposta
RispostaGetSite
:
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:serv="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
Aggiornamenti API 41.6.3
Aggiornamenti all'API XML 41.6.3
GetSite
Response nuovo elemento di supportLargeEvent
Modifiche alle API e allo schema sulle
GetSite: restituisce nuovi elementi nominando supportLargeEvent
in siteCommonOptions
per far sapere al chiamante se il sito supporta o meno Large Event (Webex Event (nuovo)).
Modifica schema
Esempio di risposta
RispostaGetSite
:
GetSite
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:messaggio 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:evento="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</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>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
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 elemento nominando 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:
Ora di inizio applicazione registrazione di XMLAPI LstRecording
API su cui si è impatto
Registrazione Lst
: Risposta LstRecording
CreateTime
come il momento in cui l'utente preme il pulsante di registrazione.
Dettagli
In passato, l'API XML utilizzava il timestamp di quando la registrazione veniva creata nel database come tempo di creazione nella risposta LstRecording
. 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 la PMR utente sia abilitata o meno quando il ruolo utente è l'organizzatore o gli amministratori dei siti di gestione utenti o di sola lettura o completi. -
Imposta utente
: impostahostPIN
utilizzandophones.hostPIN
quandopersonalMeetingRoom.hostPIN
non è nella richiesta XML (pre-condizione: tasto di alternanza funzioneAllowStartScheduledMtgFromPhone
abilitato). -
GetUser
: returnsphones.hostPIN
indipendentemente dall'abilitazione o meno della PMR utente (pre-condizione: tasto di alternanza funzioneAllowStartScheduledMtgFromPhone
abilitato).
Modifiche allo schema
GetUserResponse
:
Imposta utente
:
Esempio di risposta
GetUserResponse
:
Imposta utente
:
XMLAPI GetSite
risposta due nuovi elementi per client mobile
API su cui si è impatto
-
GetSite
:GetSite
ora risponderà a due nuovi elementi per supportare il client mobile con la logica di visualizzazione o meno della scheda di registrazione.-
abilita accesso registrazione
: vero o falso, i super amministratori Webex possono abilitare o disabilitare l'accesso alla registrazione attivando il tasto di alternanza (Abilita accessi registrazione
). -
storageEmptyStatus
: vero o falso, se entrambi i siti non supportano la funzione NBR e hanno assegnato lo spazio di storage NBR come zero, la risposta di stato è vera, altrimenti è falso.
-
Modifiche allo schema
Richiesta di esempio per GetSite
Risposta campione 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 business logic legge il valore di entryExitToneEC
.
Modifiche allo schema
API XML: Esempio di risposta GetSite:
<ns1:valori predefiniti>
<ns1:emailReminders>vero</ns1:emailReminders>
<ns1:entryExitTone>ANNUNCIA</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:teleconferenza>
<ns1:telephonySupport>NESSUNO</ns1:telephonySupport>
</ns1:teleconferenza>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>falso</ns1:updateTSPAccount>
</ns1:valori predefiniti>
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 la riunione Webex è l'evento di grandi dimensioni o webcast, GetSessionInfo restituisce alcune informazioni dettagliate, incluse password numerica della riunione, password numerica del pannello e password numerica del pannello (non è stato modificato alcun
schema).
-
XMLAPI non supporta la creazione e la modifica di eventi di grandi dimensioni o funzionalità Webcast, pertanto CreateMeeting e SetMeeting restituiscono una nuova eccezione
(110064, il tipo di evento e sessione Webcast non è supportato) per eventi di grandi dimensioni o casi
Webcast.
Impatto sulle API
Nome API |
Descrizione |
Osservazione |
---|---|---|
|
Se la Riunione Webex è l'evento di grandi dimensioni o webcast, GetSessionInfo restituisce la password per la riunione, la password numerica della riunione, la password numerica del pannello e la |
Nessuno schema da modificare. |
|
Se l'utente tenta di utilizzare l'API di creazione della riunione per creare una riunione Webex con tipo di sessione di evento di grandi dimensioni oppure chiamare SetMeeting per modificare una riunione Webex che in realtà è un evento di grandi dimensioni o una trasmissione Webcast, restituire una nuova eccezione |
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: GetSessionInfo e GetMeeting elementi di ritorno enableEvent
e enableWebniar
troppo.
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 gli elementi enableEvent
e enableWebniar
per EC 2.0.
GetMeeting
restituisce gli elementi enableEvent
e enableWebniar
per EC 2.0.
Esempio di risposta:
Risposta GetSessionInfo
:
PUBBLICO
false
true
false
false
false
false
true
Risposta GetMeeting
:
false
true
true
true
false
false
true
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
risponderanno al nuovo elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
Modifiche allo schema
L'API XML: GetSite
restituisce l'elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L'API XML: LstSummarySession
restituisce l'elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L'API XML: GetSessionInfo
restituisce l'elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
L'API XML: GetMeeting
restituisce l'elemento enablePreMeetingLobby
per l'area di ingresso virtuale pre-riunione.
Esempio di risposta:
Risposta GetSite
:
false
falso
falso
true
true
true
true
falso
true
true
Risposta LstSummarySession
:
false
true
0
false
false
false
true
Risposta GetSessionInfo
:
PUBBLICO
false
true
false
false
false
false
true
Risposta GetMeeting
:
false
true
true
true
false
false
true
Il cambiamento di comportamento delle informazioni di risposta dell'API XML GetSite
rivela
API su cui si è impatto
L'API XML: GetSite
risposta solo sotto gli elementi per l'account amministratore, che includono i ruoli: Amministrazione sito
, RO_Amministrazione sito
e Amministrazione utente
.
...
...
...
...
...
...
Funzionamento modificato
Consenti solo il ruolo di amministratore con dati della licenza di risposta di GetSite
. L'organizzatore o il partecipante non otterrà tali dati di licenza nella risposta
GetSite.
Di seguito è riportata l'API: Esempio di risposta di GetSite
per siteadmin
o siteadmin
solo pronta o amministrazione 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
possono aggiornare l'elementocmrHybridVoip
seIsWebexTelephony
è vero insieme ad altre condizioni.IsTSPUsingTelephonyAPI
non è più consequenziale.
Modifiche allo schema
API XML: La risposta GetSite
restituisce un elemento aggiuntivo IsWebexTelephony
La risposta GetSite
include questo nuovo elemento:
true
false
Conferenza personale n.
Codice di accesso partecipante
Codice di accesso organizzatore
ID partecipante
.....
LstSummarySession
supporta EC2.0
Sulle API XML
LstSummarySession
restituirà due nuovi elementi a supporto di 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: SessioneRiepilogoLst
: Aggiungi gli elementi <enableEvent
> e <enableWebniar
>
Risposta dell'API XML: Sessione LstSummarySession
Risposta per EC 2.0
true
0
false
true
true
XMLAPI supporta la restituzione dell'opzione dell'assistente vocale Webex per l'utente
del sito 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 state apportate modifiche allo schema dello schema API XML 41.1.