- 主页
- /
- 文章
了解有关 Cisco Webex Meetings API 的所有重要信息,如架构更改和其他公告。
有关 XML API 41 的详细信息,请参阅 Cisco Webex Meetings API 更新概述 (API 41)
有关 XML API 39 和 XML API 11 的更多信息,请参阅 Cisco Webex Meetings XML API 更新概述(XML API 39 及更低版本)。
有关 XML API 11 SP9 及更低版本的更新,请转至 Cisco DevNet。
API 40.12.0 更新
XML API 40.12.0 更新
XML API 支持私人会议类型
XML API 受到影响
我们可以使用 API:
CreateMeeting
和SetMeeting
将 Webex 会议安排或更新为私人会议类型。如果 Webex 会议已安排为私人会议类型,
GetSessionInfo
GetMeeting
,LstSummarySession
和LstCalendarSession
将返回新元素,其名称为PrivateMeeting
以指明会议类型。GetMeetingType
和LstMeetingType
返回新元素,其名称为
表示其是否支持私人会议。SupportPrivateMeeting
架构更改
XML API: GetMeetingType/LstMeetingType: 附加 <SupportPrivateMeeting>
元素。
XML API: LstSummarySession
:附加 <isPrivateMeeting>
元素。
XML API: LstCalendarSession
:附加 <isPrivateMeeting>
元素。
XML API: GetSessionInfo
:附加 <isPrivateMeeting>
元素。
XML API: GetMeeting: 附加 <isPrivateMeeting>
元素。
XML API 请求: CreateMeeting
使用私人会议类型的 CreateMeeting 请求
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<schedule>
<startDate>10/25/2020 13:00:00</startDate>
<duration>45</duration>
<timeZoneID>45</timeZoneID>
</schedule>
<accessControl>
<meetingPassword>******* </meetingPassword>
</accessControl>
<metaData>
<confName>MC_PrivateMeeting_Test</confName>
<meetingType>168</meetingType> //169是支持私人会议的示例
</metaData>
</bodyContent>
</body>
XML API 的响应: GetSessionInfo
以下内容的响应 isPrivateMeeting
<ep:supportE2E>false</ep:supportE2E>
<ep:isAllowJBH>true</ep:isAllowJBH>
<ep:isPrivateMeeting>true</ep:isPrivateMeeting> //true: 会议支持私人会议;false: 该会议不支持私人会议。
<ep:isCETMeeting>false</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
GetSite API 将返回站点级会议模板
用户故事/任务描述
GetSite API 返回站点级会议模板。 此操作允许 Education Connector 和 Webex Classroom 向教师显示这些模板,供他们在安排在线课程时挑选和选择。
受影响的 API
如果存在站点级的自定义会议模板,GetSite api 将返回这些站点级模板。
元素名称 | 描述 |
---|---|
| 站点级自定义会议模板的名称 |
| Webex Meetings、Webex Trainings 和 Webex Events |
架构更改
GetSite:附加 <meetingTemplates>
元素。
响应示例
GetSite 响应
<ns1:meetingTypes>
<ns1:meetingTypeID>3</ns1:meetingTypeID>
<ns1:meetingTypeName>专业版</ns1:meetingTypeName>
</ns1:meetingTypes>
<ns1:meetingTemplates>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>MC会议临时会议1</ns1:meetingTemplateName>
<ns1:serviceType>MeetingCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>EC会议临时会议2</ns1:meetingTemplateName>
<ns1:serviceType>EventCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>TC会议模板3</ns1:meetingTemplateName>
<ns1:serviceType>TrainingCenter</ns1:serviceType>
</ns1:meetingTemplate>
</ns1:meetingTemplates>
XML API SetUser 无法更改以下元素 supportedServices
如果站点为 CI 统一站点
描述
XMLAPI SetUser
不支持更改 API 请求中的以下值 supportedServices
(如果站点是与 Control Hub 关联的 Unified Webex Meeting 站点)。
架构更改
以下 API 没有架构更改: SetUser
。
WEBEX-15436: 添加保护可避免在以下内容中出现重复的电子邮件地址 Mtgconfattendeelist
描述
如果多个与会者在同一 API 请求中将相同电子邮件添加到同一个会议,系统将仅处理第一个与会者的电子邮件。
受影响的 API
CreateMeetingAttendee
CreateUser
SetUser
CreateMeeting
SetMeeting
CreateEvent
SetEvent
CreateTrainingSession
SetTrainingSession
API 示例
申请
<?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>测试站点</siteName>
<webExID>test用户</webExID>
<password>密码</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<sessionKey>1714904382</sessionKey>
<person>
<email>test@webex.com</email>
<name>名称1</name>
</person>
<attendees>
<person>
<email>test@webex.com</email>
<name>名称2</name>
</person>
<sessionKey>1714904382</sessionKey>
</attendees>
</bodyContent>
</body>
</serv:message>
API 40.11.0 更新
XML API 40.11.0 更新
XMLAPI CreateUser 支持 displayname
CreateUser
支持 dispalyname
如果功能切换 EnableDisplayName
的值为 1。 如果功能切换的值不是 1,那么 displayName
将忽略。
架构更改
CreateUser:
XMLAPI SetUser 支持 displayname
SetUser
支持 dispalyname
如果功能切换 EnableDisplayName
的值为 1。 如果功能切换的值不是 1,那么 displayName
将忽略。
架构更改
SetUser:
XMLAPI GetUser 支持 displayname
GetUser
支持 dispalyname
如果功能切换 EnableDisplayName
的值为 1。 如果功能切换的值不是 1,那么 displayName
将不会显示。
时间 displayName
在 DB 中为空且功能切换 EnableDisplayName
的值为 1, displayName
将 firstName+" "+lastName
适用于非亚洲字符以及 firstName+lastName
适用于亚洲字符。
架构更改
GetUserResponse:
CMR 混合网络语音的 XMLAPI 用户级别控制
这个 cmrHybridVoip
设置用于设定和检索以下内容的用户级别设置 EnableCMRHybridVoIP
。
架构更改
GetUser Response:
CreateUser Request:
SetUser Request:
API 40.10.0 更新
XML API 40.10.0 更新
XML API support for meeting UUID
在 API 请求和响应中
示例 XML API: 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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
响应:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns: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>成功</serv:result>
<serv:gsbStatus>主</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>不_进行中</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
受影响的 API:
CreateMeetingAttendee
DelMeetingAttendee
RegisterMeetingAttendee
CreateTeleconferenceSession
SetTeleconferenceSession
GetTeleconferenceSession
CreateTrainingSession
SetTrainingSession
GetTrainingSession
DelTrainingSession
CreateEvent
SetEvent
DelEvent
XMLAPI 将为站点管理员配置返回一个额外的元素,以禁用屏幕截图
要求来自安全性 - PenTest
缺陷和客户,例如 Goldman Sachs。 这些客户不希望让最终用户在 Meetings 应用程序中进行屏幕截图。与此同时,许多其他客户希望允许屏幕截图的功能。 此外,教育用户也希望允许屏幕截图。 因此,我们将对此进行站点管理员配置,XML API 将返回一个额外字段 EnableMobileScreenCapture
(在以下内容的响应中) GetSite
以支持此功能。
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>测试</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</body>
</serv:message>
<?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>成功</serv:result>
<serv:gsbStatus>初级</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>
...
... false ...
<ns1:EnableMobileScreenCapture></ns1:EnableMobileScreenCapture>
</ns1:securityOptions>
...
</ns1:siteInstance>
</serv:bodyContent>
</serv:body>
</serv:message>
受影响的 API
GetSite
XMLAPI 支持 MEET-269 无 PIN 加入改进
XMLAPI 为个人会议室会议和 MC 会议添加了新选项我的组织中的视频会议系统可以开始和加入会议,而无需提示。
createUser/setUser/getUser
添加新节点deviceCanStartMyPMR
中personalMeetingRoom
。createMeeting/setMeeting/getMeeting
添加新节点deviceCanStartMeeting
(在安排中)。
Webex 用户界面中用于个人会议室会议的选项:
架构更改
CreateUser:
SetUser:
getUserResponse:
CreateMeeting:
setMeeting:
getMeetingResponse:
API 40.9.0 更新
XML API 40.9.0 更新
XML API support for meeting UUID
请求和响应
我们已在支持的位置向 API 请求和响应添加会议 UUID meetingKey
或 sessionKey
。
示例 XML API: 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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
响应:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns: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>成功</serv:result>
<serv:gsbStatus>主</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>不_进行中</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
受影响的 API:
GetEnrollmentInfo
LstsummaryTrainingSession
AddScheduledTest
SetScheduledTest
DelScheduledTest
GetTestInformation
UploadEventImage
SendInvitationEmail
CreateSupportSession
LstmeetingusagePreliminaryHistory
LstmeetingattendeePreliminaryHistory
LsteventsessionPreliminaryHistory
LsteventattendeePreliminaryHistory
LstTrainingPollResultsHistory
Webex 会议中将添加一个锁定的会议等候区,用户可在其中等待被允许进入会议
XML API 会安排并编辑 MC 会议以支持锁定的等候区,如果该功能( ConsistentLockedLobby
)处于开启状态。
架构更改
添加了三个新元素( externalAttendeeSecurity
, autoLock
, autoLockWaitTime
)到 CreateMeeting、SetMeeting 和 GetMeeting API 中。
元素 | 描述 |
---|---|
| 解锁会议后,有三个外部用户安全性项目可供选择。
|
| 是否自动锁定会议。 True: 会议开始 # 分钟后自动锁定会议 False: 会议开始后不自动锁定会议 |
| 表示会议开始多少分钟(0、5、10、15、20)后自动锁定会议 |
请求和响应示例
Request of CreateMeeting:
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
...
<attendeeOptions>
…
<joinRequiresAccount>false</joinRequiresAccount>
<externalAttendeeSecurity>AllowJoinWithLobby</externalAttendeeSecurity>
<autoLock>true</autoLock>
<autoLockWaitTime>10</autoLockWaitTime>
</attendeeOptions>
…
</bodyContent>
Request of SetMeeting:
<bodyContent xsi:type="java:com.webex.service.binding.meeting.SetMeeting">
<meetingkey>2###1###01 ...</meetingkey>
<attendeeOptions>
…
<joinRequiresAccount>false</joinRequiresAccount>
<externalAttendeeSecurity>AllowJoinWithLobby</externalAttendeeSecurity>
<autoLock>true</autoLock>
<autoLockWaitTime>10</autoLockWaitTime>
</attendeeOptions>
…
</bodyContent>
的回应: 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: ="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></serv:result>
<serv:gsbStatus></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>允许加入</meet:externalAttendeeSecurity>
<meet:autoLock>true</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
…
受影响的 API:
CreateMeeting
SetMeeting
GetMeeting
增强 GetSessionInfo
API 可返回进行会话时的参加者状态
添加了两个新元素( hasHostInMeeting
, hasAttendeeInMeeting
)到以下内容的响应 GetSessionInfo
。 当会议为进行中的会议时,将返回这两个元素。
元素 | 描述 |
---|---|
| 主持人是否已加入进行中的会议。 True: 主持人已加入进行中的会议。 False/Null: 主持人未加入进行中的会议,或会议不是进行中的会议。 |
| 进行中的会议是否存在与会者/主持人。 True: 进行中的会议中存在与会者或主持人。 False/Null: 进行中的会议中不存在任何与会者或主持人,或会议不是进行中的会议。 |
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: ="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></serv:result>
<serv:gsbStatus></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>进行中</ep:status>
<ep:hasHostInMeeting>true</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>true</ep:hasAttendeeInMeeting>
…
受影响的 API:
GetSessionInfo
API GetUserCard 需要授权。
安全性增强,XML API GetUserCard
需要授权才能获取用户信息。
受影响的 API:
GetUserCard
API 40.8.0 更新
XML API 40.8.0 更新
GetSessionInfo
响应增强
如果您未被邀请或者未获得会议批准,则在调用 XML API 时: GetSessionInfo
不会返回以下元素: confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
(在 API 响应正文中)。
会议的 API 响应示例:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>不_进行中</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>非公开</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>真</ep:passwordReq>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>MeetingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>真</ep:isAllowJBH>
<ep:isCETMeeting>真</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
</serv:bodyContent>
培训/活动的 API 响应示例:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>不_进行中</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>非公开</ep:listStatus>
<ep:registration>真</ep:registration>
<ep:registrationURL>https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>真</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>邀请/注册/拒绝</ep:joinStatus>
<ep:isRegisterIDRequired>false</ep:isRegisterIDRequired>
</ep:accessControl>
<ep:metaData>
<ep:serviceType>TrainingCenter</ep:serviceType>
</ep:metaData>
<ep:attendeeOptions>
<ep:joinRequiresAccount>false</ep:joinRequiresAccount>
</ep:attendeeOptions>
<ep:isAllowJBH>真</ep:isAllowJBH>
<ep:isCETMeeting>真</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
</serv:bodyContent>
受影响的 API:
GetSessionInfo
GetSessionInfo, GetUserCard
安全性增强
我们已对 XML API 进行安全性增强 GetSessionInfo
和 GetUserCard
。 如果用户的调用在一小时之内达到上限,但没有发现数据错误,我们将阻止他们在接下来两个小时内访问这两个 API。
错误状态响应: “403 禁止访问”
受影响的 API:GetSessionInfo
GetUserCard
meetingUUID
在 API 请求和响应中支持
我们已在支持的位置向 API 请求和响应添加会议 UUID meetingKey/sessionKey
。
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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
响应:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns: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>成功</serv:result>
<serv:gsbStatus>主</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>不_进行中</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
受影响的 API:
LstOpenSession
GetEnrollmentInfo
LstsummaryMeeting
LstScheduledTests
GetEvent
LstsummaryEvent
LstmeetingusageHistory
LsttrainingsessionHistory
LsteventsessionHistory
LstsupportsessionHistory
DelSession
支持 XML API 中的教育站点模板(EDU 会话类型)
当您的站点启用教育讲师 (EDU) 会话类型时,XML API 支持通过 EDU 会议模板安排会议。
受影响的 API:
CreateMeeting
SetMeeting
CreateEvent
SetEvent
CreateTrainingSession
SetTrainingSession
XML API CreateMeetingAttendee
和 RegisterMeetingAttendee
支持
两者均可 CreateMeetingAttendee
和 RegisterMeetingAttendee
能够查看 Webex Meetings 注册所需的与会者注册表单。
该任务有一个新的异常情况:
异常号码 | 异常消息 |
---|---|
040014 | 缺少必填字段(注册表单): ... |
例如,如果您选择“职位”和“公司名称”作为与会者 Webex Meetings 注册表单(如下所示)中的“必填”字段,则在调用以下两个 API 时,就必须在“职位”和“公司名称”中提供值: CreateMeetingAttendee
和 RegisterMeetingAttendee
。
RegisterMeetingAttendee
请求:
<body>
<bodyContent xsi:type="java:com.webex.service.binding.attendee.RegisterMeetingAttendee">
<attendees>
<person>
<name>FirstNameb LastName</name>
<firstName>FirstNameb </firstName>
<lastName>LastName</lastName>
<title>工程师</title> //职位 Cisco1234 //公司名称 ...
<company></company>
<email>****@*****。com</email>
<type></type>
<sendReminder></sendReminder>
</person>
<role></role>
<joinStatus></joinStatus>
<emailInvitations></emailInvitations>
<sessionKey>1####4####1</sessionKey>
</attendees>
</bodyContent>
</body>
CreateMeetingAttendee
请求:
<bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<person>
<name>FirstNameA LastName</name>
<firstName>FirstNameA</firstName>
<lastName>LastNameA</lastName>
<title>工程师</title> //职位 Cisco1234 //公司名称 ...
<company></company>
<email>*****@*****。com</email>
<type></type>
<sendReminder></sendReminder>
</person>
<role></role>
<joinStatus></joinStatus>
<emailInvitations></emailInvitations>
<sessionKey>1###4####1</sessionKey>
040014 Exception of Response
例如:
<?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:header>
<serv:response>
<serv:result>失败</serv:result>
<serv:reason>缺少必填字段(注册表):职称,公司</serv:reason>
<serv:gsbStatus>主要</serv:gsbStatus>
<serv:exceptionID>040014</serv:exceptionID>
<serv:value>职称,公司</serv:value>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
受影响的 API:
CreateMeetingAttendee
RegisterMeetingAttendee
XML API 电子邮件验证增强功能
XML API 不应允许电子邮件中包含空格字符,因此我们增强了电子邮件验证功能,以与“Webex Meetings”页面行为保持一致。
受影响的 API:
CreateMeetingAttendee
CreateEvent
SetEvent
CreateContact
SetContact
SetRecordingInfo
CreateMeetingAttendee
CreateTrainingSession
SetTrainingSession
CreateUser
SetUser
CreateMeeting
SetMeeting
RegisterMeetingAttendee
API 40.7.0 更新
XML API 40.7.0 更新
meetingUUID
支持
我们已 meetingUUID
在支持 meetingKey 或 sessionKey 的位置向 API 请求和响应添加会议 UUID。
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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
GetSessionInfo
响应示例:
<?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>成功</serv:result>
<serv:gsbStatus>主</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>不_进行中</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
受影响的 API:
LstmeetingattendeeHistory
LsttrainingattendeeHistory
LsteventattendeeHistory
LstsupportattendeeHistory
CreateUser
API 欢迎电子邮件支持四种新语言
XMLAPI 欢迎 html 电子邮件支持以下四种新语言:
捷克语 (languageID=19)
波兰语 (languageID=20)
匈牙利语 (languageID=21)
罗马尼亚语 (languageID=22)
XML API 将根据请求中的语言或语言标识发送欢迎电子邮件 CreateUser
请求。
使用 CreateUser
发送 Html 欢迎电子邮件示例(捷克语):
<?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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>测试</firstName>
<lastName>用户</lastName>
<webExId>测试用户</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<privilege>
<host>真</host>
</privilege>
<languageID>19</languageID>
或
<language>捷克语</language>
<active>已激活</active>
<sendWelcome>真</sendWelcome>
<isHTMLEmail>真</isHTMLEmail>
</bodyContent>
</bodyContent>
</body>
API 40.6.1、40.4.9 更新
XML API 40.6.1、40.4.9 更新
CreateMeeting/SetMeeting
支持
安排 Webex 会议时,XML API CreateMeeting/SetMeeting
允许您在与会者注册表单中选中/取消选中或单击必填或非必填字段。
以下是用户网页上的会议安排示例,您可以在其中选中与会者注册表单中的必填字段,例如“职位”、“公司名称”、“县/市”及“省/自治区”:
以下是页面字段和 XML API 元素之间的映射:
页面字段 | XMLAPI 元素 |
---|---|
职位 | <title> |
Company Name(公司名称) | <company> |
地址 1 | <address1> |
地址 2 | <address2> |
City | <city> |
状态 | <state> |
邮政编码 | <postalCode> |
国家/地区 | <country> |
工作电话 | <phone> |
传真 | <fax> |
已更改架构: 将“registrationForm”元素添加到 CreateMeeting
已更改架构: 将“registrationForm”元素添加到 SetMeeting
已更改架构: 将“registrationForm”元素添加到 GetMeeting
CreateMeeting
请求示例:
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<accessControl>
<meetingPassword>密码</meetingPassword>
</accessControl>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>false</auto>
</attendeeOptions>
<registrationForm>
<title><req>true</req></title> <!-- true -->
<company><req>真</req></company><!-- true -->
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>真</req></city><!-- true -->
<state><req>真</req></state><!-- true -->
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</registrationForm>
SetMeeting
请求示例:
<bodyContent xsi:type="java:com.webex.service.binding.meeting.SetMeeting">
<meetingkey>1015045339</meetingkey>
<metaData>
<confName>会议名称</confName>
<meetingType>3</meetingType>
</metaData>
<attendeeOptions>
<emailInvitations>true</emailInvitations>
<registration>true</registration>
<auto>true</auto>
</attendeeOptions>
<registrationForm>
<title><req>true</req></title>
<company><req>真</req></company>
<address1><req>false</req></address1>
<address2><req>false</req></address2>
<city><req>真</req></city>
<state><req>真</req></state>
<postalCode><req>false</req></postalCode>
<country><req>false</req></country>
<phone><req>false</req></phone>
<fax><req>false</req></fax>
</registrationForm>
GetMeeting
响应示例:
<meet:sipURL>1234567890@sitename.webex.com</meet:sipURL>
<meet:displayMeetingUrl>1234567890@sitename.webex.com</meet:displayMeetingUrl>
<meet:registrationForm>
<meet:phone><meet:req>false</meet:req></meet:phone>
<meet:title><meet:req>真</meet:req></meet:title>
<meet:company><meet:req>真</meet:req></meet:company>
<meet:address1><meet:req>false</meet:req></meet:address1>
<meet:address2><meet:req>false</meet:req></meet:address2>
<meet:city><meet:req>真</meet:req></meet:city>
<meet:state><meet:req>真</meet:req></meet:state>
<meet:postalCode><meet:req>false</meet:req></meet:postalCode>
<meet:country><meet:req>false</meet:req></meet:country>
<meet:fax><meet:req>false</meet:req></meet:fax>
</meet:registrationForm>
受影响的 API:
CreateMeeting
SetMeeting
GetMeeting
DelMeeting
E2EE 会议类型不支持 PMR 会议
如果在使用 API 进行通话期间启用 PMR: CreateUser/SetUser/GetUser/GetMe
并且只有 E2EE 会议类型可供使用,那么将响应以下错误消息: “110063 用户必须至少有一个非 E2EE 会议类型才能启用 PMR。”
受影响的 API:
CreateUser
SetUser
GetUser
GetMe
API 40.6.0 更新
XML API 40.6.0 更新
添加了用户管理角色
我们创建了用户管理角色,并更改了以下架构文件。
已更改架构: CreateUser
请求:
已更改架构: SetUser
已更改架构: GetMe
响应:
已更改架构: LstsummaryUser
响应:
受影响的 API:
CreateUser
SetUser
GetMe
LstsummaryUser
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">
<header>
<securityContext>
<siteName>xxx</siteName>
<webExID>站点管理</webExID>
<password>xxxx</password>
</securityContext>
</header>
<body>
<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>
<privilege>
<umSiteAdmin>真</umSiteAdmin>
<host>false</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilege>
<languageID>3</languageID>
<active>已激活</active>
<sendWelcome>真</sendWelcome>
<isHTMLEmail>真</isHTMLEmail>
</bodyContent>
</body>
支持使用 API 密钥访问 GetUserCard
我们现在支持使用 API 密钥(生成的 JWT 令牌)访问 API: GetUserCard
(在此发行版中)。
您可以参考以下页面了解如何应用 API 密钥和生成 JWT 令牌:
GetUserCard
请求示例:
POST https://{sitename}.webex.com/WBXService/XMLService
Header:
内容类型应用程序/json;charset=utf-8
JWTToken ${jwttoken}
正文:
<?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>
</message>
响应示例:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>成功</serv:result>
<serv:gsbStatus>主</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:avatar>
<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:personalMeetingRoom>
<use:title>测验的个人会议室</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
</serv:body>
</serv:message>
支持 meetingUUID
在 API 请求和响应中
我们已 meetingUUID
在支持 meetingKey 或 sessionKey 时向 API 请求和响应添加。
受影响的 API:
LstRecording
LstsummarySession
GetSesssionInfo
GethosturlMeeting
GetjoinurlMeeting
LstMeetingAttendee
CreateMeeting
SetMeeting
GetMeeting
DelMeeting
LstCalendarSession
meetingUUID
请求示例:
<?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>测试</webExID>
<password>xxx</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
或
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
</serv:message>
meetingUUID
响应示例:
<?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>成功</serv:result>
<serv:gsbStatus>主</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>不_进行中</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
临时停用用户或禁用 PMR 不会更改 PMR 会议密钥
当临时停用的用户或禁用的 PMR 在一周内重新激活时,现在重新激活的用户或启用的 PMR 的会议密钥不会更改,与之前相同。
受影响的 API:
SetUser
DelUser
LstSummarySession
增强功能
我们增强了 API: LstSummarySession
返回已安排的 PMR,从而包含一个新元素 returnScheduledPMR
(在请求中)。 功能切换缺省设置为关闭。
受影响的 API:
LstSummarySession
架构更改:
我们添加了一个新的元素名称 returnScheduledPMR
(在 API LstSummarySession 请求中)。
我们添加了一个新的元素名称 isScheduledPMR
(在 API LstSummarySession 响应中)。
LstSummarySession
请求示例:
<?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>xxx</siteName>
<webExID>测试</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>和</listMethod>
</listControl>
<dateScope>
<startDateStart>2019年11月1日8:0:0</startDateStart>
<startDateEnd>2019年12月1日7:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>2019年11月1日8:0:0</endDateStart>
<endDateEnd>2019年12月1日7:59:59</endDateEnd>
</dateScope>
<order>
<orderBy>主机WEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>配置名</orderBy>
<orderAD>ASC</orderAD>
<orderBy>开始时间</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
</serviceTypes>
<returnScheduledPMR>真</returnScheduledPMR>
</bodyContent>
</body>
</serv:message>
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>成功</serv:result>
<serv:gsbStatus>主</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>团队会议</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>测试</ep:hostWebExID>
<ep:hostFirstName>测试</ep:hostFirstName>
<ep:hostLastName>测试</ep:hostLastName>
<ep:otherHostWebExID>测试</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00,夏威夷(檀香山)</ep:timeZone>
<ep:status>不_进行中</ep:status>
<ep:startTime>2019年10月12日00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>公开</ep:listStatus>
<ep:hostEmail>Test@webex.com</ep:hostEmail>
<ep:passwordReq>真</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672157056861215</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>真</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>真</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>真</ep:isScheduledPMR>
</ep:session>
<ep:session>
<ep:sessionKey>805660167</ep:sessionKey>
<ep:confName>xmlmc Molly08 816960001</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Molly08 81696000</ep:hostWebExID>
<ep:hostFirstName>Molly08 81696000</ep:hostFirstName>
<ep:hostLastName>Molly08 81696000</ep:hostLastName>
<ep:otherHostWebExID>Molly08 81696000</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00,夏威夷(檀香山)</ep:timeZone>
<ep:status>不_进行中</ep:status>
<ep:startTime>2019年10月12日00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>公开</ep:listStatus>
<ep:hostEmail>Molly08 81696000@webex.com</ep:hostEmail>
<ep:passwordReq>真</ep:passwordReq>
<ep:hostJoined>false</ep:hostJoined>
<ep:participantsJoined>false</ep:participantsJoined>
<ep:confID>141672108716459038</ep:confID>
<ep:registration>false</ep:registration>
<ep:isRecurring>真</ep:isRecurring>
<ep:hostType>1019001</ep:hostType>
<ep:isAudioOnly>false</ep:isAudioOnly>
<ep:isTCSingleRecurrence>false</ep:isTCSingleRecurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>真</ep:isCETMeeting>
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>false</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:recurrenceId>0</ep:recurrenceId>
<ep:isScheduledPMR>真</ep:isScheduledPMR>
</ep:session>
</serv:bodyContent>
</serv:body>
</serv:message>
GetSite
增强功能
我们已添加 GetSite
响应功能切换 SupportXMLAPIReturnScheduledPMR
受影响的 API:
GetSite
架构更改:
XML API GetSite
响应新元素为: SupportXMLAPIReturnScheduledPMR
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>测试</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
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:header>
<serv:response>
<serv:result>成功</serv:result>
<serv:gsbStatus>主要</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>
</serv:body>
</serv:message>
API 40.4.8、40.2.9 更新
XML API 40.4.8、40.2.9 更新
在 XMLAPI 中更新已安排的会议时的新增响应
当客户使用 XMLAPI 更新通过其页面安排的会议时,我们会在会议电子邮件更新中发送数字密码,并将其应用于 Webex Meetings、Teams 和 Events Center。
这些 API: GetMeeting, GetTrainingSession, GetEvent
和 GetTeleconferenceSession
将以下新元素作为响应: audioPassword
(数字密码) isEnforceAudioPassword
, isEnforceAudioLogin
适用于 Webex Meetings、Teams 和 Events 中心。
已更改架构:
受影响的 API:
GetMeeting
GetTrainingSession
GetEvent
GetTeleconferenceSession
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>测试</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>
</serv:message>
响应示例:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns: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>成功</serv:result>
<serv:gsbStatus>主</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>真</meet:isEnforceAudioPassword>
<meet:isEnforceAudioLogin>false</meet:isEnforceAudioLogin>
</meet:accessControl>
…
...
</serv:bodyContent>
</serv:body>
</serv:message>
API 40.4.5, 40.2.6 更新
XML API 40.4.5, 40.2.6 更新
GetUserCard
和 GetSessionInfo
使用限制
我们对 API 实施使用限制 GetUserCard
和 GetSessionInfo
,您可能会收到错误消息: 如果达到使用限制,将显示“403 禁止访问”。
受影响的 API:
GetUserCard
GetSessionInfo
API 40.4.4, 40.2.5 更新
XML API 40.4.4, 40.2.5 更新
BodyContent
数量限制
我们已增加有限数量的 BodyContent
(在每个 XML API 部分中)。 如果添加过多 BodyContent
(在 API 请求中),将返回以下错误代码和消息: “000053 请求中的 BodyContent 计数必须少于 {number} 个”
受影响的 API:
任意 XML API
具有多个以下内容的 XML API 请求 BodyContent
例如:
<?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>
API 40.4.3, 40.2.4 更新
XML API 40.4.3, 40.2.4 更新
CreateUser
增强功能
我们已增强 CreateUser
可支持多种语言的欢迎电子邮件。 这个 CreateUser
立即请求 isHTMLEmail
受影响的 API:
CreateUser
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">
<header>
<securityContext>
<webExID>管理员</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</header>
<body>
<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>
<privilege>
<host>真</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilege>
<languageID>3</languageID>
<active>已激活</active>
<sendWelcome>真</sendWelcome>
<isHTMLEmail>真</isHTMLEmail>
</bodyContent>
</body>
API 40.4.0 更新
XML API 40.4.0 更新
在 XML API 中更改电子邮件时强制执行电子邮件验证
当站点管理员在 Webex 站点管理中启用用户更新电子邮件地址时需要确认后:
如果非站点管理员帐户调用
SetUser
API 以更改电子邮件地址,那么在新的电子邮件地址得到验证之前,将保留当前电子邮件地址。 帐户更改确认电子邮件将通过“Webex 帐户更改确认”发送至新的电子邮件地址。 单击电子邮件中的链接进行确认后,将立即关联新的电子邮件地址。
如果非站点管理员调用
SetUser
API 多次,但 没有完成电子邮件地址验证过程,则会保留当前电子邮件地址,并且必须验证最新的电子邮件地址。如果站点管理员帐户调用
SetUser
API 以更改电子邮件地址,那么不会触发电子邮件地址验证过程。 新电子邮件将立即与主持人或与会者的帐户关联。
受影响的 API:
SetUser
GetEnrollmentInfo
超时和连接重设
这个 GetEnrollmentInfo
API 当前在域名系统中查找 IP 地址,这会对性能产生巨大影响。 我们计划简化该流程,并在以下字段中留出空白响应 <domain>
。
受影响的 API:
GetEnrollmentInfo
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.Get Info">
<sessionKey>716773566</sessionKey>
</body>
</serv:message>
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:header>
<serv:response>
<serv:result>成功</serv:result>
<serv:gsbStatus>主</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:attendee>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>亚历克斯</att:firstName>
<att:lastName>扬</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>2020年2月27日22:03:57</att:submitTime>
<att:status>已批准</att:status>
</att:attendee>
<att:attendee>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>测试</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>2020年2月27日22:07:38</att:submitTime>
<att:status>已批准</att:status>
</att:attendee>
<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>
</serv:body>
API 40.2.0 更新
XML API 40.2.0 更新
删除对下列项的匿名访问 LstSummarySession
作为安全性增强功能,我们将停止支持对 API 的匿名访问 LstSummarySession
。 如果 Webex Meetings 以匿名方式访问 API,则会返回以下错误代码和消息: “000015,非常抱歉,未找到记录。”
受影响的 API:
LstSummarySession
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>站点名称1</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
</serv:message>
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: ="http://www.webex.com/schemas/2002/06/service/meeting">
<serv:header>
<serv:response>
<serv:result></serv:result>
<serv:reason> ,没有发现任何记录</serv:reason>
<serv:gsbStatus></serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
CreateMeeting
和 SetMeeting
安全性增强功能
此更改是在 XML API 40.2.0 中进行的,但在收到客户反馈后已对其描述进行了编辑。 |
作为安全性增强功能,我们已更新 CreateMeeting
和 SetMeeting
API,不允许用户安排已过去的会议开始时间。 如果他们试图这样做,API 将提示错误消息: “060016 课程开始时间应晚于当前时间。” 如果用户需要安排即时会议,我们建议将会议开始时间设置为比当前时间晚 5 分钟。
受影响的 API:
CreateMeeting
SetMeeting
API 40.1.2 更新
XML API 40.1.2 更新
如果没有提供密码,在安排会议时会自动生成密码
我们已增强 CreateMeeting
, CreateEvent
, CreateTrainingSession
和 CreateTeleconferenceSession
在 API 响应的正文中加入密码。
缺省情况下,所有会议/活动/课程都必须包含密码设置处于启用状态。 在这种情况下,如果 API 请求中不包含密码,系统会自动从 XML API 服务器生成密码。
如果所有会议/活动/课程都必须包含密码设置被禁用,并且 API 请求中不包含密码,则不会从 XML API 服务器生成密码。
如果 API 请求中包含密码,则无论所有会议/活动/课程都必须包含密码设置被启用还是禁用,响应都将包含该密码。
受影响的 API:
CreateMeeting
CreateEvent
CreateTrainingSession
CreateTeleconferenceSession
这个 CreateMeeting
响应现在包含 meetingPassword
元素:
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>站点名称1</siteName>
<webExID>用户ID</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>2020年10月28日17:35:00</startDate>
</schedule>
</bodyContent>
</body>
</serv:message>
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:header>
<serv:response>
<serv:result>成功</serv:result>
<serv:gsbStatus>主</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>
<serv:host>https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
<serv:attendee>https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
</meet:iCalendarURL>
<meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
</serv:bodyContent>
</serv:body>
</serv:message>
这个 CreateEvent
响应现在包含 eventPassword
元素:
这个 CreateTrainingSession
和 CreateTeleconferenceSession
响应现在包含 sessionPassword
元素:
API 40.1.0 更新
XML API 40.1.0 更新
GetSessionInfo
增强功能
我们已将新元素添加到 GetSessionInfo
。 现在,该 API 还会返回移动设备的信息。
受影响的 API:
GetSessionInfo
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>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>
<pmrUrl>https://go.webex.com/join/dongchen</pmrUrl>
<sipUrl>dongchen@go.webex.com或123456789_go@webex.com或123456789@go.webex.com</sipUrl>
<meetingLink>https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</body>
</serv:message>
LstAccessAnywhereHistory
增强功能
我们添加了一个新的 API lstAccessAnywhereHistory
,以便使用 Webex Access Anywhere 报告信息作出响应。
受影响的 API:
LstAccessAnywhereHistory
LstAccessAnywhereHistory
请求更新:
LstAccessAnywhereHistory
响应更新:
请求示例:
<?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>test</webExID>
<password>P@ss1234</password>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>09/29/2019 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>12/29/2019 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>9/29/2019 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>12/29/2019 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>OR</serv:listMethod>
</listControl>
<order>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</order>
</bodyContent>
</body>
响应示例:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message
xmlns:serv="http://www.webex.com/schemas/2002/06/service"
xmlns:com="http://www.webex.com/schemas/2002/06/common"
xmlns:历史记录="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>成功</serv:result>
<serv:gsbStatus>主</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>院长</history:userName>
<history:computerName>6926_dean</history:computerName>
<history:clientIP>10.224.222.183</history:clientIP>
<history:startTime>2019年11月29日03:05:44</history:startTime>
<history:endTime>2019年11月29日03:10:06</history:endTime>
<history:duration>5</history:duration>
</history:accessAnyWhereInfo>
</serv:body>