Aggiornamenti API 41.12.0

Aggiornamenti dell'API XML 41.12.0

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema dell'API XML 41.5.0.

XMLAPI può avviare riunioni pianificate Webex da PSTN come organizzatore

API interessate

  • CreateUser: genera hostPIN 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: serie hostPIN uso phones.hostPIN quando personalMeetingRoom.hostPIN non è nella richiesta XML (pre-condizione: tasto di alternanza funzione AllowStartScheduledMtgFromPhoneè abilitato).

  • GetUser: rendimenti phones.hostPIN indipendentemente dalla PMR utente abilitata o meno. (pre-condizione: tasto di alternanza funzione AllowStartScheduledMtgFromPhone è 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 interessate

Nessun 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

Fare clic qui per scaricare lo schema 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)

  1. 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).

  2. XMLAPI non supporta la creazione e la modifica di alcun evento o funzione webcast di grandi dimensioni, pertanto CreateMeeting e SetMeeting 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

GetSessionInfo

Se la riunione Webex è l'evento o il webcast di grandi dimensioni, GetSessionInfo restituisce la password della riunione, la password numerica della riunione, la password del coordinatore e la password numerica del coordinatore.

Nessun schema da modificare.

CreateMeeting

SetMeeting

Se l'utente tenta di utilizzare CreateMeeting api per creare una riunione Webex con un tipo di sessione evento di grandi dimensioni o una chiamata SetMeeting per modificare una riunione Webex che è un evento o un webcast di grandi dimensioni, restituire una nuova eccezione 110064. Il tipo di sessione Evento e Webcast non è supportato.

Comportamento da modificare.

Aggiornamenti API 41.3.0

Aggiornamenti dell'API XML 41.3.0

Fare clic qui per scaricare lo schema 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

Fare clic qui per scaricare lo schema 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 elemento IsWebexTelephony nella risposta.

  • CreateUser e SetUser può aggiornare il cmrHybridVoip elemento se IsWebexTelephony è 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.