XML API 39 및 XML API 11에 대한 자세한 정보는 Cisco Webex Meetings XML API 업데이트 개요 (XML API 39 이하)를 참조하십시오.

XML API 11 SP9 이하에 대한 업데이트는 Cisco DevNet으로 이동합니다.

API 40.10.0 업데이트

XML API 40.10.0 업데이트

여기를 클릭하여 XML API 40.10.0 스키마를 다운로드합니다.

API 요청 및 응답에서 미팅 UUID에 대한 XML 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>Test</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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>NOT_INPROGRESS</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 앱에서 최종 사용자가 화면 캡처를 실행하도록 허용하지 않고자 합니다. 반면 다른 고객은 화면 캡처를 허용하는 이 기능을 사용하고자 할 수 있습니다. 또한, 교육 사용자도 화면 캡처를 허용하고자 할 수 있습니다. 따라서 이 기능에 대한 사이트 관리자 구성을 포함하며, XMLAPI는 이를 지원하기 위해 GetSite의 응답에 추가 필드인 EnableMobileScreenCapture를 반환합니다.

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>
</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>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:body>
</serv:message>

적용되는 API

GetSite

XMLAPI 지원 MEET-269 PIN-less 참여 향상점

XMLAPI 새로운 옵션 추가 내 조직에 있는 비디오 회의 시스템은 프롬프트 없이 미팅을 시작하고 참여할 수 있음 (개인 룸 미팅 및 MC 미팅용)

  • createUser/setUser/getUser 새로운 노드 deviceCanStartMyPMR personalMeetingRoom에서 추가합니다.

  • createMeeting/setMeeting/getMeeting 새로운 노드 deviceCanStartMeeting을 예약에 추가합니다.

Webex UI에 있는 개인 룸 미팅에 대한 옵션:

스키마 변경 사항

CreateUser:

SetUser:

getUserResponse:

CreateMeeting:

setMeeting:

getMeetingResponse:

API 40.9.0 업데이트

XML API 40.9.0 업데이트

여기를 클릭하여 XML API 40.9.0 스키마를 다운로드합니다.

요청 및 응답에서 미팅 UUID에 대한 XML API 지원

meetingKey 또는 sessionKey로 지원하는 장소에서 미팅 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>Test</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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>NOT_INPROGRESS</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 미팅에는 사용자가 미팅에 참여하기 위해 대기할 수 있는 잠긴 미팅 로비가 포함됩니다.

기능(ConsistentLockedLobby)이 켜지면 잠긴 로비를 지원하기 위한 XML API 예약 및 MC 미팅 편집.

스키마 변경 사항

세 개의 새로운 구성 요소(externalAttendeeSecurity, autoLock, autoLockWaitTime)를 CreateMeeting, SetMeeting 및 GetMeeting API에 추가했습니다.

구성 요소

설명

externalAttendeeSecurity

미팅이 잠금 해제되면 세 개의 외부 사용자 보안 항목 중에서 선택할 수 있습니다.

AllowJoin: 즉시 미팅에 참여할 수 있음

AllowJoinWithLobby: 호스트가 허용하는 경우에만 미팅에 참여할 수 있음

BlockFromJoin: 미팅에 참여할 수 없음

autoLock

미팅을 자동으로 잠글지 여부.

True: 미팅이 시작한 지 #분 후에 미팅을 자동으로 잠그기

False: 미팅이 시작한 후 미팅을 자동으로 잠그지 않음

autoLockWaitTime

미팅 시작 후 자동으로 미팅을 잠그는 시간(분) (0,5,10,15,20)

요청 및 응답 샘플

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>
</body>
</serv:message>

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>
</body>
</serv:message>

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: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"> ... <meet:attendeeOptions> ... <meet:joinRequiresAccount>false</meet:joinRequiresAccount>
                <meet:externalAttendeeSecurity>AllowJoin</meet:externalAttendeeSecurity>
                <meet:autoLock>true</meet:autoLock>
                <meet:autoLockWaitTime>10</meet:autoLockWaitTime>
            </meet:attendeeOptions> ... </bodyContent>
</body>
</serv:message>

적용되는 API:

  • CreateMeeting

  • SetMeeting

  • GetMeeting

진행 중인 세션에서 참가자의 상태를 반환하기 위해 강화된 GetSessionInfo API

두 개의 새로운 구성 요소(hasHostInMeeting, hasAttendeeInMeeting)를 GetSessionInfo의 응답에 추가했습니다. 미팅이 진행 중일 때 다음 두 개의 구성 요소가 반환됩니다.

구성 요소

설명

hasHostInMeeting

호스트가 진행 중인 미팅에 참여했는지 여부.

True: 호스트가 진행 중인 미팅에 있습니다.

False/Null: 호스트가 진행 중인 미팅에 없거나, 미팅이 진행되지 않고 있습니다.

hasAttendeeInMeeting

참석자/호스트가 진행 중인 미팅에 참여했는지 여부.

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: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> ... </bodyContent>
</body>
</serv:message>

적용되는 API:

GetSessionInfo

API GetUserCard에 인증이 필요합니다.

보안 향상점 사용자의 정보를 얻으려면 XML API GetUserCard에 인증이 필요합니다.

적용되는 API:

GetUserCard

API 40.8.0 업데이트

XML API 40.8.0 업데이트

여기를 클릭하여 XML API 40.8.0 스키마를 다운로드합니다.

GetSessionInfo 응답 향상점

초대받지 않았거나 미팅에서 승인하지 않은 경우, XML API: GetSessionInfo에 대한 통화는 API 응답 본문에 다음 구성 요소를 반환하지 않습니다. confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl.

Meetings에 대한 API 응답 예제:

<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <ep:status>NOT_INPROGRESS</ep:status>
    <ep:sessionkey>1####2###4</ep:sessionkey>
    <ep:accessControl>
        <ep:listStatus>비공개</ep:listStatus>
        <ep:registration>false</ep:registration>
        <ep:passwordReq>true</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>true</ep:isAllowJBH>
    <ep:isCETMeeting>true</ep:isCETMeeting>
    <ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
</serv:bodyContent>

Trainings/Events에 대한 API 응답 예제:

<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <ep:status>NOT_INPROGRESS</ep:status>
    <ep:sessionkey>1####5###9</ep:sessionkey>
    <ep:accessControl>
        <ep:listStatus>비공개</ep:listStatus>
        <ep:registration>true</ep:registration>
        <ep:registrationURL>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>초대/등록/거절</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>true</ep:isAllowJBH>
    <ep:isCETMeeting>true</ep:isCETMeeting>
    <ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
</serv:bodyContent>

적용되는 API:

  • GetSessionInfo

GetSessionInfo, GetUserCard보안 향상점

XML API GetSessionInfoGetUserCard에 대한 보안을 강화했습니다. 한 시간 제한에 도달한 사용자의 통화에서 오류를 발견한 경우(데이터 포함되지 않음), 향후 두 시간 동안 사용자가 해당하는 두 개의 API에 액세스하지 못하게 차단합니다.

오류 상태 응답은 다음과 같습니다. "403 금지됨"

적용되는 API:
  • GetSessionInfo

  • GetUserCard

meetingUUID API 요청 및 응답 지원

meetingKey/sessionKey를 지원하는 장소에서 meetingUUID를 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>Test</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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>NOT_INPROGRESS</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 CreateMeetingAttendeeRegisterMeetingAttendee 지원

CreateMeetingAttendeeRegisterMeetingAttendee 모두 Webex Meetings 등록에 대해 참석자 등록 요구됨 양식을 체크할 수 있습니다.

또한, 이 작업에 대한 새로운 예외가 있습니다.

예외 번호

예외 메시지

040014

필수 필드 누락됨 (등록 양식): ...

예를 들어, 참석자 Webex Meetings 등록에 대해 아래와 같이 "직위" 및 "회사명"을 필수 필드로 선택한 경우, 다음 두 개의 API에 전화할 때 "직위" 및 "회사명"에 값을 제공해야 합니다. CreateMeetingAttendeeRegisterMeetingAttendee.

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> //Job Title <company>Cisco1234</company> //Company Name ... <email>****@*****.com</email>              
                    <type>방문자</type>
                    <sendReminder>true</sendReminder>
                </person>
                <role>참석자</role>
                <joinStatus>수락</joinStatus>
                <emailInvitations>true</emailInvitations>
                <sessionKey>1####4####1</sessionKey>
            </attendees>
        </bodyContent>  
    </body>
</serv:message>

CreateMeetingAttendee 요청:

<bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
        <person>
            <name>FirstNameA LastNameA</name>
            <firstName>FirstNameA</firstName>
            <lastName>LastNameA</lastName>
            <title>엔지니어</title> //Job Title <company>Cisco1234</company> //Company Name ... <email>*****@*****.com</email>
            <type>방문자</type>
            <sendReminder>true</sendReminder>
        </person>
    <role>참석자</role>
    <joinStatus>수락</joinStatus>
    <emailInvitations>true</emailInvitations>
    <sessionKey>1###4####1</sessionKey>

040014 응답 예외예제:

<?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>FAILURE</serv:result>
            <serv:reason>필수 필드 누락됨 (등록 양식) : title,company</serv:reason>
            <serv:gsbStatus>PRIMARY</serv:gsbStatus>
            <serv:exceptionID>040014</serv:exceptionID>
            <serv:value>title,company</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 업데이트

여기를 클릭하여 XML API 40.7.0 스키마를 다운로드합니다.

meetingUUID 지원

meetingKey 또는 sessionKey를 지원하는 장소에서 meetingUUID를 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>Test</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>Test</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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>NOT_INPROGRESS</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 4개의 새로운 언어에 대해 API 환영 이메일 지원

XMLAPI 환영 html 이메일은 다음 네 개의 새로운 언어를 지원합니다.

  • 체코어 (languageID=19)

  • 폴란드어 (languageID=20)

  • 헝가리어 (languageID=21)

  • 루마니아어 (languageID=22)

XMLAPI는 CreateUser 요청에 있는 언어 또는 languageID에 따라 환영 이메일을 보냅니다.

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>Test</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>test</firstName>
                <lastName>user</lastName>
                <webExId>testuser</webExId>
                <password>xxxxxx</password>
                <email>testuser@test.com</email>
                <privilege>
                    <host>true</host>
                </privilege>
                <languageID>19</languageID> 또는 <language>체코어</language>
                <active>활성화됨</active>
                <sendWelcome>true</sendWelcome>
                <isHTMLEmail>true</isHTMLEmail>
            </bodyContent>
        </bodyContent>
    </body>
</serv:message>

API 40.6.1, 40.4.9 업데이트

XML API 40.6.1, 40.4.9 업데이트

여기를 클릭하여 XML API 40.6.1 스키마를 다운로드합니다.

여기를 클릭하여 XML API 40.4.9 스키마를 다운로드합니다.

CreateMeeting/SetMeeting 지원

Webex 미팅을 예약할 때 XML API CreateMeeting/SetMeeting을 통해 참석자 등록 양식에서 필수 또는 선택 필드를 체크/체크 해제하거나 클릭할 수 있습니다.

다음은 사용자 웹 페이지의 샘플 미팅 예약입니다. 여기에서 참석자 등록 양식에 있는 "직위", "회사명", "도시""주/도" 등의 필수 필드를 체크할 수 있습니다.

다음은 페이지 필드와 XML API의 구성 요소 간의 매핑입니다.

페이지 필드 XMLAPI 구성 요소
직위
<title>
회사명
<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>password</meetingPassword>
      </accessControl>    
      <attendeeOptions>
          <emailInvitations>true</emailInvitations>
          <registration>true</registration>
          <auto>false</auto>
      </attendeeOptions>      
      <registrationForm>
          <title><req>true</req></title>          <!-- true -->
          <company><req>true</req></company>      <!-- true -->
          <address1><req>false</req></address1>
          <address2><req>false</req></address2>
          <city><req>true</req></city>            <!-- true -->
          <state><req>true</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>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>
    </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>true</meet:req></meet:title>        
                <meet:company><meet:req>true</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>true</meet:req></meet:city>          
                <meet:state><meet:req>true</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>
        </serv:bodyContent>
    </serv:body>
</serv:message>

적용되는 API:

  • CreateMeeting

  • SetMeeting

  • GetMeeting

  • DelMeeting

E2EE 미팅 유형은 PMR 미팅을 지원하지 않습니다.

통화 중에 API로 PMR을 활성화할 때:CreateUser/SetUser/GetUser/GetMe 및 E2EE 미팅 유형만 사용할 수 있으며, 이는 다음 오류 메시지에 응답합니다. "110063 PMR을 활성화하려면 사용자는 최소한 한 개의 비-E2EE 미팅 유형을 갖고 있어야 합니다."

적용되는 API:

  • CreateUser

  • SetUser

  • GetUser

  • GetMe

API 40.6.0 업데이트

XML 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>SiteAdmin</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>true</umSiteAdmin>
        <host>false</host>

        <siteAdmin>false</siteAdmin>
        <labAdmin>false</labAdmin>
        <voiceOverIp>false</voiceOverIp>
    </privilege>
    <languageID>3</languageID>
    <active>활성화됨</active>
    <sendWelcome>true</sendWelcome>
    <isHTMLEmail>true</isHTMLEmail>
</bodyContent>  
</body>
</serv:message>

API 키를 사용하여 GetUserCard에 액세스 지원

이제 API 키(생성된 JWT 토큰)를 사용하여 API에 대한 액세스를 지원합니다. 이 릴리즈의 GetUserCard.

다음 페이지를 참조하여 하나의 API 키를 적용하고 JWT 토큰을 생성하는 방법에 대해 확인할 수 있습니다.

한 개의 API 키를 적용하는 방법

JWT 토큰을 생성하는 방법

GetUserCard요청 예제:

POST https://{sitename}.webex.com/WBXService/XMLService 머리글: Content-Type application/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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>Test's Personal Room</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>

API 요청 및 응답에서 meetingUUID에 대한 지원

meetingKey 또는 sessionKey를 지원할 때 meetingUUID를 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>Test</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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>NOT_INPROGRESS</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

스키마 변경:

API LstSummarySession 요청에 새로운 구성 요소 이름 returnScheduledPMR을 추가합니다.

API LstSummarySession 응답에 새로운 구성 요소 이름 isScheduledPMR을 추가합니다.

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>Test</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>AND</listMethod>
         </listControl>
         <dateScope>
            <startDateStart>11/01/2019 8:0:0</startDateStart>
            <startDateEnd>12/01/2019 7:59:59</startDateEnd>
            <timeZoneID>4</timeZoneID>
            <endDateStart>11/01/2019 8:0:0</endDateStart>
            <endDateEnd>12/01/2019 7:59:59</endDateEnd>
         </dateScope>
         <order>
            <orderBy>HOSTWEBEXID</orderBy>
            <orderAD>ASC</orderAD>
            <orderBy>CONFNAME</orderBy>
            <orderAD>ASC</orderAD>
            <orderBy>STARTTIME</orderBy>
            <orderAD>ASC</orderAD>
         </order>
         <serviceTypes>
            <serviceType>EventCenter</serviceType>
            <serviceType>MeetingCenter</serviceType>
            <serviceType>SalesCenter</serviceType>
            <serviceType>TrainingCenter</serviceType>
            <serviceType>SupportCenter</serviceType>
         </serviceTypes>
         <returnScheduledPMR>true</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>SUCCESS</serv:result>
         <serv:gsbStatus>PRIMARY</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>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, 하와이 (호놀룰루)</ep:timeZone>
            <ep:status>NOT_INPROGRESS</ep:status>
            <ep:startTime>10/12/2019 00:35:41</ep:startTime>
            <ep:duration>60</ep:duration>
            <ep:listStatus>공개</ep:listStatus>
            <ep:hostEmail>Test@webex.com</ep:hostEmail>
            <ep:passwordReq>true</ep:passwordReq>
            <ep:hostJoined>false</ep:hostJoined>
            <ep:participantsJoined>false</ep:participantsJoined>
            <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>MeetingCenter</ep:serviceType>
            <ep:hostWebExID>Molly08Console81696000</ep:hostWebExID>
            <ep:hostFirstName>Molly08Console81696000</ep:hostFirstName>
            <ep:hostLastName>Molly08Console81696000</ep:hostLastName>
            <ep:otherHostWebExID>Molly08Console81696000</ep:otherHostWebExID>
            <ep:timeZoneID>2</ep:timeZoneID>
            <ep:timeZone>GMT-10:00, Hawaii (Honolulu)</ep:timeZone>
            <ep:status>NOT_INPROGRESS</ep:status>
            <ep:startTime>10/12/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:participantsJoined>
            <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>
   </serv:body>
</serv:message>

GetSite 향상점

SupportXMLAPIReturnScheduledPMR의 GetSite응답 기능 토글을 추가했습니다.

적용되는 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>Test</webExID>
   <password>xxx</password>
   <clientInfo>xxx</clientInfo>
  </securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>    
</body>
</serv:message>

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>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: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 업데이트

여기를 클릭하여 XML API 40.4.8 스키마를 다운로드합니다.

여기를 클릭하여 XML API 40.2.9 스키마를 다운로드합니다.

XMLAPI로 예약된 미팅을 업데이트할 때 새로운 응답

고객이 XMLAPI를 사용하여 페이지를 통해 예약된 미팅을 업데이트할 때 미팅 이메일 업데이트에 숫자 비밀번호를 발송하고 Webex Meetings, Teams 및 Events 센터에 적용합니다.

해당하는 API: GetMeeting, GetTrainingSession, GetEvent GetTeleconferenceSession에 다음 새로운 요소가 응답으로 포함됩니다. audioPassword (numeric password), 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>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>
</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>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">
            <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>
    </serv:body>
</serv:message>

API 40.4.5, 40.2.6 업데이트

XML API 40.4.5, 40.2.6 업데이트

GetUserCardGetSessionInfo 사용 제한

API GetUserCardGetSessionInfo에 대한 사용 제한을 실행하며, 다음과 같은 오류 메시지를 수신할 수도 있습니다. "403 금지됨" 사용 제한에 도달하는 경우.

적용되는 API:

  • GetUserCard

  • GetSessionInfo

API 40.4.4, 40.2.5 업데이트

XML API 40.4.4, 40.2.5 업데이트

BodyContent 수 제한

각 XML API 섹션에서 제한된 수의 BodyContent를 추가했습니다. API 요청에 너무 많은 BodyContent를 추가하면 다음 오류 코드 및 메시지가 반환됩니다. "000053 요청에서 BodyContent의 수는 {number} 이하이어야 합니다"

적용되는 API:

  • XML API

여러 BodyContent가 포함된 XML API 예제:

<?xml version="1.0" encoding="UTF-8"?>
<serv:message  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:serv="http://www.webex.com/schemas/2002/06/service">
<header>
    <securityContext>
    <webExID>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>
</serv:message>

API 40.4.3, 40.2.4 업데이트

XML API 40.4.3, 40.2.4 업데이트

여기를 클릭하여 XML API 40.4.3, 40.2.4 스키마를 다운로드합니다.

CreateUser 향상점

환영 이메일을 다양한 언어로 지원할 수 있도록 CreateUser를 강화했습니다. 이제 CreateUserisHTMLEmail을 요청합니다.

적용되는 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>administrator</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>true</host>
        <siteAdmin>false</siteAdmin>
        <labAdmin>false</labAdmin>
        <voiceOverIp>false</voiceOverIp>
    </privilege>
    <languageID>3</languageID>
    <active>활성화됨</active>
    <sendWelcome>true</sendWelcome>
    <isHTMLEmail>true</isHTMLEmail>
</bodyContent>  
</body>
</serv:message>

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.GetEnrollmentInfo">
            <sessionKey>716773566</sessionKey>
        </bodyContent>
    </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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>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>02/27/2020 22:03:57</att:submitTime>
                    <att:status>APPROVED</att:status>
                </att:attendee>
                <att:attendee>
                    <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>02/27/2020 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>
</serv:message>

API 40.2.0 업데이트

XML API 40.2.0 업데이트

여기를 클릭하여 XML API 40.2.0 스키마를 다운로드합니다.

LstSummarySession에 대한 익명 액세스 제거

보안을 강화하기 위해 LstSummarySession API에 대한 익명 액세스의 지원을 중지하고 있습니다. 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>sitename1</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:meet="http://www.webex.com/schemas/2002/06/service/meeting">
    <serv:header>
        <serv:response>
            <serv:result>FAILURE</serv:result>
            <serv:reason>죄송합니다. 기록을 찾을 수 없음</serv:reason>
            <serv:gsbStatus>PRIMARY</serv:gsbStatus>
            <serv:exceptionID>000015</serv:exceptionID>
        </serv:response>
    </serv:header>
    <serv:body>
        <serv:bodyContent/>
    </serv:body>
</serv:message>

CreateMeetingSetMeeting 보안 강화


이 변경 사항은 XML API 40.2.0에 적용되었지만, 해당 설명은 고객 피드백을 수신한 후에 편집되었습니다.

보안을 강화하기 위해 CreateMeetingSetMeeting API를 업데이트하여 사용자가 이미 경과한 시작 시간에 대해 미팅을 예약하지 못하게 했습니다. 사용자가 시도하는 경우, API는 오류 메시지를 나타냅니다. "060016 세션 시작 시간은 현재 시간보다 이후이어야 합니다." 사용자가 즉석 미팅을 예약해야 하는 경우, 미팅 시작 시간을 현재 시간부터 5분 이후로 설정할 것을 권장합니다.

적용되는 API:

  • CreateMeeting

  • SetMeeting

API 40.1.2 업데이트

XML API 40.1.2 업데이트

여기를 클릭하여 XML API 40.1.2 스키마를 다운로드합니다.

비밀번호가 제공되지 않은 경우, 미팅을 예약하면 비밀번호가 자동으로 생성됩니다.

CreateMeeting, CreateEvent, CreateTrainingSessionCreateTeleconferenceSession을 강화하여 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>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>10/28/2020 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>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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 구성 요소가 포함됩니다.

이제 CreateTrainingSessionCreateTeleconferenceSession 응답에 sessionPassword 구성 요소가 포함됩니다.

API 40.1.0 업데이트

XML API 40.1.0 업데이트

여기를 클릭하여 XML API 40.1 스키마를 다운로드하십시오.

GetSessionInfo 향상점

새로운 구성 요소를 GetSessionInfo API에 추가했습니다. 이제 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>
</serv:message>

응답 예제:

<?xml version="1.0" encoding="UTF-8"?>
<serv:message
    xmlns:serv="http://www.webex.com/schemas/2002/06/service"
    xmlns:com="http://www.webex.com/schemas/2002/06/common"
    xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
    <serv:header>
        <serv:response>
            <serv:result>SUCCESS</serv:result>
            <serv:gsbStatus>PRIMARY</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>11/29/2019 03:05:44</history:startTime>
                <history:endTime>11/29/2019 03:10:06</history:endTime>
                <history:duration>5</history:duration>
            </history:accessAnyWhereInfo>
        </serv:bodyContent>
    </serv:body>
</serv:message>