- Accueil
- /
- Article
l’aperçu des mises à jour de l’API Cisco Webex Meetings (API 40)
Trouvez toutes les informations importantes dont vous avez besoin sur l Cisco Webex Meetings A API, telles que les changements de schémas et autres annonces.
Pour plus d'informations sur l'API XML 41, voir la Présentation des mises à jour de l'API Cisco Webex Meetings (API 41)
Pour plus d’informations sur l’API XML 39 et l’API XML 11, voir l’Aperçu des mises à jour de l’API XML De Cisco Webex Meetings (API XML 39 et antérieure).
Pour les mises à jour pour l’API XML 11 SP9 et version précédente, allez à Cisco DevNet.
Mises à jour API 40.12.0
Mises à jour de l’API XML 40.12.0
L’API XML prend en charge le type de réunion privée
Les API XML doivent être impactées
-
Nous pouvons utiliser l’API :
CreateMeeting
etSetMeeting
pour programmer ou mettre à jour une réunion Webex avec le type de réunion privée. -
Si une réunion Webex est programmée avec type de réunion privée,
GetSessionInfo
GetMeeting ,
LstSummarySession
etLstCalendarSession
retourneront un nouvel élément nommé Réunion privée pour le savoir.
-
GetMeetingType
etLstMeetingType
renvoient un nouvel élément nommant
qui indique s'il prend en charge les réunions privées ou non.SupportPrivateMeeting
Changements de schémas
API XML : GetMeetingType/LstMeetingType : Attachez l'élément .
API XML : SessionRésumé
: Attachez l'élément .
API XML : SessionCalendrierLst
: Attachez l'élément .
API XML : ObtenirInfosSession
: Attachez l'élément .
API XML : Obtenir la réunion : Attachez l'élément .
Demande de l’API XML : Créer unemeeting
Demande de création d’une réunion avec le type de réunion privée
25/10/2020 13:00:00
45
45
;********
MC_PrivateMeeting_Test
168 //169 est un exemple qui prend en charge les réunions privées
Réponse de l’API XML : Obtenir les détails de lassion
Réponse pour isPrivateMeeting
false
true
true //true: la réunion prend en charge les réunions privées ; Faux: la réunion ne prend pas en charge la réunion privée.
false
false
true
L’API Obtenir le site retournera les modèles de réunions au niveau du site
Description de l’histoire/tâche de l’utilisateur
Obtenir L’API du site pour revenir au modèle de réunion au niveau du site. Ceci permettra au connecteur d’éducation et aux classes Webex d’afficher ces modèles pour que les professeurs choisissent et choisissent ces modèles lors de la programmation de leurs sessions en ligne.
Les API sont impactées
S’il existe des modèles de réunion personnalisés au niveau du site, l’api GetSite renvoie ces modèles au niveau du site.
Nom des éléments |
Description |
---|---|
|
le nom des modèles de réunion personnalisés au niveau du site |
|
Webex Meetings, Webex Trainings et Webex Events |
Changements de schémas
Obtenir le site : Attachez l'élément .
Modèle de réponse
Obtenir une réponse du site
<ns1:meetingTypes>
<ns1:meetingTypeID>3</ns1:meetingTypeID>
<ns1:meetingTypeName>PRO</ns1:meetingTypeName>
</ns1:meetingTypes>
<ns1:modèles de réunion>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Réunion MC Tempalte 1</ns1:meetingTemplateName>
<ns1:serviceType>MeetingCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Réunion EC 2</ns1:meetingTemplateName>
<ns1:serviceType>EventCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Modèle de réunion TC 3</ns1:meetingTemplateName>
<ns1:serviceType>TrainingCenter</ns1:serviceType>
</ns1:meetingTemplate>
</ns1:meetingTemplates>
XML API SetUser ne peut pas modifier l’élément desServices pris en charge lorsque le site est un site
CI
Description
XMLAPI SetUser ne supporte pas la modification de la valeur de « Services pris en charge » dans une demande API lorsque le site est lié aux sites Unified
Webex Meeting.
Changements de schémas
Il n’y a aucun changement de schéma sur l’API : DéfinirUtilisateur
.
WEBEX-15436 : Ajouter une protection pour éviter les doublons dans Mtgconfattendeelist
Description
Si plusieurs invités ayant le même courrier électronique sont ajoutés à la même réunion dans la même demande API, nous ne traiterons le premier invité avec le courrier électronique.
API impactées
-
Créer unmeetingAttende
-
Createuser
-
Setuser
-
Créer unemeeting
-
Configurer lameeting
-
Créer un événement
-
Configurer l’événement
-
Créer une formation
-
Configurer la formation
Modèle d’API
Demande
<?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">
<securityContext>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>mot de passe</password>
</securityContext>
<corps>
<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>
<personne>
<email>test@webex.com</email>
<name>name1</name>
</personne>
<personne>
<email>test@webex.com</email>
<name>name2</name>
</personne>
<sessionKey>1714904382</sessionKey>
</bodyContent>
</corps>
Mises à jour API 40.11.0
Mises à jour de l’API XML 40.11.0
XMLAPI CreateUser prend en charge le nom d’affichage
CreateUser
prend en charge dispalyname
lorsque la bascule de fonctionnalité EnableDisplayName
est sur 1. Si le basculement de fonctionnalité n’est pas 1, alors le nom d’affichage sera ignoré.
Changements de schémas
Createuser:
XMLAPI SetUser prend en charge le nom d’affichage
SetUser
prend en charge dispalyname
lorsque le bouton de fonctionnalité EnableDisplayName
est égal à 1. Si le basculement de la fonctionnalité n’est pas 1, le nom d’affichage sera ignoré.
Changements de schémas
Setuser:
XMLAPI GetUser prend en charge le nom d’affichage
GetUser
prend en charge dispalyname
lorsque le bouton de fonctionnalité EnableDisplayName
est égal à 1. Si le basculement de fonctionnalité n’est pas 1, le nom d’affichage
ne s’affiche pas.
Lorsque displayName dans la DB est nul et que la bascule de fonctionnalité
ActiverDisplayName est
1, displayName sera
firstName+ » « +lastName pour les caractères non asiatiques et
firstName+lastName
pour les caractères asiatiques.
Changements de schémas
Obtenir la réponse de l’utilneur :
Contrôle au niveau de l’utilisateur XMLAPI pour la Voip CMR Hybride
Le paramètre cmrHybridVoip est utilisé pour configurer et récupérer le paramètre
EnableCMRHybridVoIP au niveau de
l’utilisateur.
Changements de schémas
Obtenir une réponse de l’autre :
Demande CréerUtiliseur :
Configurer la demande de l’utiliseur :
Mises à jour API 40.10.0
Mises à jour de l’API XML 40.10.0
Prise en charge de l'API XML pour la réunion UUID
dans la demande et la réponse de l'API
Modèle d’API XML : Demande GetSessionInfo
:
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Réponse:
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:isLocked>faux</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API affectée :
-
Créer unmeetingAttende
-
DelMeetingAttende
-
S’inscrire à unemeetingAttende
-
Créer une téléconférenceSession
-
Configurer la téléconférenceSession
-
Obtenir la téléconférenceSession
-
Créer une formation
-
Configurer la formation
-
Obtenir la formation
-
Formation en cours
-
Créer un événement
-
Configurer l’événement
-
Événement delevent
XMLAPI retournera un élément supplémentaire pour la configuration de l’administration du site pour désactiver la capture d’écran
L’exigence provient de la sécurité - à la fois les bogues PenTest
et les clients, tels que Bugs. Ils ne souhaitent pas autoriser les utilisateurs finaux à prendre une capture d’écran dans l’application de réunions. Pendant ce temps, beaucoup d’autres clients souhaitent cette fonctionnalité - pour autoriser la capture d’écran. Les utilisateurs de l’éducation souhaitent également autoriser la capture d’écran. Nous allons donc avoir une configuration de l’administrateur de site pour ceci et XMLAPI va renvoyer un champ supplémentaire ActiverMobileScreenCapture dans la réponse de
GetSite pour prendre en charge
ceci.
Exemple de demande De site GetSite
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Test</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</body>
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ns1:siteInstance>
...
<ns1:securityOptions>
...
...
<ns1:enableMobileScreenCapture>false</ns1:enableMobileScreenCapture>
...
</ns1:securityOptions>
...
</ns1:siteInstance>
</serv:bodyContent>
</serv:message
APIs affectées
Obtenir le site
Amélioration pour rejoindre les rejoindre avec XMLAPI MEET-269 PIN-less
XMLAPI ajouter une NOUVELLE OPTION Les systèmes de conférence vidéo dans mon organisation peuvent démarrer et rejoindre des réunions sans invites pour une réunion Salle personnelle et une réunion MC.
-
createUser/setUser/getUser
ajouter un nouveau nœuddeviceCanStartMyPMR
danspersonalMeetingRoom
. -
createMeeting/setMeeting/getMeeting
ajouter un nouveau nœuddeviceCanStartMeeting
dans la planification.
L’option dans l’IU Webex pour la réunion Salle personnelle :
Changements de schémas
Createuser:
Setuser:
Obtenir la réponse de l’utilneur :
Créer unemeeting :
Configurer lameeting :
Obtenir la réponse de laréponse :
Mises à jour API 40.9.0
Mises à jour de l’API XML 40.9.0
Prise en charge de l'API XML pour répondre aux demandes et réponses UUID
Nous avons ajouté l’UUID de réunion à la demande API et la réponse partout où nous supportons en tant que clé de réunion ou clé de
session.
Modèle d’API XML : Demande GetSessionInfo
:
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Réponse:
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:isLocked>faux</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API affectée :
-
Obtenir lesinfos d’inscription
-
Formation de groupe LstsummarySession
-
Ajouter un testprogrammé
-
Configurer le testprogrammé
-
Test DelScheduled
-
Obtenir des informations de test
-
Charger l’image de l’événement
-
Envoyer un message d’invitation
-
Créer lassion d’urgence
-
Répertoire de lastmeetingusagePréliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
Événements de la LsteventsessionPréliminaryHistory
-
LsteventattendeePreliminaryHistory
-
LstTrainingPollResultsHistory
Les réunions Webex auront un lobby de réunion verrouillé où les utilisateurs peuvent attendre d’être admis dans la réunion
La programmation et la modification de la réunion API XML MC pour prendre en charge le lobby verrouillé lorsque la fonctionnalité (ConsistentLockedLobby
) est mise en charge.
Changements de schémas
Trois nouveaux éléments ont été ajoutés(externalAttendeeSecurity
, autoLock ,
autoLockWaitTime ) dans les API
CreateMeeting, SetMeeting et GetMeeting.
Élément |
Description |
---|---|
|
Lorsque la réunion est déverrouillée, il y a trois éléments de sécurité des utilisateurs externes qui peuvent être des choix.
|
|
Le verrouillage automatique ou non de la réunion. Vrai : Verrouiller la réunion automatiquement après # minutes après le démarrage de la réunion Faux : Ne verrouille pas automatiquement la réunion après le démarrage de la réunion |
|
Minutes(0,5,10,15,20 ) pour verrouiller la réunion automatiquement aprèsle démarrage de la réunion |
Modèle de demande et de réponse
Demande de création d’unemeeting :
...
...
false
AllowJoinWithLobby
true
10
...
Demande de SetMeeting :
2###1###01
...
...
false
AllowJoinWithLobby
true
10
...
Réponse de GetMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<meet:attendeeOptions>
...
<meet:joinRequiresAccount>false</meet:joinRequiresAccount>
<meet:externalAttendeeSecurity>AutoriserRejoindre</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...
</serv:message>
API affectée :
-
Créer unemeeting
-
Configurer lameeting
-
Obtenir une autre
Amélioration de l'API GetSessionInfo
pour rétablir le statut des participants sur la session en cours
Deux nouveaux éléments ont été ajoutés (aHostInMeeting
, hasAttendeeInMeeting ) en réponse de
GetSessionInfos
. Ces deux éléments seront renvoyés lorsqu’il s’agit d’une réunion en cours.
Élément |
Description |
---|---|
|
Si l’organisateur a rejoint la réunion en cours. Vrai : L’organisateur est en réunion en cours. Faux/Nul : L’organisateur n’est pas dans la réunion en cours ou la réunion n’est pas en cours de réunion. |
|
S’il y a un invité/organisateur a rejoint la réunion en cours. Vrai : il y a un invité ou un organisateur dans la réunion en cours. Faux/Nul : il n’y a aucun invité ou organisateur dans la réunion en cours, ou la réunion n’est pas en cours. |
Modèle de réponse API :
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ep:status>INPROGRESS</ep:status>
<ep:hasHostInMeeting>true</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
...
</serv:message>
API affectée :
Obtenir les détails de lassion
L’API GetUserCard nécessite une autorisation.
Amélioration de la sécurité l’API XML GetUserCard nécessite
l’autorisation d’obtenir les informations des utilisateurs.
API affectée :
Obtenir la carteUtiliseur
Mises à jour API 40.8.0
Mises à jour de l’API XML 40.8.0
Amélioration de la réponse GetSessionInfo
Si vous n’êtes pas invité ou accepté par la réunion, votre appel vers l’API XML : GetSessionInfo
ne renverra pas les éléments : confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
dans le corps de la réponse de l'API.
Exemple de réponse API pour les réunions :
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>NON LISTÉ</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>Centre de réunions</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
Exemple de réponse API pour Trainings/Events :
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>NON LISTÉ</ep:listStatus>
<ep:registration>true</ep:registration>
https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>true</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>INVITER/S'INSCRIRE/REJETER</ep:joinStatus>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>Centre de formation</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
API affectée :
-
Obtenir les détails de lassion
GetSessionInfo, GetUserCard
Améliorations de sécurité
Nous avons fait une amélioration de sécurité sur l’interface XML API GetSessionInfo
et GetUserCard
. Nous bloquerons l’accès à ces deux API dans les deux heures si leur appel a atteint la limite en une heure et qu’aucune erreur n’a été trouvée.
La réponse de l'état d'erreur est : "403 Interdit"
APIs concernées :-
Obtenir les détails de lassion
-
Obtenir la carteUtiliseur
meetingUUID
dans la prise en charge des demandes et réponses API
Nous avons ajouté meetingUUID à la demande API et la réponse à chaque fois que nous mandons de prendre en charge une réunionKey/sessionKey
.
Demande GetSessionInfo
:
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Réponse:
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:isLocked>faux</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API affectée :
-
LstOpenSession
-
Obtenir lesinfos d’inscription
-
LstsummaryMeeting (EnresummaryMeeting)
-
Tests lstScheduled
-
Obtenir un événement
-
Événement LstsummaryEvent
-
Répertoire de lastmeetingusage
-
Répertoire de la formation de la formation
-
LsteventsessionHistory
-
LstsupportsessionHistory
-
DelSession
Modèle de sites de formation (type de session EDU) dans la prise en charge de l’API XML
Lorsque votre site active le type de session EDUCATION Instructor (INSTRUCTC), l’API XML peut prendre en charge la programmation d’une réunion avec le modèle de réunion EDU.
API affectée :
-
Créer unemeeting
-
Configurer lameeting
-
Créer un événement
-
Configurer l’événement
-
Créer une formation
-
Configurer la formation
Prise en charge de l’API XML Créer unemeetingAttende et
InscriptionMeetingAttendee
À la fois Créer un invité et S’inscrire à une réunionL’invité peut vérifier le formulaire d’inscription de l’invité requis pour l’inscription à une réunion
Webex.
Et il y a une nouvelle exception pour cette tâche :
Numéro d’exception |
Message d’exception |
---|---|
040014 |
Champs obligatoires manquants (formulaire d'inscription) : ... |
Par exemple, si vous avez sélectionné « Poste de travail » et « Nom de la société » comme champs obligatoires pour l’inscription d’un invité à Webex Meetings comme démontré ci-dessous, alors vous devez fournir une valeur dans les champs « Poste de travail » et « Nom de la société » lorsque vous appelez les deux API : CreateMeetingAttendee
et RegisterMeetingAttendee
.
Demande RegisterMeetingAttendee
:
<corps>
<bodyContent xsi:type="java:com.webex.service.binding.attendee.RegisterMeetingAttendee">
<personne>
<nom>FirstNameb LastName</name>
<firstName>FirstNameb</firstName>
<lastName>LastName</lastName>
<title>Ingénieur</title> //Intitulé du poste
<company>Cisco1234</company> //Nom de la société
...
<email>****@*****.com</email>
<type>VISITEUR</type>
<sendReminder>true</sendReminder>
</personne>
<role>INVITÉ</role>
<joinStatus>ACCEPTER</joinStatus>
<emailInvitations>true</emailInvitations>
<sessionKey>1####4####1</sessionKey>
</bodyContent>
</corps>
Demande CreateMeetingAttendee
:
FirstNameA LastNameA
FirstNameA
LastNameA
Engineer //Job Title
Cisco1234 //Company Name
...
;*****@*****.com
VISITOR
true
ATTENDEE
ACCEPT
true
1###4####1
040014 Exception de réponse
Exemple :
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:result>FAILURE</serv:result>
Champs obligatoires manquants (formulaire d'enregistrement) : title,company
PRIMARY
040014
title,company
API affectée :
-
Créer unmeetingAttende
-
S’inscrire à unemeetingAttende
Améliorations apportées à la validation de la messagerie électronique API XML
L’API XML ne doit pas autoriser le/les caractère(s) des espaces blancs dans un courrier électronique, c’est pourquoi nous avons amélioré la validation par courrier électronique pour qu’elle corresponde au comportement de la page Webex Meetings.
API affectée :
-
Créer unmeetingAttende
-
Créer un événement
-
Configurer l’événement
-
Créer uncontact
-
Configurer lecontact
-
ConfigurerInfos sur l’enregistrement
-
Créer unmeetingAttende
-
Créer une formation
-
Configurer la formation
-
Createuser
-
Setuser
-
Créer unemeeting
-
Configurer lameeting
-
S’inscrire à unemeetingAttende
Mises à jour API 40.7.0
Mises à jour de l’API XML 40.7.0
prise en charge de
meetingUUID
Nous avons ajouté meetingUUID à la demande API et la réponse partout où nous mandons la prise en charge d’une clé de réunion ou d’une sessionKey.
Exemple de demande GetSessionInfo
:
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Exemple de demande GetSessionInfo
:
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
Exemple de réponse :
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:isLocked>faux</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
APIs concernées :
-
LstmeetingattendeeHistory
-
LsttrainingattendeeHistory
-
LsteventattendeeHistory
-
LstsupportattendeeHistory
Prise en charge du courrier électronique de bienvenue de l'API CreateUser
pour quatre nouvelles langues
Le message électronique html de bienvenue XMLAPI prend en charge les quatre nouvelles langues suivantes :
-
Tchèque (languageID=19)
-
Polonais (languageID=20)
-
Hongrois (languageID=21)
-
Insé pass.(languageID=22)
XMLAPI envoie le courrier électronique de bienvenue en fonction de la langue ou de l’ID langue dans la demande
Créerutiliseur.
Utilisation de CreateUser
pour envoyer un e-mail de bienvenue Html (tchèque) :
<?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">
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
</securityContext>
<corps>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>test</firstName>
<lastName>utilisateur</lastName>
<webExId>testuser</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<privilège>
<host>true</host>
</privilège>
<languageID>19</languageID>
ou
<language>Tchèque</language>
<active>ACTIVÉ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</bodyContent>
</corps>
Api 40.6.1, 40.4.9 Mises à jour
Mises à jour de l’API XML 40.6.1, 40.4.9
Prise en charge de CreateMeeting/SetMeeting
Lorsque vous programmez une réunion Webex, L’API XML Créer une réunion/Configurer une réunion vous permet de cocher ou de décocher ou de cliquer sur un champ requis ou non requis à partir du formulaire d’inscription de l’invité.
Vous voyez ci-après un exemple de programme de réunions depuis la page Web de l’utilisateur où vous pouvez vérifier les champs obligatoires tels que « Poste de travail », « Nom de la société », « Ville » et « État » sur le formulaire d’inscription de l’invité :
Voici un mappage entre les champs des pages et les éléments de l’API XML :
Champs de la page | Élément XMLAPI |
---|---|
Nom du poste | |
Nom de la société | |
Adresse 1 | |
Adresse 2 | |
Ville | |
État | |
CP/Code postal | |
Pays/région | |
Téléphone professionnel | |
fax |
Schéma modifié : Ajouter l’élément « registrationForm » dans CreateMeeting
Schéma modifié : Ajouter l’élément « registrationForm » dans SetMeeting
Schéma modifié : Ajouter l’élément « registrationForm » dans GetMeeting
Exemple de demande de création de réunion
:
<meetingPassword>mot de passe</meetingPassword>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>false</auto>
</attendeeOptions>
<formulaire d'inscription>
<title><req>true</req></title>
<company><req>true</req></company>
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</formulaire d'inscription>
Exemple de demandeSetMeeting
:
<meetingkey>1015045339</meetingkey>
<métadonnées>
<confName>Nom de la conférence</confName>
<meetingType>3</meetingType>
</metaData>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>true</auto>
</attendeeOptions>
<formulaire d'inscription>
<title><req>true</req></title>
<company><req>vrai</req></company>
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>true</req></city>
<state><req>true</req></state>
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</formulaire d'inscription>
GetMeeting
Exemple de réponse :
1234567890@sitename.webex.com
1234567890@sitename.webex.com
false
true
true
false
false
true
true
false
false
false
APIs concernées :
-
Créer unemeeting
-
Configurer lameeting
-
Obtenir une autre
-
DelMeeting (Enmeeting)
Le type de réunion E2EE ne prend pas en charge les salles de réunion de salle de réunion (PMR)
Lorsque vous activez une salle de réunion personnelle (PMR) au cours d'un appel avec les API :CreateUser/SetUser/GetUser/GetMe
et seul un type de réunion E2EE est disponible, il répondra au message d'erreur suivant : « 110063 L'utilisateur doit avoir au moins un type de réunion non-E2EE pour activer la salle personnelle (PMR). »
APIs concernées :
-
Createuser
-
Setuser
-
Obtenir l’utilateur
-
ObtenirMe
Mises à jour API 40.6.0
Mises à jour de l’API XML 40.6.0
Le rôle de gestion des utilisateurs a été ajouté
Nous avons créé le rôle de Gestion des utilisateurs et le fichier schéma pour ce qui suit a changé.
Schéma modifié : Demande CreateUser
:
Schéma modifié : Setuser
Schéma modifié : Réponse de GetMe
:
Schéma modifié : RésuméRéponse de l’utilisateur
:
APIs concernées :
-
Createuser
-
Setuser
-
ObtenirMe
-
LstsummaryUtilneur
Exemple de demande
CreateUser :
<?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">
<securityContext>
<siteName>xxx</siteName>
<webExID>AdministrationSite</webExID>
<password>xxxx</password>
</securityContext>
<corps>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilège>
<umSiteAdmin>true</umSiteAdmin>
<host>false</host>
<siteAdmin>faux</siteAdmin>
<labAdmin>faux</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilège>
<languageID>3</languageID>
<active>ACTIVÉ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</corps>
Prise en charge à l'aide de la clé API pour accéder à la GetUserCard
Nous utilisons maintenant la clé API (jeton JWT généré) pour accéder à l’API : GetUserCard
dans cette version.
Vous pouvez vous référer à ces pages sur l’application d’une clé API et pour générer un jeton JWT :
GetUserCard
Exemple de demande :
POSTER https://{sitename}.webex.com/WBXService/En-tête du service XML
:
Application de type de contenu/json;charset=utf-8
JWTToken ${jwttoken}
Corps :
<?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>
Exemple de réponse :
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<utiliser :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>Salle personnelle du test</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
Prise en charge de meetingUUID
dans la demande et la réponse API
Nous avons ajouté meetingUUID à la demande API et la réponse lorsque nous mandons la prise en charge d’une clé de réunion ou d’une sessionKey.
APIs concernées :
-
LstEnregistrements
-
LstsummarySession
-
Obtenir les détails de lassion
-
Obtenir la <hosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
Créer unemeeting
-
Configurer lameeting
-
Obtenir une autre
-
DelMeeting (Enmeeting)
-
Derniercalendresession
meetingUUID
Exemple de demande :
<?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>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
meetingUUID
Exemple de réponse :
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NON_INPROGRESS</ep:status>
<ep:isLocked>faux</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
Les clés de réunion PMR ne seront pas modifiées d’un utilisateur temporairement désactivé ou désactivé
Lorsqu’un utilisateur temporairement désactivé ou que la SR est réactivée dans une semaine, l’utilisateur qui a été réactivé ou activé la clé de réunion de la S PMR n’est pas modifiée, elle sera la même qu’auparavant.
APIs concernées :
-
Setuser
-
DelUser (Utiliseur)
Améliorations LstSummarySession
Nous avons amélioré l’API : LstSummarySession
return scheduled-PMR pour avoir un nouvel élément, returnScheduledPMR
, dans la requête. Et le basculement de fonctionnalité par défaut est éteint.
APIs concernées :
-
DernierSummarySession
Changement de schéma :
Nous ajoutons un nouveau nom d’élément retourProgramméPMR dans la
demande API LstSummarySession.
Nous ajoutons un nouveau nom d’élément estProgramméPMR dans la réponse
API LstSummarySession.
LstSummarySession
Exemple de demande :
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<securityContext>
<siteName>xxx</siteName>
<webExID>Test</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
<corps>
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>ET</listMethod>
</listControl>
<datePortée>
<startDateStart>01/11/2019 08:0:0</startDateStart>
<startDateEnd>01/12/2019 07:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>11/01/2019 08:0:0</endDateStart>
<endDateEnd>01/12/2019 07:59:59</endDateEnd>
</dateScope>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</commander>
<serviceType>EventCenter</serviceType>
<serviceType>Centre de réunions</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>Centre de formation</serviceType>
<serviceType>Centre d'assistance</serviceType>
<returnScheduledPMR>true</returnScheduledPMR>
LstSummarySession
Exemple de réponse :
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</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>Réunion d'équipe</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>Centre de réunions</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, Hawaï (Honolulu)</ep:timeZone>
<ep:status>NON_INPROGRESS</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoin>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<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>Centre de réunions</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, Hawaï (Honolulu)</ep:timeZone>
<ep:status>NON_INPROGRESS</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:hostEmail>Molly08Console81696000@webex.com</ep:hostEmail>
<ep:passwordReq>true</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoin>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>true</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>true</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>true</ep:isScheduledPMR>
</ep:session>
</serv:bodyContent>
Améliorations GetSite
Nous avons ajouté une fonctionnalité de réponse GetSite
bascule de SupportXMLAPIReturnScheduledPMR
APIs concernées :
-
Obtenir le site
Changement de schéma :
Le nouvel élément de la réponse getSite de l’API XML
est : SupportXMLAPIReturnProgramméPMR
ObtenirSite
Exemple de demande :
<?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>
Exemple de réponse GetSite
:
<?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:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</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:siteCommonOptions>
...
<ns1:SupportXMLAPIReturnScheduledPMR>true</ns1:SupportXMLAPIReturnScheduledPMR>
...
</ns1:siteCommonOptions>
</ns1:siteInstance>
</serv:bodyContent>
Api 40.4.8, 40.2.9 Mises à jour
Mises à jour de l’API XML 40.4.8, 40.2.9
Nouvelle réponse lors de la mise à jour des réunions programmées dans XMLAPI
Lorsque les clients utilisent XMLAPI pour mettre à jour les réunions programmées via leur page, nous envoyons le mot de passe numérique dans un courrier électronique de mise à jour et l’appliquons aux centres Webex Meetings, Teams et Events.
Ces API : GetMeeting, GetTrainingSession, GetEvent
et GetTeleconferenceSession
, auront ces nouveaux éléments en réponse : audioPassword
(mot de passe numérique), isEnforceAudioPassword
, isEnforceAudioLogin
pour les centres Webex Meetings, Teams et Events.
Schéma modifié :
APIs concernées :
-
Obtenir une autre
-
Obtenir la formation
-
Obtenir un événement
-
Obtenir la téléconférenceSession
GetMeeting
Request Exemple :
<?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>
Exemple de réponse :
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:accessControl>
<meet:listToPublic>false</meet:listToPublic>
<meet:isPublic>false</meet:isPublic>
<meet:meetingPassword>PkzC8tP7kM5</meet:meetingPassword>
<meet:audioPassword>75928877</meet:audioPassword>
<meet:isEnforceAudioPassword>true</meet:isEnforceAudioPassword>
<meet:isEnforceAudioLogin>false</meet:isEnforceAudioLogin>
</meet:accessControl>
...
...
</serv:bodyContent>
API 40.4.5, 40.2.6 Mises à jour
Mises à jour de l’API XML 40.4.5, 40.2.6
Limite d'utilisation de GetUserCard
et GetSessionInfo
Nous appliquons la limite d'utilisation sur les API GetUserCard
et GetSessionInfo
, vous pourriez recevoir le message d'erreur « 403 interdit » si vous atteignez la limite d'utilisation.
APIs concernées :
-
Obtenir la carteUtiliseur
-
Obtenir les détails de lassion
API 40.4.4, 40.2.5 Mises à jour
Mises à jour de l’API XML 40.4.4, 40.2.5
Limite du nombre de BodyContent
Nous avons ajouté un nombre limité de corpscontent dans
chaque section API XML. Lorsque vous ajoutez trop de BodyContent
dans la demande API, le code d'erreur et le message suivants reviennent : « 000053 Le nombre de BodyContent dans une demande doit être inférieur à {number} »
APIs concernées :
-
Toutes les API XML
Requête API XML avec plusieurs BodyContent
Exemple :
<?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>
xxxx</siteName>
<siteName>xxx</siteName>
</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>
</ser
API 40.4.3, 40.2.4 Mises à jour
Mises à jour de l’API XML 40.4.3, 40.2.4
Cliquez ici pour télécharger le schéma de l’API XML 40.4.3, 40.2.4.
Améliorations de CreateUser
Nous avons amélioré Créer un utilisateur pour prendre en charge le courrier électronique de bienvenue en plusieurs
langues. Le CreateUser
demande maintenant isHTMLEmail
APIs concernées :
-
Createuser
Exemple de demande
CreateUser :
<?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">
<securityContext>
<webExID>administrateur</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
<corps>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>xxx</firstName>
<lastName>xxx</lastName>
<webExId>xxx</webExId>
<password>xxx</password>
<email>xxx</email>
<privilège>
<host>true</host>
<siteAdmin>faux</siteAdmin>
<labAdmin>faux</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilège>
<languageID>3</languageID>
<active>ACTIVÉ</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>true</isHTMLEmail>
</bodyContent>
</corps>
Mises à jour API 40.4.0
Mises à jour de l’API XML 40.4.0
Application de vérification de l’adresse électronique lors du changement de courriers électroniques dans l’API XML
Après qu’un administrateur de site a activé la confirmation requise pour que l’utilisateur met à jour son adresse électronique dans l’administration du site Webex :
-
Si un compte d’administrateur non site appelle l’API Configurer l’utilisateur pour changer les adresses électroniques, l’adresse électronique actuelle reste jusqu’à ce que la nouvelle
adresse électronique soit vérifiée. Le courrier électronique de confirmation de changement de compte est envoyé à la nouvelle adresse électronique avec la « Confirmation du changement de compte Webex ». Après avoir cliqué sur le lien dans le courrier électronique pour confirmer, la nouvelle adresse électronique est immédiatement liée.
Si un administrateur qui n’est pas sur le site appelle l’API SetUser plusieurs fois sans terminer le processus de vérification de l’adresse électronique, l’adresse électronique actuelle est conservée et la dernière adresse électronique est celle qui doit
être vérifiée.
-
Si un compte d’administrateur de site appelle l’API Configurer l’utilisateur pour modifier les adresses électroniques, le processus de vérification de
l’adresse électronique n’est pas déclenché. La nouvelle adresse électronique sera immédiatement liée au compte de l’organisateur ou de l’invité.
APIs concernées :
-
Setuser
Expiration et réinitialisation de la connexion GetEnrollmentInfo
L’API GetEnrollmentInfo recherche actuellement les adresses IP sur le système de noms de domaine, ce qui déclenche d’énormes impacts sur la performance. Nous prévoyons de simplifier ce processus, avec une réponse vide dans le champ
.
APIs concernées :
-
Obtenir lesinfos d’inscription
Exemple de demande 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>
Exemple de réponse GetEnrollmentInfo
:
<?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:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="att:getEnrollmentInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<att:session>
<att:confID>154279066999981548</att:confID>
<att:participant>
<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:address1></att:address1>
<att:address2></att:address2>
<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:domain> </att:domain>
<att:ipAddress>10.35.240.53</att:ipAddress>
<att:submitTime>27/02/2020 22:03:57</att:submitTime>
<att:status>APPROUVÉ</att:status>
</att:attendeur>
<att:participant>
<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:address1></att:address1>
<att:address2></att:address2>
<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:domain> </att:domain>
<att:ipAddress>10.154.181.15</att:ipAddress>
<att:submitTime>27/02/2020 22:07:38</att:submitTime>
<att:status>APPROUVÉ</att:status>
</att:attendeur>
<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>
Mises à jour API 40.2.0
Mises à jour de l’API XML 40.2.0
Supprimer l'accès anonyme à la SessionRésumé
En tant qu’amélioration de la sécurité, nous arrêtons la prise en charge de l’accès anonyme à l’API de LaSummarySession.
Si Webex Meetings accède anonymement à l’API, le code d’erreur et le message suivants sont renvoyés : « 000015 Désolé, aucun enregistrement trouvé. »
APIs concernées :
-
DernierSummarySession
LstSummarySession
Exemple de demande :
<?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>
LstSummarySession
Exemple de réponse :
<?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>Désolé, aucun enregistrement trouvé</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Améliorations de la sécurité de CreateMeeting
et SetMeeting
Cette modification a été réalisée dans l’API XML 40.2.0, mais sa description a été modifiée après la réception des commentaires des clients.
En tant qu’amélioration de la sécurité, nous avons mis à jour les API Créer une réunion et Configurer la réunion pour ne pas autoriser les utilisateurs à programmer l’heure de démarrage d’une réunion qui est déjà
passée. S'ils essaient, l'API invite le message d'erreur : "060016 L'heure de démarrage de la session doit être ultérieure à l'heure actuelle." Si un utilisateur doit programmer une réunion instantanée, nous vous recommandons de configurer l’heure de démarrage de la réunion cinq minutes plus tard que l’heure actuelle.
APIs concernées :
-
Créer unemeeting
-
Configurer lameeting
Mises à jour API 40.1.2
Mises à jour de l’API XML 40.1.2
La programmation d’une réunion génère automatiquement un mot de passe si l’un d’entre ces mots n’est pas fourni
Nous avons amélioré la fonctionnalité Créer uneréférence , Créer un événement, Créer une formation, et
CréerRéconférenceSession pour inclure un mot de passe dans le corps de réponse de
l’API.
Par défaut, le paramètre Toutes les réunions/événements/sessions doivent avoir un mot de passe est activé. Dans ce cas, si la demande d’API n’inclut pas de mot de passe, un mot de passe est automatiquement généré à partir des serveurs API XML.
Si le paramètre Toutes les réunions/événements/sessions doivent avoir un mot de passe est désactivé et que la demande API n’inclut pas un mot de passe, un mot de passe n’est pas généré à partir des serveurs API XML.
Si la demande API inclut un mot de passe, alors la réponse inclura ce mot de passe, quel que soit le paramètre Toutes les réunions/événements/sessions doivent avoir un mot de passe activé ou désactivé.
APIs concernées :
-
Créer unemeeting
-
Créer un événement
-
Créer une formation
-
Créer une téléconférenceSession
La réponse Créer une réunion a maintenant
l’élément Mot de passe de la réunion
:
Exemple de demande de création de réunion
:
<?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>
Exemple de réponse CreateMeeting
:
<?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:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns:att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</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 réponse Créer un événement a maintenant
l’élément Mot de passe de
l’événement :
L’élément Créer une session de formation et Créer une téléconférenceRésession ont à présent l’élément Mot de passe de la session
:
Mises à jour API 40.1.0
Mises à jour de l’API XML 40.1.0
Améliorations de GetSessionInfo
Nous avons ajouté de nouveaux éléments à l’API GetSessionInfo.
L’API renvoie maintenant des infos pour les périphériques mobiles également.
APIs concernées :
-
Obtenir les détails de lassion
GetSessionInfo
Demande de mises à jour :
Exemple de demande :
<?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>sqdemo11</siteName>
<webExID>siteadmin</webExID>
<password>P@ss1234</password>
</securityContext>
</header>
<body>
<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 ou 123456789_go@webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</body>
Améliorations de LstAccessAnywhereHistory
Nous avons ajouté une nouvelle API, lstAccessAnywhereHistory , pour répondre aux informations du rapport
Webex Access Anywhere.
APIs concernées :
-
Répertoire LstAccessAnywhere
LstAccessAnywhereHistory
Demande de mises à jour :
Mises à jour de la réponse LstAccessAnywhereHistory
:
Exemple de demande :
<?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">
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>test</webExID>
<password>P@ss1234</password>
</securityContext>
<corps>
<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>OU</serv:listMethod>
</listControl>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</commander>
Exemple de réponse :
<?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:en-tête>
<serv:réponse>
<serv:result>RÉUSSITE</serv:result>
<serv:gsbStatus>PRIMAIRE</serv:gsbStatus>
</serv:response>
</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>