- Home
- /
- Articolo
Panoramica sugli aggiornamenti API Cisco Webex Meetings (API 40)
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 41, vedere la Panoramica sugli aggiornamenti dell'API Cisco Webex Meetings (API 41)
Per ulteriori informazioni sull'API XML 39 e sull'API XML 11, vedere Panoramica sugli aggiornamenti dell'API XML cisco Webex Meetings (API XML 39 e precedenti).
Per gli aggiornamenti per l'API XML 11 SP9 e precedenti, andare a Cisco DevNet.
Aggiornamenti API 40.12.0
Aggiornamenti all'API XML 40.12.0
L'API XML supporta il tipo di riunione privata
Sulle API XML
-
È possibile utilizzare l'API:
CreateMeeting
eSetMeeting
per pianificare o aggiornare una riunione Webex con tipo di riunione privata. -
Se viene pianificata una riunione Webex con tipo di riunione privata,
GetSessionInfo
GetMeeting
,LstSummarySession e
LstCalendarSession restituirannoun
nuovo elemento di denominazione come PrivateMeeting per conoscerlo.
-
GetMeetingType
eLstMeetingType
restituiscono un nuovo elemento che nomina
che indica se supporta o meno riunioni private.SupportPrivateMeeting
Modifiche allo schema
API XML: GetMeetingType/LstMeetingType: Aggiungere l'elemento .
API XML: SessioneRiepilogoLst
: Aggiungere l'elemento .
API XML: SessioneLstCalendar
: Aggiungere l'elemento .
API XML: GetSessionInfo
: Aggiungere l'elemento .
API XML: GetMeeting: Aggiungere l'elemento .
Richiesta di API XML: Creameeting
Richiesta di Creazione riunione con tipo di riunione privata
25/10/2020 13:00:00
45
45
;********
MC_PrivateMeeting_Test
168 //169 è un campione che supporta riunioni private
Risposta dell'API XML: GetSessionInfo
Risposta per èRiunionePrivata
falso
vero
vero //vero: la riunione supporta riunioni private; False: la riunione non supporta la riunione privata.
falso
falso
true
L'API GetSite restituirà i modelli di riunione a livello di sito
Storia dell'utente/descrizione del compito
L'API GetSite per restituire il modello di riunione a livello di sito. Ciò consentirà a Education Connector e Webex Classrooms di mostrare questi modelli agli insegnanti per scegliere e scegliere questi modelli durante la pianificazione delle sessioni on-line.
API su cui si è impatto
Se sono disponibili modelli di riunione personalizzati a livello di sito, l'api GetSite restituirà questi modelli a livello di sito.
Nome elementi |
Descrizione |
---|---|
|
il nome dei modelli di riunione personalizzati a livello di sito |
|
Webex Meetings, Webex Training e Webex Events |
Modifiche allo schema
GetSite : Aggiungere l'elemento .
Esempio di risposta
Risposta GetSite
3
PRO
MC Meeting Tempalte 1
MeetingCenter
Tempalte riunione EC 2
EventCenter
Modello riunione TC 3
TrainingCenter
SetUser api XML non può modificare elemento di supportedServices
quando il sito è un sito CI unified
Descrizione
SetUser XMLAPI non supporta la modifica del valore di " supportedServices " in una richiesta API quando il sito è un hub di controllo collegato a siti
Webex Meeting Unified.
Modifiche allo schema
Non è stata apportata alcuna modifica allo schema sull'API: Imposta utente
.
WEBEX-15436: Aggiungi protezione per evitare duplicati e-mail in Mtgconfattendeelist
Descrizione
Se più partecipanti con lo stesso messaggio e-mail vengono aggiunti alla stessa riunione nella stessa richiesta API, il primo partecipante viene processato solo con l'e-mail.
API su cui si è impatto
-
CreameetingAttendee
-
Createuser
-
Setuser
-
Creameeting
-
Gruppo SetMeeting
-
Crea evento
-
Evento impostato
-
Creazione di una sessione di formazione
-
Sessione di formazione
API di esempio
Richiedi
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:messaggio xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<intestazione>
<securityContext>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>password</password>
</securityContext>
</intestazione>
<corpo>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<sessionKey>1714904382</sessionKey>
<persona>
<email>test@webex.com</email>
<name>name1</name>
</persona>
<partecipanti>
<persona>
<email>test@webex.com</email>
<name>name2</name>
</persona>
<sessionKey>1714904382</sessionKey>
</partecipanti>
</bodyContent>
</corpo>
Aggiornamenti API 40.11.0
Aggiornamenti all'API XML 40.11.0
XmlAPI CreateUser supporta il nome visualizzato
CreateUser
supporta dispalyname
quando il tasto di alternanza funzione EnableDisplayName
è 1. Se l'interruttore della funzione non è 1, il displayName
verrà ignorato.
Modifiche allo schema
Createuser:
SetUser XMLAPI supporta il nome visualizzato
SetUser
supporta dispalyname
quando il tasto di alternanza funzione EnableDisplayName
è 1. Se l'interruttore della funzione non è 1, il displayName
verrà ignorato.
Modifiche allo schema
Setuser:
XMLAPI GetUser supporta il nome visualizzato
GetUser
supporta dispalyname
quando il tasto di alternanza funzione EnableDisplayName
è 1. Se l'interruttore della funzione non è 1, il displayName
non verrà visualizzato.
Se displayName in DB è nullo e l'interruttore funzione EnableDisplayName è
1,
displayName sarà
firstName+" "+lastName per i caratteri non asiatici e
firstName+lastName per
i caratteri asiatici.
Modifiche allo schema
GetUserResponse:
Controllo del livello utente XMLAPI per Voip CMR Hybrid
L'impostazione cmrHybridVoip viene utilizzata per impostare e recuperare l'impostazione a livello di utente per
EnableCMRHybridVoIP.
Modifiche allo schema
Risposta GetUser:
Richiesta CreateUser:
Richiesta SetUser:
Aggiornamenti API 40.10.0
Aggiornamenti all'API XML 40.10.0
Supporto API XML per UUID riunione
in richiesta e risposta API
API XML di esempio: Richiesta GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
Risposta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:isLocked>falso</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API interessata:
-
CreameetingAttendee
-
DelMeetingAttendee
-
RegistratiMeetingAttendee
-
Crea sessione di teleconferenza
-
Sessione SetTeleconference
-
Sessione GetTeleconference
-
Creazione di una sessione di formazione
-
Sessione di formazione
-
GetTrainingSession
-
Sessione di formazione
-
Crea evento
-
Evento impostato
-
Azione del tipo "Canc"
XMLAPI restituirà un elemento aggiuntivo per la configurazione di Amministrazione sito per disabilitare l'acquisizione della schermata
Il requisito proviene dalla sicurezza: entrambi i bug pentest
e i clienti, come Goldman Sachs. Non desiderano consentire agli utenti finali di acquisire la schermata nell'app Meetings. Molte altre clienti desiderano utilizzare questa funzione per consentire l'acquisizione della schermata. Inoltre, gli utenti di Education desiderano consentire anche l'acquisizione della schermata. Pertanto, sarà presente una configurazione dell'amministratore del sito per tale operazione e XMLAPI restituirà un campo aggiuntivo EnableMobileScreenCapture nella risposta di GetSite per
supportare questa operazione.
Esempio di richiesta GetSite
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<intestazione>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Test</webExID>
<password>xxxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</corpo>
<?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:siteInstance>
...
<ns1:securityOptions>
...
...
<ns1:EnableMobileScreenCapture>false</ns1:EnableMobileScreenCapture>
...
</ns1:securityOptions>
...
</ns1:siteInstance>
</serv:bodyContent>
</ser
API interessata
GetSite
Miglioramenti all'accesso senza PIN MEET-269 supporto XMLAPI
XMLAPI aggiunge una NUOVA OPZIONE I sistemi di videoconferenza nella mia organizzazione possono avviare e partecipare alle riunioni senza prompt per la riunione nella sala riunioni personale e la riunione MC.
-
createUser/setUser/getUser
aggiungi un nuovo nododeviceCanStartMyPMR
inpersonalMeetingRoom
. -
CreateMeeting/setMeeting/getMeeting
aggiungi un nuovo nododeviceCanStartMeeting
nella pianificazione.
L'opzione nell'interfaccia utente Webex per la riunione nella sala riunioni personale:
Modifiche allo schema
Createuser:
Setuser:
getUserResponse:
Creameeting:
setMeeting:
getMeetingResponse:
Aggiornamenti API 40.9.0
Aggiornamenti all'API XML 40.9.0
Supporto API XML per richiesta e risposta UUID
riunione
L'UUID della riunione è stato aggiunto alla richiesta e alla risposta API ovunque sia supporto come meetingKey
o sessionKey
.
API XML di esempio: Richiesta GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
Risposta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:isLocked>falso</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API interessata:
-
GetEnrollmentInfo
-
LstsummaryTrainingSession
-
Aggiungi test pianificato
-
Imposta test pianificato
-
Test pianificato
-
Informazioni getTestInformazioni
-
Carica evento evento
-
Invia e-mail diinvita
-
Creasessione disupporto
-
LstmeetingusagePreliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
LsteventsessionPreliminaryHistory
-
LsteventattendeePreliminaryHistory
-
LstTrainingPollResultsHistory
Le riunioni Webex dispongono di un'area di ingresso della riunione bloccata in cui gli utenti possono attendere di essere ammessi alla riunione
Pianificazione e modifica della riunione MC dell'API XML per supportare l'area di ingresso bloccata quando la funzione (ConsistentLockedLobby
) viene attivata.
Modifiche allo schema
Aggiunti tre nuovi elementi (externalAttendeeSecurity
, autoLock
, autoLockWaitTime ) alle API
CreateMeeting, SetMeeting e GetMeeting.
Elemento |
Descrizione |
---|---|
|
Quando la riunione viene sbloccata, possono essere disponibili tre elementi Di sicurezza utente esterno.
|
|
Se bloccare automaticamente la riunione. Vero: Blocca automaticamente la riunione dopo # minuti dopo l'inizio della riunione Falso: Non blocca automaticamente la riunione dopo l'inizio della riunione |
|
Minuti(0,5,10,15,20 ) per il blocco automatico dellariunione dopo l'inizio della riunione |
Esempio di richiesta e risposta
Richiesta di Creazione riunione:
...
...
false
AllowJoinWithLobby
true
10
...
Richiesta di SetMeeting:
2###1###01
...
...
false
AllowJoinWithLobby
true
10
...
Risposta di GetMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<meet:attendeeOptions>
...
<meet:joinRequiresAccount>falso</meet:joinRequiresAccount>
<meet:externalAttendeeSecurity>AllowJoin</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...
</serv:message>
API interessata:
-
Creameeting
-
Gruppo SetMeeting
-
GetMeeting
Potenziamento dell'API GetSessionInfo
per ripristinare lo stato dei partecipanti nella sessione in corso
Aggiunti due nuovi elementi (hasHostInMeeting
, hasAttendeeInMeeting
) in risposta a GetSessionInfo
. Questi due elementi verranno restituiti quando la riunione è una riunione in corso.
Elemento |
Descrizione |
---|---|
|
Se l'organizzatore si è unito alla riunione in corso. Vero: L'organizzatore è in riunione in corso. Falso/Nulla: L'organizzatore non è in riunione in corso oppure la riunione non è in corso. |
|
Se un partecipante/organizzatore si è unito alla riunione in corso. Vero: è presente un partecipante o un organizzatore nella riunione in corso. Falso/Nulla: non è presente alcun partecipante od organizzatore nella riunione in corso oppure la riunione non è in corso. |
Esempio di risposta API:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ep:status>IN CORSO</ep:status>
<ep:hasHostInMeeting>vero</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
...
</serv:message>
API interessata:
GetSessionInfo
L'API GetUserCard richiede l'autorizzazione.
Il miglioramento della sicurezza dell'API XML GetUserCard
richiede l'autorizzazione a ottenere le informazioni dell'utente.
API interessata:
Scarica scheda utente
Aggiornamenti API 40.8.0
Aggiornamenti all'API XML 40.8.0
Miglioramento della risposta GetSessionInfo
Se non si è stati invitati o approvati dalla riunione, la chiamata all'API XML: GetSessionInfo
non restituisce gli elementi: confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
nel corpo di risposta API.
Esempio di risposta API per le riunioni:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>NON IN ELENCO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>vero</ep:passwordReq>
<ep:isRegisterIDRequired>falso</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>MeetingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>falso</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>vero</ep:isAllowJBH>
<ep:isCETMeeting>vero</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
Esempio di risposta API per Trainings/Events:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>NON IN ELENCO</ep:listStatus>
<ep:registration>vero</ep:registration>
https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>vero</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>INVITO/REGISTRAZIONE/RIFIUTO</ep:joinStatus>
<ep:isRegisterIDRequired>falso</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>TrainingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>falso</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>vero</ep:isAllowJBH>
<ep:isCETMeeting>vero</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
API interessata:
-
GetSessionInfo
Miglioramenti alla sicurezza di GetSessionInfo, GetUserCard
È stato apportato un miglioramento alla sicurezza sull'API XML GetSessionInfo
e GetUserCard
. Gli utenti non potranno accedere a queste due API nelle prossime due ore se la chiamata raggiungerà il limite in un'ora senza errori rilevati dati.
La risposta di stato dell'errore è: "403 Vietato"
API interessate:-
GetSessionInfo
-
Scarica scheda utente
meetingUUID
in supporto di richieste e risposte API
MeetingUUID è stato aggiunto alla richiesta e alla risposta API ovunque sia supporto per meetingKey/sessionKey
.
Richiesta GetSessionInfo
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
Risposta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:isLocked>falso</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API interessata:
-
Sessione LstOpen
-
GetEnrollmentInfo
-
LstsummaryMeeting
-
Test pianificati Lst
-
Ottieni evento
-
LstsummaryEvent
-
LstmeetingusageHistory
-
LsttrainingsessionHistory
-
Sessione LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSessione
Modello di sito Education (tipo di sessione EDU) nel supporto API XML
Se i siti abilitano il tipo di sessione Istruttore education (EDU), l'API XML può supportare per pianificare una riunione con il modello di riunione EDU.
API interessata:
-
Creameeting
-
Gruppo SetMeeting
-
Crea evento
-
Evento impostato
-
Creazione di una sessione di formazione
-
Sessione di formazione
Supporto api XML CreateMeetingAttendee
e RegisterMeetingAttendee
Sia CreateMeetingAttendee che
RegisterMeetingAttendee sono in grado di controllare il modulo di iscrizione partecipante richiesto per l'iscrizione
a Webex Meetings.
Ed è presente una nuova eccezione per questa attività:
Numero di eccezione |
Messaggio di eccezione |
---|---|
040014 |
Campi obbligatori mancanti (modulo di registrazione): ... |
Ad esempio, se sono stati selezionati "Titolo professionale" e "Nome società" come campi obbligatori per l'iscrizione a Webex Meetings del partecipante come mostrato di seguito, sarà necessario fornire il valore su "Titolo del lavoro" e "Nome società" quando si chiamano le due API: CreateMeetingAttendee
e RegisterMeetingAttendee
.
Richiesta di iscrizioneMeetingAttendee
:
FirstNameb LastName
FirstNameb
LastName
Ingegnere //Job Title
Cisco1234 //Company Name
...
;****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1####4####1
Richiesta CreateMeetingAttendee
:
FirstNameA LastNameA
FirstNameA
LastNameA
Engineer //Job Title
Cisco1234 //Company Name
...
;*****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1###4####1
040014 Eccezione della risposta
Esempio:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:result>ERRORE</serv:result>
Campi obbligatori mancanti (modulo di registrazione): titolo,società
PRIMARY
040014
titolo,società
API interessata:
-
CreameetingAttendee
-
RegistratiMeetingAttendee
Miglioramenti alla convalida e-mail dell'API XML
L'API XML non deve consentire caratteri di spazio vuoto in un messaggio e-mail, pertanto è stata migliorata la convalida e-mail per allinearsi al funzionamento della pagina Webex Meetings.
API interessata:
-
CreameetingAttendee
-
Crea evento
-
Evento impostato
-
Creacontatto
-
SetContact
-
Informazioni di registrazione
-
CreameetingAttendee
-
Creazione di una sessione di formazione
-
Sessione di formazione
-
Createuser
-
Setuser
-
Creameeting
-
Gruppo SetMeeting
-
RegistratiMeetingAttendee
Aggiornamenti API 40.7.0
Aggiornamenti all'API XML 40.7.0
supporto
UUID riunione
MeetingUUID è stato aggiunto alla richiesta e alla risposta API ovunque sia supportata una meetingKey o sessionKey.
Esempio di richiesta
GetSessionInfo:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
Esempio di richiesta
GetSessionInfo:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
Esempio di risposta
GetSessionInfo:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:isLocked>falso</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API interessate:
-
LstmeetingattendeeHistory
-
LsttrainingattendeeHistory
-
LsteventattendeeHistory
-
LstsupportattendeeHistory
Supporto e-mail di benvenuto all'API CreateUser
per quattro nuove lingue
Il messaggio e-mail di benvenuto XMLAPI html supporta le quattro nuove lingue seguenti:
-
Ceco (languageID=19)
-
Polacco (languageID=20)
-
Ungherese (languageID=21)
-
Lingue (languageID=22)
XMLAPI invia il messaggio e-mail di benvenuto in base alla lingua o al languageID nella richiesta
CreateUser.
Uso di CreateUser
per inviare l'esempio di e-mail di benvenuto Html (Ceco):
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>test</firstName>
<lastName>utente</lastName>
<webExId>testuser</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<privilegio>
<host>vero</host>
</privilegio>
<languageID>19</languageID>
oppure
<language>Ceco</language>
<active>ATTIVATO</active>
<sendWelcome>vero</sendWelcome>
<isHTMLEmail>vero</isHTMLEmail>
</bodyContent>
</bodyContent>
</corpo>
Aggiornamenti API 40.6.1, 40.4.9
Aggiornamenti all'API XML 40.6.1, 40.4.9
Supporto CreateMeeting/SetMeeting
Quando si pianifica una riunione Webex, la creazione della riunione nell'API XML CreateMeeting/SetMeeting consente di selezionare o deselezionare o fare clic su un campo obbligatorio o non richiesto dal modulo di iscrizione del
partecipante.
Di seguito viene fornito un esempio della pianificazione Meetings dalla pagina Web dell'utente in cui è possibile controllare i campi obbligatori come "Titolo professionale", "Nome società", "Città" e "Stato" nel modulo di iscrizione del partecipante:
Di seguito è riportata un'associazione tra i campi pagina e gli elementi dell'API XML:
Campi pagina | Elemento XMLAPI |
---|---|
Professione | |
Nome società | |
Indirizzo 1 | |
Indirizzo 2 | |
Città | |
Stato | |
CAP/Codice postale | |
Paese/Regione | |
Telefono (ufficio) | |
Fax |
Schema modificato: Aggiungi elemento "registrationForm" in CreateMeeting
Schema modificato: Aggiungi elemento "registrationForm" in SetMeeting
Schema modificato: Aggiungi elemento "registrationForm" in GetMeeting
Esempio di richiesta CreateMeeting
:
<accessControl>
<meetingPassword>password</meetingPassword>
</accessControl>
<attendeeOptions>
<emailInvitations>vero</emailInvitations>
<registration>vero</registration>
<auto>falso</auto>
</attendeeOptions>
<modulo di registrazione>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>falso</req></address1>
<address2><req>falso</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>falso</req></postalCode>
<country><req>falso</req></country>
<phone><req>falso</req></phone>
<fax><req>falso</req></fax>
</modulo di registrazione>
Esempio di richiesta di SetMeeting
:
<meetingkey>1015045339</meetingkey>
<metaData>
<confName>Nome conferenza</confName>
<meetingType>3</meetingType>
</metaData>
<attendeeOptions>
<emailInvitations>vero</emailInvitations>
<registration>vero</registration>
<auto>vero</auto>
</attendeeOptions>
<modulo di registrazione>
<title><req>vero</req></title>
<company><req>vero</req></company>
<address1><req>falso</req></address1>
<address2><req>falso</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>falso</req></postalCode>
<country><req>falso</req></country>
<phone><req>falso</req></phone>
<fax><req>falso</req></fax>
</modulo di registrazione>
Esempio di risposta
GetMeeting:
1234567890@nomesito.webex.com
1234567890@nomesito.webex.com
falso
true
vero
false
falso
vero
vero
false
falso
falso
API interessate:
-
Creameeting
-
Gruppo SetMeeting
-
GetMeeting
-
DelMeeting
Il tipo di riunione E2EE non supporta una riunione pmR
Quando si abilita una PMR durante una chiamata con le API:CreateUser/SetUser/GetUser/GetMe
e solo un tipo di riunione E2EE è disponibile, risponderà al seguente messaggio di errore: "110063 L'utente deve disporre di almeno un tipo di riunione non E2EE per abilitare la sala riunioni personale".
API interessate:
-
Createuser
-
Setuser
-
Getuser
-
GetMe
Aggiornamenti API 40.6.0
Aggiornamenti all'API XML 40.6.0
Ruolo di gestione utenti aggiunto
Il ruolo di gestione utenti è stato creato e il file dello schema per quanto segue è stato modificato.
Schema modificato: CreateUser
request:
Schema modificato: Setuser
Schema modificato: GetMe
risposta:
Schema modificato: Risposta utente
Lstsummary:
API interessate:
-
Createuser
-
Setuser
-
GetMe
-
Utente Lstsummary
Esempio di richiesta CreateUser
:
<?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>
<siteName>xxx</siteName>
<webExID>Amministrazione sito</webExID>
<password>xxxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<nome>xxx</nome>
<cognome>xxx</cognome>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilegio>
<umSiteAdmin>true</umSiteAdmin>
<host>falso</host>
<siteAdmin>false</siteAdmin>
<labAdmin>falso</labAdmin>
<voiceOverIp>falso</voiceOverIp>
</privilegio>
<languageID>3</languageID>
<active>ATTIVATO</active>
<sendWelcome>vero</sendWelcome>
<isHTMLEmail>vero</isHTMLEmail>
</bodyContent>
</corpo>
Supporto mediante chiave API accesso a GetUserCard
L'uso della chiave API (token JRINO generato) consente ora l'accesso all'API: GetUserCard
in questa release.
È possibile fare riferimento a queste pagine sull'applicazione di una chiave API e per generare un token JRINO:
Come generare il token J GENERE
Esempio di richiesta GetUserCard
:
POST https://{sitename}.webex.com/WBXService/XMLService
Intestazione:
Content-Type application/json;charset=utf-8
JWTToken ${jwttoken}
Body:
<?xml version="1.0" encoding="UTF-8"?>
<message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2009/05/service">
<header>
<securityContext>
<siteName>{sitename}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUserCard">
<webExId>{userName}</webExId>
</bodyContent>
</body>
Esempio di risposta:
<?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:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:url>https://xxxx.webex.com/svc3300/svccomponents/html/img/avatar160.png</use:url>
<use:lastModifiedTime>1587493389768</use:lastModifiedTime>
<use:isUploaded>false</use:isUploaded>
</use:avatar>
<use:title>Test della sala riunioni personale</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
Supporto per meetingUUID
in richiesta e risposta API
MeetingUUID è stato aggiunto alla richiesta e alla risposta dell'API quando viene supporto meetingKey o sessionKey.
API interessate:
-
LstRecording
-
Sessione Lstsummary
-
GetSesssionInfo
-
Nome hosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
Creameeting
-
Gruppo SetMeeting
-
GetMeeting
-
DelMeeting
-
Sessione LstCalendar
meetingUUID
Esempio di richiesta:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
oppure
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</corpo>
meetingUUID
Esempio di risposta:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_IN CORSO</ep:status>
<ep:isLocked>falso</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
Le chiavi della riunione PMR non verranno modificate da un utente temporaneamente disattivato o disabilitato la sala riunioni riunioni
Se un utente disattivato temporaneamente o disabilitato la sala riunioni riunioni (PMR) viene riattivato entro una settimana, la chiave della riunione della pmR riattivata o abilitata non viene modificata, la stessa sarà uguale a prima.
API interessate:
-
Setuser
-
Utente Del
Miglioramenti alla sessione
LstSummary
L'API è stata migliorata: LstSummarySession
Return scheduled-PMR per avere un nuovo elemento, returnScheduledPMR
, nella richiesta. L'interruttore della funzione è disattivato per impostazione predefinita.
API interessate:
-
Sessione LstSummarySession
Modifica schema:
Aggiungere un nuovo nome di elemento returnScheduledPMR
nella richiesta API LstSummarySession.
Aggiungere un nuovo nome di elemento isScheduledPMR
nella risposta API LstSummarySession.
Esempio di richiesta di LstSummarySession
:
<?xml version="1.0" encoding="UTF-8"?>
<serv:messaggio xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<intestazione>
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>E</listMethod>
</listControl>
<dateScope>
<startDateStart>11/01/2019 8:0:0</startDateStart>
<startDateEnd>01/12/2019 7:59:59</startDateEnd>
4
<endDateStart>11/01/2019 8:0:0</endDateStart>
<endDateEnd>01/12/2019 7:59:59</endDateEnd>
</dateAmbito>
<ordine>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</ordinare>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
<returnScheduledPMR>true</returnScheduledPMR>
</bodyContent>
</corpo>
Esempio di risposta a LstSummarySession
:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="ep:lstsummarySessionResponse">
<ep:matchingRecords>
<serv:total>1787</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</ep:matchingRecords>
<ep:session>
<ep:sessionKey>809914325</ep:sessionKey>
<ep:MeetingUUID>809914325</ep:MeetingUUID>
<ep:confName>Riunione di team</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Test</ep:hostWebExID>
<ep:hostFirstName>Test</ep:hostFirstName>
<ep:hostLastName>Test</ep:hostLastName>
<ep:otherHostWebExID>Test</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Hawaii (Honolulu)</ep:timeZone>
<ep:status>NON_IN CORSO</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBBLICO</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>vero</ep:passwordReq>
<ep:hostJoined>falso</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>falso</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>falso</ep:isAudioOnly>
<ep:isTCSingleRecurrence>falso</ep:isTCSingleRecurrence>
<ep:isAllowJBH>falso</ep:isAllowJBH>
<ep:isCETMeeting>vero</ep:isCETMeeting>
<ep:isException>falso</ep:isException>
<ep:isNextUpcomingInstance>falso</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurringId>0</ep:recurringId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:session>
<ep:session>
<ep:sessionKey>805660167</ep:sessionKey>
<ep:confName>xmlmc Molly08Console816960001</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Molly08Console81696000</ep:hostWebExID>
<ep:hostFirstName>Molly08Console81696000</ep:hostFirstName>
<ep:hostLastName>Molly08Console81696000</ep:hostLastName>
<ep:otherHostWebExID>Molly08Console81696000</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Hawaii (Honolulu)</ep:timeZone>
<ep:status>NON_IN CORSO</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBBLICO</ep:listStatus>
<ep:hostEmail>Molly08Console81696000@webex.com</ep:hostEmail>
<ep:passwordReq>vero</ep:passwordReq>
<ep:hostJoined>falso</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>falso</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>falso</ep:isAudioOnly>
<ep:isTCSingleRecurrence>falso</ep:isTCSingleRecurrence>
<ep:isAllowJBH>falso</ep:isAllowJBH>
<ep:isCETMeeting>vero</ep:isCETMeeting>
<ep:isException>falso</ep:isException>
<ep:isNextUpcomingInstance>falso</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurringId>0</ep:recurringId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:session>
</serv:bodyContent>
Miglioramenti a GetSite
È stato aggiunto un interruttore della funzione di risposta GetSite
di SupportXMLAPIReturnScheduledPMR
API interessate:
-
GetSite
Modifica schema:
Nuovo elemento risposta API XML
GetSite: SupportXMLAPIReturnScheduledPMR
Esempio di richiesta GetSite
:
<?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>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
Esempio di risposta
GetSite:
<?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: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:siteInstance>
<ns1:siteCommonOptions>
...
<ns1:SupportXMLAPIReturnScheduledPMR>true</ns1:SupportXMLAPIReturnScheduledPMR>
...
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
Aggiornamenti API 40.4.8, 40.2.9
Aggiornamenti all'API XML 40.4.8, 40.2.9
Nuova risposta all'aggiornamento delle riunioni pianificate in XMLAPI
Se i clienti utilizzano XMLAPI per aggiornare le riunioni pianificate attraverso la relativa pagina, la password numerica verrà inviata in un aggiornamento e-mail per la riunione e la si applicherà alle applicazioni Center Webex Meetings, Teams ed Events.
Api seguenti: GetMeeting, GetTrainingSession, GetEvent
e GetTeleconferenceSession
, avranno come risposta questi nuovi elementi: audioPassword
(password numerica), isEnforceAudioPassword
, isEnforceAudioLogin
per le applicazioni Webex Meetings, Teams ed Events Center.
Schema modificato:
API interessate:
-
GetMeeting
-
GetTrainingSession
-
Ottieni evento
-
Sessione GetTeleconference
Esempio di richiesta GetMeeting
:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
<securityContext>
<siteName>testSite</siteName>
<webExID>test</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</body>
Esempio di risposta:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:accessControl>
<meet:listToPublic>falso</meet:listToPublic>
<meet:isPublic>falso</meet:isPublic>
<meet:meetingPassword>PkzC8tP7kM5</meet:meetingPassword>
<meet:audioPassword>75928877</meet:audioPassword>
<meet:isEnforceAudioPassword>vero</meet:isEnforceAudioPassword>
<meet:isEnforceAudioLogin>falso</meet:isEnforceAudioLogin>
</meet:accessControl>
...
...
</serv:bodyContent>
Aggiornamenti API 40.4.5, 40.2.6
Aggiornamenti all'API XML 40.4.5, 40.2.6
Limite di utilizzo GetUserCard
e GetSessionInfo
Implementiamo il limite di utilizzo su API GetUserCard
e GetSessionInfo
, è possibile ottenere il messaggio di errore: "403 vietato" se si raggiunge il limite di utilizzo.
API interessate:
-
Scarica scheda utente
-
GetSessionInfo
Api 40.4.4, 40.2.5 Aggiornamenti
Aggiornamenti all'API XML 40.4.4, 40.2.5
Limite di numero contenuto
corpo
È stato aggiunto un numero limitato di BodyContent
in ciascuna sezione dell'API XML. Quando si aggiunge un numero eccessivo di BodyContent
nella richiesta API, vengono restituiti il seguente codice di errore e messaggio: "000053 Il conteggio di BodyContent in una richiesta deve essere inferiore a {number}"
API interessate:
-
Qualsiasi API XML
Esempio di richiesta API XML con più contenuti corporei
:
<?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>xxxx</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser">
<webExId>xxx</webExId>
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetSite">
</bodyContent>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>801020403</sessionKey>
</bodyContent>
</body>
Aggiornamenti API 40.4.3, 40.2.4
Aggiornamenti ALL'API XML 40.4.3, 40.2.4
Fare clic qui per scaricare lo schema XML API 40.4.3, 40.2.4.
Miglioramenti CreateUser
È stato migliorato CreateUser
per supportare il messaggio e-mail di benvenuto in più lingue. Le richieste di CreateUser
ora sonoHTMLEmail
API interessate:
-
Createuser
Esempio di richiesta CreateUser
:
<?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>amministratore</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<nome>xxx</nome>
<cognome>xxx</cognome>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilegio>
<host>vero</host>
<siteAdmin>false</siteAdmin>
<labAdmin>falso</labAdmin>
<voiceOverIp>falso</voiceOverIp>
</privilegio>
<languageID>3</languageID>
<active>ATTIVATO</active>
<sendWelcome>vero</sendWelcome>
<isHTMLEmail>vero</isHTMLEmail>
</bodyContent>
</corpo>
Aggiornamenti API 40.4.0
Aggiornamenti all'API XML 40.4.0
Applica verifica e-mail quando si modificano messaggi e-mail nell'API XML
Dopo che un amministratore del sito ha abilitato l'opzione Conferma richiesta all'utente per l'aggiornamento dell'indirizzo e-mail in Amministrazione sito Webex:
-
Se un account non amministratore del sito chiama l'API SetUser per modificare gli indirizzi e-mail, il messaggio e-mail corrente rimane fino a quando
non viene verificato il nuovo messaggio
e-mail. Il messaggio e-mail di conferma della modifica dell'account viene inviato al nuovo indirizzo e-mail con la conferma della modifica dell'account Webex. Dopo aver fatto clic sul collegamento nel messaggio e-mail per confermare, il nuovo indirizzo e-mail viene immediatamente collegato.Se un amministratore non del sito chiama più volte l'API SetUser senza completare il processo di verifica e-mail, l'e-mail corrente viene mantenuto e l'ultimo messaggio e-mail nuovo è quello che
deve essere verificato.
-
Se l'account di un amministratore del sito chiama l'API SetUser per modificare gli indirizzi e-mail, il processo di verifica
e-mail non viene attivato. Il nuovo messaggio e-mail verrà collegato immediatamente all'account dell'organizzatore o del partecipante.
API interessate:
-
Setuser
Timeout GetEnrollmentInfo
e reimpostazione della connessione
L'API GetEnrollmentInfo ricerca attualmente gli indirizzi IP nel sistema dei nomi di dominio, il che incide su un notevole impatto sulle prestazioni. Intendiamo semplificare questo processo, con una risposta vuota nel campo
.
API interessate:
-
GetEnrollmentInfo
Esempio di richiesta GetEnrollmentInfo
:
<?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>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
Esempio di risposta a GetEnrollmentInfo
:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="att:getEnrollmentInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<att:sessione>
<att:confID>154279066999981548</att:confID>
<att:partecipante>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>Alex</att:firstName>
<att:lastName>Yang</att:lastName>
<att:email>omega.alex.yang@gmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:indirizzo1></att:indirizzo1>
<att:indirizzo2></att:indirizzo2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:dominio> </att:dominio>
<att:ipAddress>10.35.240.53</att:ipAddress>
<att:submitTime>27/02/2020 22:03:57</att:submitTime>
<att:status>APPROVATO</att:status>
</att:partecipante>
<att:partecipante>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>Test</att:lastName>
<att:email>achillesyang@hotmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:indirizzo1></att:indirizzo1>
<att:indirizzo2></att:indirizzo2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:dominio> </att:dominio>
<att:ipAddress>10.154.181.15</att:ipAddress>
<att:submitTime>27/02/2020 22:07:38</att:submitTime>
<att:status>APPROVATO</att:status>
</att:partecipante>
<att:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</att:matchingRecords>
<att:sessionKey>716773566</att:sessionKey>
</att:session>
</serv:bodyContent>
Aggiornamenti API 40.2.0
Aggiornamenti all'API XML 40.2.0
Rimuovi accesso anonimo a LstSummarySession
Come miglioramento della sicurezza, viene interrotto il supporto per l'accesso anonimo all'API LstSummarySession.
Se Webex Meetings accede in modo anonimo all'API, vengono restituiti il seguente codice di errore e messaggio: "000015 Spiacenti, nessun record trovato".
API interessate:
-
Sessione LstSummarySession
Esempio di richiesta di LstSummarySession
:
<?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>
<siteName>sitename1</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
Esempio di risposta a LstSummarySession
:
<?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:ep="http://www.webex.com/schemas/2002/06/service/ep" xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result>FAILURE</serv:result>
<serv:reason>Sorry, no record found</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Miglioramenti alla sicurezza CreateMeeting
e SetMeeting
Questa modifica è stata effettuata nell'API XML 40.2.0, ma la relativa descrizione è stata modificata in seguito alla ricezione del feedback dei clienti.
Come miglioramento della sicurezza, sono state aggiornate le API CreateMeeting e SetMeeting in modo da non consentire agli utenti di pianificare un'ora di inizio della riunione
già
trascorsa. Se si tenta, l'API richiede il messaggio di errore: "060016 L'ora di inizio della sessione deve essere successiva all'ora corrente". Se un utente deve pianificare una riunione immediata, si consiglia di impostare l'ora di inizio della riunione cinque minuti dopo l'ora corrente.
API interessate:
-
Creameeting
-
Gruppo SetMeeting
Aggiornamenti API 40.1.2
Aggiornamenti all'API XML 40.1.2
La pianificazione di una riunione genera automaticamente una password, se non è stata fornita una password
Sono stati migliorati CreateMeeting,
CreateEvent,
CreateTrainingSession
e CreateTeleconferenceSession
per includere una password nel corpo della risposta API.
Per impostazione predefinita, l'impostazione Tutte le riunioni/eventi/sessioni devono avere una password è abilitata. In questo scenario, se la richiesta API non include una password, viene generata automaticamente una password dai server API XML.
Se l'impostazione Tutte le riunioni/eventi/sessioni deve essere disabilitata e la richiesta API non include una password, non viene generata una password dai server API XML.
Se la richiesta API include una password, la risposta includerà tale password, a prescindere dal fatto che l'impostazione Tutte le riunioni/eventi/sessioni devono essere abilitate o disabilitate.
API interessate:
-
Creameeting
-
Crea evento
-
Creazione di una sessione di formazione
-
Crea sessione di teleconferenza
La risposta CreateMeeting
ora presenta l'elemento
meetingPassword:
Esempio di richiesta CreateMeeting
:
<?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>
<siteName>siteName1</siteName>
<webExID>USERID</webExID>
<password>*****</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<metaData>
<confName>Test_Auto_Generated_mtg_pwd</confName>
<meetingType>3</meetingType>
</metaData>
<schedule>
<startDate>28/10/2020 17:35:00</startDate>
</schedule>
</bodyContent>
</body>
</serv:
Esempio di risposta CreateMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:risposta>
<serv:result>SUCCESSO</serv:result>
<serv:gsbStatus>PRINCIPALE</serv:gsbStatus>
</serv:risposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:createMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:meetingkey>806745263</meet:meetingkey>
<meet:meetingPassword>UzXJuzUD428</meet:meetingPassword>
<meet:iCalendarURL>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
</meet:iCalendarURL>
<meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
</serv:bodyContent>
La risposta CreateEvent
ora presenta l'elemento
eventPassword:
Le risposte CreateTrainingSession
e CreateTeleconferenceSession
ora dispongono dell'elemento sessionPassword:
Aggiornamenti API 40.1.0
Aggiornamenti all'API XML 40.1.0
Miglioramenti a GetSessionInfo
Abbiamo aggiunto nuovi elementi all'API GetSessionInfo. L'API ora restituisce informazioni anche per i dispositivi mobili.
API interessate:
-
GetSessionInfo
Aggiornamenti alla richiesta GetSessionInfo
:
Esempio di richiesta:
<?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>
<siteName>sqdemo11</siteName>
<webExID>amministrazione sito</webExID>
<password>P@ss1234</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>713707633</sessionKey>
https://go.webex.com/join/dongchen</pmrUrl>
<sipUrl>dongchen@go.webex.com o 123456789_go@webex.com o 123456789@go.webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</corpo>
Miglioramenti a LstAccessAnywhereHistory
È stata aggiunta una nuova API, lstAccessAnywhereHistory , per rispondere con le informazioni
del report Webex Access Anywhere.
API interessate:
-
LstAccessAnywhereHistory
Aggiornamenti richiesta LstAccessAnywhereHistory
:
Aggiornamenti sulla risposta a LstAccessAnywhereHistory
:
Esempio di richiesta:
<?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>
<siteName>sqdemo6</siteName>
<webExID>test</webExID>
<password>P@ss1234</password>
</securityContext>
</intestazione>
<corpo>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>29/09/2019 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>29/12/2019 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>29/09/2019 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>29/12/2019 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>OPPURE</serv:listMethod>
</listControl>
<ordine>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</ordinare>
</bodyContent>
</corpo>
Esempio di risposta:
<?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:LstAccessAnywhereHistoryResponse"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:matchingRecords>
<serv:total>775</serv:total>
<serv:returned>10</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
<history:accessAnyWhereInfo>
<history:confID>123456</history:confID>
<history:userName>dean</history:userName>
<history:computerName>6926_dean</history:computerName>
<history:clientIP>10.224.222.183</history:clientIP>
<history:startTime>29/11/2019 03:05:44</history:startTime>
<history:endTime>29/11/2019 03:10:06</history:endTime>
<history:duration>5</history:duration>
</history:accessAnyWhereInfo>
</serv:bodyContent>