- Página inicial
- /
- Artigo
Visão geral das atualizações da API do Cisco Webex Meetings (API 40)
Encontre todas as informações importantes de que você precisa sobre a API Cisco Webex Meetings recente, como alterações de esquema e outros anúncios.
Para obter mais informações sobre a API XML 41, consulte a Visão geral das atualizações da API do Cisco Webex Meetings (API 41)
Para obter mais informações sobre XML API 39 e XML API 11, consulte a Visão geral das atualizações da API XML do Cisco Webex Meetings (XML API 39 e anterior).
Para atualizações para XML API 11 SP9 e anterior, vá para Cisco DevNet.
Atualizações API 40.12.0
Atualizações XML API 40.12.0
A API XML suporta o tipo de Reunião Privada
APIs XML serão impactadas
-
Podemos usar a API:
Criar reunião
eSetMeeting
para agendar ou atualizar uma reunião Webex com o tipo de reunião privada. -
Se uma reunião Webex for agendada com tipo de reunião privada,
GetSessionInfo
GetMeeting,
LstSummarySession e
LstCalendarSession
retornarão a nova nomeação de elemento que é Reunião privada para saber sobre ela.
-
GetMeetingType
eLstMeetingType
retornar um novo elemento nomeando
que indica se suporta reuniões privadas ou não.SupportPrivateMeeting
Alterações de esquema
API de XML: GetMeetingType/LstMeetingType: Acrescente o elemento.
API de XML: LstSummarySession
: Acrescente o elemento.
API de XML: Sessão de calendário
: Acrescente o elemento.
API de XML: GetSessionInfo
: Acrescente o elemento.
API de XML: Reunião Get : Acrescente o elemento.
Solicitação de XML API: CriaretingTinguação
Solicitação de Criar reunião com tipo de reunião privada
25/10/2020 13:00:00
45
45
********
MC_PrivateMeeting_Testar
168 //169 é uma amostra que suporta Reunião Privada
Resposta de XML API: ObterInformações da sesessão
Resposta para isPrivateMeeting
false
true
true //true: suporte à reunião privada; False: a reunião não suporta reunião privada.
false
false
true
A API getSite retornará os modelos de reunião no nível do site
Descrição da Tarefa/História do Usuário
GetSite API para retornar o modelo de reunião no nível do site. Isso permitirá que o Education Connector e o Webex Classrooms mostrem esses modelos para os professores escolherem e escolherem esses modelos enquanto agendam suas sessões on-line.
APIs impactados
Se houver modelos de reunião personalizados a nível de site, a API GetSite retornará esses modelos no nível do site.
Nome dos elementos |
Descrição |
---|---|
|
o nome de modelos de reunião personalizados no nível do site |
|
Webex Meetings, Webex Trainings e Webex Events |
Alterações de esquema
GetSite : Acrescente o elemento.
Amostra de resposta
Resposta getSite
<ns1: meetingTypes>
<ns1:meetingTypeID>3</ns1:meetingTypeID>
<ns1:meetingTypeName>PRO</ns1:meetingTypeName>
</ns1:meetingTypes>
<ns1: meetingTemplates>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Modelo de reunião MC 1</ns1:meetingTemplateName>
<ns1:serviceType>MeetingCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Modelo de reunião EC 2</ns1:meetingTemplateName>
<ns1:serviceType>EventCenter</ns1:serviceType>
</ns1:meetingTemplate>
<ns1:meetingTemplate>
<ns1:meetingTemplateName>Modelo de reunião TC 3</ns1:meetingTemplateName>
<ns1:serviceType>TrainingCenter</ns1:serviceType>
</ns1:meetingTemplate>
</ns1:meetingTemplates>
XML API SetUser não pode alterar elemento de Serviços suportados
quando o site é um site unificado CI
Descrição
XmlAPI SetUser não suporta o valor de alteração de " Serviços suportados " em uma solicitação de API quando o site é um Control Hub vinculado a sites Unified
Webex Meeting.
Alterações de esquema
Não há nenhuma alteração de esquema na API: SetUser
.
WEBEX-15436: Adicionar proteção para evitar e-mails duplicados em Mtgconfattendeelist
Descrição
Se vários participantes com o mesmo e-mail são adicionados à mesma reunião na mesma solicitação de API, apenas processaremos o primeiro participante com o e-mail.
APIs impactadas
-
CriaretingAttendee
-
Createuser
-
Setuser
-
CriaretingTinguação
-
Definireting
-
Createevent
-
Setevent
-
Criar treinamentoSessão
-
Definir treinamentoSessão
Api de amostra
Solicitação
<?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">
<cabeçalho>
<securityContext>
<siteName>testSite</siteName>
<webExID>testUser</webExID>
<password>senha</password>
</securityContext>
</cabeçalho>
<head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/></head><body>
<bodyContent xsi:type="java:com.webex.service.binding.attendee.CreateMeetingAttendee">
<sessionKey>1714904382</sessionKey>
<pessoa>
<email>test@webex.com</email>
<name>name1</name>
</pessoa>
<convidados>
<pessoa>
<email>test@webex.com</email>
<name>name2</name>
</pessoa>
<sessionKey>1714904382</sessionKey>
</convidados>
</bodyContent>
</body>
Atualizações api 40.11.0
Atualizações XML API 40.11.0
XMLAPI CreateUser suporta displayname
CreateUser
suporta dispalyname
quando a alternância de recursos EnableDisplayName
é como 1. Se a alternância de recursos não for 1, o nome de
exibição será ignorado.
Alterações de esquema
Createuser:
XMLAPI SetUser suporta displayname
SetUser
suporta dispalyname
quando a alternância de recursos EnableDisplayName
é 1. Se a alternância de recursos não for 1, o nome de
exibição será ignorado.
Alterações de esquema
Setuser:
XMLAPI GetUser suporta displayname
GetUser
suporta dispalyname
quando a alternância de recursos EnableDisplayName
é 1. Se a alternância de recursos não for 1, o nome de
exibição não será exibido.
Quando displayName no DB é nulo e a alternância de recursos
EnableDisplayName é
1, displayName será
firstName+" "+lastName para
caracteres não asiáticos e firstName+lastName para caracteres
asiáticos.
Alterações de esquema
GetUserResponse:
Controle de nível de usuário XMLAPI para Voip CMR híbrido
A configuração cmrHibridVoip é usada para definir e recuperar a configuração do nível do usuário para
EnableCMRVocdVoIP.
Alterações de esquema
Resposta GetUser:
Solicitação para Criarusuário:
Solicitação de SetUser:
Atualizações API 40.10.0
Atualizações XML API 40.10.0
Suporte à API XML para UUID de reunião
na solicitação e resposta da API
Api XML de exemplo: Informações do GetSession
Solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afetada:
-
CriaretingAttendee
-
DelMeetingAttendee
-
RegistraretingAttendee
-
CriarTeleconferênciaSession
-
SetTeleconferenceSession
-
GetTeleconferenceSession
-
Criar treinamentoSessão
-
Definir treinamentoSessão
-
Obter treinamentoSessão
-
DelTrainingSession
-
Createevent
-
Setevent
-
DelEvent
XMLAPI retornará um elemento extra para a configuração da Administração do Site para desativar a captura de tela
O requisito vem da Segurança - ambos os clientes e bugs penteste, como
Ltda Ltda. Eles não querem permitir que os usuários finais capturem a tela no aplicativo meetings. Enquanto isso, muitos outros clientes querem esse recurso - para permitir a captura de tela. Além disso, os usuários da Educação também querem permitir a captura de tela. Então, nós teremos uma configuração de administrador do site para isso, e o XMLAPI retornará um campo extra EnableMobileScreenCapture na resposta do GetSite para suportar
isso.
Amostra da solicitação 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">
<cabeçalho>
<securityContext>
<siteName>xxxx</siteName>
<webExID>Teste</webExID>
<password>xxxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite" />
</body>
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:ns1="http://www.webex.com/schemas/2002/06/service/site" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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>
API afetada
GetSite
Melhoria de entrada sem PIN do XMLAPI para suporte a MEET-269
XMLAPI adiciona uma NOVA OPÇÃO de sistemas de videoconferência na minha organização pode iniciar e entrar em reuniões sem avisos para reunião de Sala Pessoal e reunião MC.
-
createUser/setUser/getUser
adicione um novo nódeviceCanStartMyPMR
inpersonalMeetingRoom
. -
createMeeting/setMeeting/getMeeting
adicione um novo nódeviceCanStartMeeting
no agendamento.
A opção na IU Webex para reunião de Sala Pessoal:
Alterações de esquema
Createuser:
Setuser:
getUserResponse:
Criaretingtings:
definireting:,
getMeetingResponse:
Atualizações api 40.9.0
Atualizações XML API 40.9.0
Suporte à API XML para solicitação e resposta UUID da
reunião
Adicionamos o UUID da reunião à solicitação e resposta de API em qualquer lugar que suportamos como meetingKey
ou sessionKey.
Api XML de exemplo: Informações do GetSession
Solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afetada:
-
ObterInformações de inserção
-
LstsummaryTrainingSession
-
Adicionarteste agendado
-
Teste de agendados
-
Teste agendado
-
ObterTesteinformações
-
UploadEventImage
-
Enviar E-mail de convite
-
Criarsu suporteSessão
-
LstmeetingusagePreliminaryHistory
-
LstmeetingattendeePreliminaryHistory
-
LsteventsessionPreliminaryHistory
-
LsteventattendeePreliminaryHistory
-
LstTrainingPollResultsHistory
As reuniões Webex terão um lobby de reunião bloqueado onde os usuários podem esperar para serem admitidos na reunião
A API XML agenda e edita a reunião MC para suportar o lobby bloqueado quando o recurso(ConsistentLockedLoilo
) alternar.
Alterações de esquema
Adicionados três novos elementos(externalAttendeeSecurity,
autoLock ,
autoLockWaitTime ) nas
APIs CreateMeeting, SetMeeting e GetMeeting.
Elemento |
Descrição |
---|---|
|
Quando a reunião está desbloqueada, há três itens de Segurança de usuário externo podem ser escolhas.
|
|
Se está bloquear automaticamente a reunião. Verdadeiro : Bloquear automaticamente a reunião após # minutos após o início da reunião Falso : Não bloquear automaticamente a reunião após o início da reunião |
|
Minutos (0,5,10,15,20 ) para bloquear automaticamente areunião após o início da reunião |
Amostra de solicitação e resposta
Solicitação de Criação de umameeting:
...
...
false
AllowJoinWithLobby
verdadeiro
10
...
Solicitação de SetMeeting:
2###1###01
...
...
false
AllowJoinWithLobby
verdadeiro
10
...
Resposta de GetMeeting
:
<?xml version="1.0" encoding="ISO-8859-1"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common"
xmlns:meet="http://www.webex.com/schemas/2002/06/service/meeting" xmlns: att="http://www.webex.com/schemas/2002/06/service/attendee">
<serv:header>
<serv:response>
<serv:result>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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>verdadeiro</meet:autoLock>
<meet:autoLockWaitTime>10</meet:autoLockWaitTime>
</meet:attendeeOptions>
...
</serv:message>
API afetada:
-
CriaretingTinguação
-
Definireting
-
Obteretingsenças
Melhoria GetSessionInfo
API para retornar o status dos participantes na sessão em andamento
Adicionados dois novos elementos (hasHostInMeeting
, hasAttendeeInMeeting ) em
resposta a GetSessionInfo
. Estes dois elementos serão retornados quando a reunião for uma reunião em andamento.
Elemento |
Descrição |
---|---|
|
Se o anfitrião entrou na reunião em andamento. Verdadeiro : O anfitrião está na reunião em andamento. Falso/Nulo : O anfitrião não está na reunião em andamento ou a reunião não está em andamento. |
|
Se um participante/host entrou na reunião em andamento. Verdadeiro : há um participante ou um anfitrião na reunião em andamento. Falso/Nulo : não há nenhum participante ou host na reunião em andamento ou a reunião não está em andamento. |
Exemplo de resposta de 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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:getMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ep:status>INPROGRESSO</ep:status>
<ep:hasHostInMeeting>verdadeiro</ep:hasHostInMeeting>
<ep:hasAttendeeInMeeting>verdadeiro</ep:hasAttendeeInMeeting>
...
</serv:message>
API afetada:
ObterInformações da sesessão
O API GetUserCard requer autorização.
Aprimoramento de segurança, o XML API GetUserCard
requer autorização para obter informações do usuário.
API afetada:
GetUserCard
Atualizações api 40.8.0
Atualizações XML API 40.8.0
Aprimoramento da resposta
GetSessionInfo
Se você não for convidado ou aprovado da reunião, sua chamada para XML API: GetSessionInfo
não retornará os elementos: confName, startDate, duration, timeZone, meetingLink, sipURL, displayMeetingUrl
no corpo de resposta da API.
Exemplo de resposta de API para reuniões:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:sessionkey>1####2###4</ep:sessionkey>
<ep:accessControl>
<ep:listStatus>NÃO LISTADO</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>verdadeiro</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
Exemplo de resposta de API para treinamentos/eventos:
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:sessionkey>1####5###9</ep:sessionkey>
<ep:listStatus>NÃO LISTADO</ep:listStatus>
<ep:registration>true</ep:registration>
https://sitename.webex.com/tc3300/trainingcenter/register/registerSession.do?siteurl=sitename&confID=16###92######61</ep:registrationURL>
<ep:passwordReq>true</ep:passwordReq>
<ep:registrationURLForMobile>https://sitename.webex.com/tc3300/trainingcenter/meeting/sessionInfoMobile.do?siteurl=sitename&confID=16###92######61</ep:registrationURLForMobile>
<ep:joinStatus>CONVIDAR/REGISTRAR/REJECT</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>verdadeiro</ep:isCETMeeting>
<ep:isPersonalMeetingRoom>false</ep:isPersonalMeetingRoom>
API afetada:
-
ObterInformações da sesessão
GetSessionInfo, GetUserCard
Aprimoramentos de segurança
Fizemos um aprimoramento de segurança no XML API GetSessionInfo
e GetUserCard
. Bloquearemos os usuários de acessarem estas duas APIs nas próximas duas horas se a chamada deles atingir o limite em uma hora sem erros encontrados de dados.
A resposta de status de erro é: "403 Proibido"
APIs afetadas:-
ObterInformações da sesessão
-
GetUserCard
meetingUUID
no suporte de solicitação e resposta da API
Adicionamos meetingUID à solicitação e resposta de API em qualquer lugar que suportamos um meetingKey/sessionKey.
Informações do GetSession
Solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
API afetada:
-
LstOpenSession
-
ObterInformações de inserção
-
LstsummaryMeeting
-
Testes LstScheduled
-
Getevent
-
LstsummaryEvent
-
LstmeetingusageHistory
-
LsttrainingsessionHistory
-
Histórico de sesessão Lsteventsession
-
LstsupportsessionHistory
-
Sesessão Del
Modelo de sites de educação (tipo de sessão EDU) no suporte a XML API
Quando seus sites habilitam o tipo de sessão Instrutor de Educação (EDU), a API XML pode suportar o agendamento de uma reunião com o modelo de reunião EDU.
API afetada:
-
CriaretingTinguação
-
Definireting
-
Createevent
-
Setevent
-
Criar treinamentoSessão
-
Definir treinamentoSessão
API do XML CreateMeetingAttendee
e RegisterMeetingAttendee
Tanto o CreateMeetingAttendee quanto o
RegisterMeetingAttendee podem verificar o formulário de registro do participante necessário para
um registro do Webex Meetings.
E há uma nova exceção para esta tarefa:
Número de exceção |
Mensagem de Exceção |
---|---|
040014 |
Campos obrigatórios ausentes (formulário de registro): ... |
Por exemplo, se você selecionou "Cargo" e "Nome da Empresa" como campos de exigir para um participante do registro do Webex Meetings, como mostrado abaixo, você deverá fornecer valor nos "Cargo" e "Nome da Empresa" ao ligar para as duas APIs: Crie o convidado
e Registre-se convidado do Meeting
.
Solicitação do convidado do
RegisterMeetingAttendee:
FirstNameb LastName
FirstNameb
LastName
Engenheiro //Cargo
Cisco1234 //Nome da empresa
...
****@*****. com
VISITANTE
true
CONVIDADO
ACEITAR
true
1####4####1
CriarMeetingAttendee
Solicitação:
FirstNameA LastNameA
FirstNameA
LastNameA
Engenheiro //Cargo
Cisco1234 //Nome da empresa
...
*****@*****. com
VISITANTE
true
CONVIDADO
ACEITAR
true
1###4####1
040014 Exceção da resposta
Exemplo:
<?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">
Campos obrigatórios ausentes (formulário de registro): título,empresa
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>040014</serv:exceptionID>
<serv:value>title,company</serv:value>
<serv:bodyContent/>
<serv:body>
</serv:message>
API afetada:
-
CriaretingAttendee
-
RegistraretingAttendee
Aprimoramentos de validação de e-mail XML API
API XML não deve permitir caractere(s) em espaço branco em um e-mail, então aprimoramos a validação de e-mail para alinhar com o comportamento da página Webex Meetings.
API afetada:
-
CriaretingAttendee
-
Createevent
-
Setevent
-
Criar contato
-
SetContact
-
Informações de gravação de setrecording
-
CriaretingAttendee
-
Criar treinamentoSessão
-
Definir treinamentoSessão
-
Createuser
-
Setuser
-
CriaretingTinguação
-
Definireting
-
RegistraretingAttendee
Atualizações api 40.7.0
Atualizações xml API 40.7.0
meetingUUID
support
Adicionamos meetingUID à solicitação e resposta de API em qualquer lugar que suportamos
um meetingKey ou sessionKey.
Informações do GetSession
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
Informações do GetSession
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
GetSessionInfo
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
APIs afetadas:
-
LstmeetingattendeeHistory
-
LsttrainingattendeeHistory
-
Histórico de eventos de Lsteventattendee
-
LstsupportattendeeHistory
CriateUser
Suporte de e-mail de boas-vindas à API para quatro novos idiomas
O e-mail de html de boas-vindas XMLAPI suporta os seguintes quatro novos idiomas:
-
Tcheco (languageID=19)
-
Polonês (languageID=20)
-
Húngaro (languageID=21)
-
Riso (languageID=22)
O XMLAPI envia o e-mail de boas-vindas de acordo com o idioma ou idiomaID na solicitação
CreateUser.
Usando CreateUser
para enviar Exemplo de e-mail de boas-vindas Html (Tcheco):
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<firstName>teste</firstName>
<lastName>usuário</lastName>
<webExId>testuser</webExId>
<password>xxxxxx</password>
<email>testuser@test.com</email>
<privilégio>
<host>verdadeiro</host>
</privilégio>
<languageID>19</languageID>
ou
<language>Tcheco</language>
<active>ATIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>verdadeiro</isHTMLEmail>
</bodyContent>
</bodyContent>
</body>
Atualizações API 40.6.1, 40.4.9
Atualizações XML API 40.6.1, 40.4.9
Suporte ao CreateMeeting/SetMeeting
Ao agendar uma reunião Webex, a API XML CreateMeeting/SetMeeting permite que você marque ou desmarque ou clique em um campo obrigatório ou não obrigatório no formulário de registro do
participante.
O exemplo a seguir mostra o Agendamento de reuniões na página da web do usuário, onde você pode verificar os campos necessários, como "Cargo", "Nome da empresa", "Cidade" e "Estado" no formulário de registro do participante:
O seguinte é um mapeamento entre os campos da página e os elementos da XML API:
Campos da página | Elemento XMLAPI |
---|---|
Cargo | |
Nome da empresa | |
Endereço 1 | |
Endereço 2 | |
Cidade | |
Estado | |
Código postal/CEP | |
País/região | |
Telefone de trabalho | |
Fax |
Esquema alterado: Adicionar elemento "RegistrationForm" em Criar reunião
Esquema alterado: Adicionar elemento "RegistrationForm" em SetMeeting
Esquema alterado: Adicionar elemento "RegistrationForm" em GetMeeting
Criar reunião
Exemplo de solicitação:
senha
true
verdadeiro
falso
true
true
false
false
true
true
false
false
false
false
SetMeeting
Exemplo de solicitação:
1015045339
Nome da conferência
3
true
verdadeiro
verdadeiro
true
true
false
false
true
true
false
false
false
false
GetMeeting
Exemplo de resposta:
<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>
APIs afetadas:
-
CriaretingTinguação
-
Definireting
-
Obteretingsenças
-
DelMeeting
O tipo de reunião E2EE não suporta uma reunião PMR
Quando você ativa uma PMR durante uma chamada com as APIs: CreateUser/SetUser/GetUser/GetMe
e somente um tipo de reunião E2EE está disponível, ele responderá a seguinte mensagem de erro: "110063 O usuário deve ter pelo menos um tipo de reunião que não seja E2EE para habilitar o PMR".
APIs afetadas:
-
Createuser
-
Setuser
-
Getuser
-
GetMe
Atualizações api 40.6.0
Atualizações XML API 40.6.0
Função de Gerenciamento de usuários adicionada
Criamos a função de Gerenciamento de usuários e o arquivo de esquema para o que segue mudou.
Esquema alterado: CriateUser
solicitação:
Esquema alterado: Setuser
Esquema alterado: GetMe
resposta:
Esquema alterado: Resposta do
Usuário LstsummaryUser:
APIs afetadas:
-
Createuser
-
Setuser
-
GetMe
-
LstsummaryUser
CriateUser
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>SiteAdmin</webExID>
<password>xxxx</password>
</securityContext>
</cabeçalho>
<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>
<privilégio>
<umSiteAdmin>verdadeiro</umSiteAdmin>
<host>falso</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilégio>
<languageID>3</languageID>
<active>ATIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>verdadeiro</isHTMLEmail>
</bodyContent>
</body>
Suporte usando a chave de API para acessar o GetUserCard
Agora suportamos o uso da chave API (token JWT gerado) que acessa a API: GetUserCard
nesta versão.
Você pode consultar essas páginas sobre a aplicação de uma chave API e gerar um token JWT:
GetUserCard
Exemplo de solicitação:
PUBLICAR https://{sitename}.webex.com/WBXService/XMLService
Cabeçalho:
Aplicativo do tipo de conteúdo/json;charset=utf-8
JWTToken ${jwttoken}
Corpo:
<?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">
<cabeçalho>
<securityContext>
<siteName>{sitename}</siteName>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUserCard">
<webExId>{userName}</webExId>
</bodyContent>
</body>
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:getUserCardResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:url>https://xxxx.webex.com/svc3300/svccomponents/html/img/avatar160.png</use:url>
<use:lastModifiedTime>1587493389768</use:lastModifiedTime>
<use:isUploaded>false</use:isUploaded>
</use:avatar>
<use:title>Sala Pessoal do teste</use:title>
<use:personalMeetingRoomURL>https://xxxx.webex.com/meet/Test</use:personalMeetingRoomURL>
<use:accessCode>713289692</use:accessCode>
</use:personalMeetingRoom>
</serv:bodyContent>
Suporte para meetingUUID
na solicitação e resposta API
Adicionamos meetingUID à solicitação e resposta
de API quando suportamos uma meetingKey ou sessionKey.
APIs afetadas:
-
LstRecording
-
LstsummarySession
-
ObterInformações da ssession
-
ObterhosturlMeeting
-
GetjoinurlMeeting
-
LstMeetingAttendee
-
CriaretingTinguação
-
Definireting
-
Obteretingsenças
-
DelMeeting
-
LstCalendarSession
meetingUUID
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>805325231</sessionKey>
ou
<meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</meetingUUID>
</bodyContent>
</body>
meetingUUID
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ep:getSessionInfoResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:isLocked>false</ep:isLocked>
<ep:sessionkey>805325231</ep:sessionkey>
<ep:meetingUUID>039c00dd25c64ab0812dda22bb8a4fcc</ep:meetingUUID>
<ep:confID>158941507534980823</ep:confID>
...
...
</serv:bodyContent>
As chaves de reunião PMR não serão alteradas de um usuário temporariamente desativado ou PMR desativado
Quando um usuário temporário desativado ou desativado pmr é reativado dentro de uma semana, agora o usuário reativado ou habilitada a chave de reunião do PMR não é alterada, ela será a mesma que antes.
APIs afetadas:
-
Setuser
-
DelUser
LstSummarySession
aprimoramentos
Aprimoramos a API: LstSummarySession
retornar agendado-PMR para ter um novo elemento, returnScheduledPMR
, na solicitação. E a alternância de recursos padrão está desligada.
APIs afetadas:
-
LstSummarySession
Alteração de esquema:
Adicionamos um novo nome de elemento ReturnScheduledPMR na
solicitação DE API LstSummarySession.
Adicionamos um novo nome de elemento isScheduledPMR na resposta
api LstSummarySession.
LstSummarySession
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
<partnerID>xxxx</partnerID>
<clientInfo>xxxx</clientInfo>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<listControl>
<startFrom>1</startFrom>
<maximumNum>2</maximumNum>
<listMethod>E</listMethod>
</listControl>
<dateScope>
<startDateStart>01/11/2019 8:0:0</startDateStart>
<startDateEnd>01/12/2019 7:59:59</startDateEnd>
<timeZoneID>4</timeZoneID>
<endDateStart>01/11/2019 8:0:0</endDateStart>
<endDateEnd>01/12/2019 7:59:59</endDateEnd>
</dateScope>
<orderBy>HOSTWEBEXID</orderBy>
<orderAD>ASC</orderAD>
<orderBy>CONFNAME</orderBy>
<orderAD>ASC</orderAD>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
<serviceTypes>
<serviceType>EventCenter</serviceType>
<serviceType>MeetingCenter</serviceType>
<serviceType>SalesCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>SupportCenter</serviceType>
</serviceTypes>
<returnScheduledPMR>true</returnScheduledPMR>
</bodyContent>
</body>
LstSummarySession
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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>Reunião da equipe</ep:confName>
<ep:sessionType>3</ep:sessionType>
<ep:serviceType>MeetingCenter</ep:serviceType>
<ep:hostWebExID>Teste</ep:hostWebExID>
<ep:hostFirstName>Teste</ep:hostFirstName>
<ep:hostLastName>Testar</ep:hostLastName>
<ep:otherHostWebExID>Teste</ep:otherHostWebExID>
<ep:timeZoneID>2</ep:timeZoneID>
<ep:timeZone>GMT-10:00, Havaí (Honolulu)</ep:timeZone>
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PÚBLICO</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:isTCSingleReurrence>false</ep:isTCSingleReurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>verdadeiro</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:sessão>
<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, Havaí (Honolulu)</ep:timeZone>
<ep:status>NÃO_INPROGRESSO</ep:status>
<ep:startTime>12/10/2019 00:35:41</ep:startTime>
<ep:duration>60</ep:duration>
<ep:listStatus>PÚBLICO</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:isTCSingleReurrence>false</ep:isTCSingleReurrence>
<ep:isAllowJBH>false</ep:isAllowJBH>
<ep:isCETMeeting>verdadeiro</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:sessão>
</serv:bodyContent>
Aprimoramentos do GetSite
Adicionamos uma alternância do recurso de resposta GetSite
de SupportXMLAPIReturnScheduledPMR
APIs afetadas:
-
GetSite
Alteração de esquema:
O novo elemento de resposta do XML API GetSite
é: SupportXMLAPIRescheduledPMR
GetSite
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>xxx</siteName>
<webExID>Teste</webExID>
<password>xxx</password>
<clientInfo>xxx</clientInfo>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.site.GetSite">
</bodyContent>
</body>
GetSite
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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>
Atualizações API 40.4.8, 40.2.9
Atualizações XML API 40.4.8, 40.2.9
Nova resposta ao atualizar as reuniões agendadas em XMLAPI
Quando os clientes usam XMLAPI para atualizar as reuniões agendadas através da página, enviaremos a senha numérica em uma atualização de e-mail da reunião e a aplicaremos aos centros Webex Meetings, Teams e Events.
Essas APIs: GetMeeting, GetTrainingSession, GetEvent
e GetTeleconferenceSession
, terá esses novos elementos como resposta: audioPassword
(senha numérica), isEnforceAudioPassword
, isEnforceAudioLogin
para Webex Meetings, Teams e Events centers.
Esquema alterado:
APIs afetadas:
-
Obteretingsenças
-
Obter treinamentoSessão
-
Getevent
-
GetTeleconferenceSession
GetMeeting
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>testSite</siteName>
<webExID>teste</webExID>
<password>xxx</password>
<partnerID>xx</partnerID>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.GetMeeting">
<meetingKey>803328224</meetingKey>
</bodyContent>
</body>
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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>
Atualizações API 40.4.5, 40.2.6
Atualizações XML API 40.4.5, 40.2.6
GetUserCard
e GetSessionInfo
limite de uso
Implementamos o limite de uso em API GetUserCard
e GetSessionInfo
, você pode receber a mensagem de erro: "403 proibido" se atingir o limite de uso.
APIs afetadas:
-
GetUserCard
-
ObterInformações da sesessão
Atualizações API 40.4.4, 40.2.5
Atualizações XML API 40.4.4, 40.2.5
Limite de números BodyContent
Adicionamos um número limitado de BodyContent em
cada seção API XML. Quando você adiciona muitos BodyContent
na solicitação de API, o seguinte código de erro e mensagem retornarão: "000053 A contagem de BodyContent em uma solicitação deve ser inferior a {number}"
APIs afetadas:
-
Qualquer API XML
Solicitação de API XML com vários Conteúdo do corpo
Exemplo:
<?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">
<cabeçalho>
<securityContext>
<webExID>xxxx</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</cabeçalho>
<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>
Atualizações API 40.4.3, 40.2.4
Atualizações XML API 40.4.3, 40.2.4
CriarUsuário
aprimoramentos
Aprimoramos CreateUser para
suportar o e-mail de boas-vindas em vários idiomas. O CreateUser
agora solicita isHTMLEmail
APIs afetadas:
-
Createuser
CriateUser
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<webExID>administrador</webExID>
<password>xxxx</password>
<siteName>xxx</siteName>
</securityContext>
</cabeçalho>
<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>
<privilégio>
<host>verdadeiro</host>
<siteAdmin>false</siteAdmin>
<labAdmin>false</labAdmin>
<voiceOverIp>false</voiceOverIp>
</privilégio>
<languageID>3</languageID>
<active>ATIVADO</active>
<sendWelcome>true</sendWelcome>
<isHTMLEmail>verdadeiro</isHTMLEmail>
</bodyContent>
</body>
Atualizações api 40.4.0
Atualizações XML API 40.4.0
Aplicar verificação de e-mail ao alterar e-mails na API XML
Depois que um administrador do site habilitar a Confirmação necessária para o usuário atualizar o endereço de e-mail na administração do site Webex:
-
Se uma conta de administrador não-site ligar para a API SetUser para alterar endereços de e-mail, o e-mail atual permanece até que o
novo e-mail seja verificado. O e-mail de confirmação de alteração da conta é enviado para o novo endereço de e-mail com a "Confirmação de alteração de conta Webex". Depois de clicar no link no e-mail para confirmar, o novo endereço de e-mail é imediatamente vinculado.
Se um administrador que não site ligar para a API SetUser várias vezes sem terminar o processo de verificação de e-mail, o e-mail atual será mantido, e o novo e-mail mais recente será aquele que deverá
ser verificado.
-
Se uma conta de administrador do site ligar para a API SetUser para alterar os endereços de e-mail, o processo de verificação de e-mail
não será acionado. O novo e-mail será imediatamente vinculado à conta do host ou do participante.
APIs afetadas:
-
Setuser
GetEnrollmentInfo
tempo limite e redefinição de conexão
A API GetEnrollmentInfo atualmente pesquisa endereços IP no sistema de Nome do Domínio, o que aciona enormes impactos de desempenho. Planejamos simplificar esse processo, com uma resposta vazia no
campo.
APIs afetadas:
-
ObterInformações de inserção
GetEnrollmentInfo
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>xxx</webExID>
<password>xxxx</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</cabeçalho>
<body>
<bodyContent
xsi:type="java:com.webex.service.binding.attendee.GetEnrollmentInfo">
<sessionKey>716773566</sessionKey>
</bodyContent>
GetEnrollmentInfo
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</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:convidado>
<att:attendeeID>3191792</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>Alex</att:firstName>
<att:lastName>Yang</att:lastName>
<att:email>omega.alex.yang@gmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.35.240.53</att:ipAddress>
<att:submitTime>27/02/2020 22:03:57</att:submitTime>
<att:status>APROVADO</att:status>
</att:convidado>
<att:convidado>
<att:attendeeID>3191797</att:attendeeID>
<att:enrollFields>
<att:defaultFields>
<att:firstName>AlexKKK</att:firstName>
<att:lastName>Teste</att:lastName>
<att:email>achillesyang@hotmail.com</att:email>
<att:company></att:company>
<att:phoneNum></att:phoneNum>
<att:title></att:title>
<att:receiveInfo>false</att:receiveInfo>
<att:address1></att:address1>
<att:address2></att:address2>
<att:city></att:city>
<att:state></att:state>
<att:zipcode></att:zipcode>
<att:country></att:country>
<att:leadSourceID></att:leadSourceID>
<att:leadScore>0.0</att:leadScore>
</att:defaultFields>
<att:customFields/>
</att:enrollFields>
<att:domain> </att:domain>
<att:ipAddress>10.154.181.15</att:ipAddress>
<att:submitTime>27/02/2020 22:07:38</att:submitTime>
<att:status>APROVADO</att:status>
</att:convidado>
<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>
Atualizações api 40.2.0
Atualizações xml API 40.2.0
Remover acesso anônimo à LstSummarySession
Como um aprimoramento de segurança, estamos parando o suporte ao acesso anônimo à API LstSummarySession.
Se o Webex Meetings acessa anonimamente a API, o seguinte código de erro e mensagem são retornados: "000015 Desculpe, nenhum registro encontrado".
APIs afetadas:
-
LstSummarySession
LstSummarySession
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>sitename1</siteName>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.LstsummarySession">
<sessionKey>211894651</sessionKey>
</bodyContent>
</body>
LstSummarySession
Exemplo de resposta:
<?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>FALHA</serv:result>
<serv:reason>Desculpe, nenhum registro encontrado</serv:reason>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
<serv:exceptionID>000015</serv:exceptionID>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
Melhorias de segurança
e SetMeeting
Essa alteração foi feita no XML API 40.2.0, mas sua descrição foi editada após receber comentários do cliente.
Como um aprimoramento de segurança, atualizamos as
APIs CreateMeeting e SetMeeting para não permitir que os usuários agendem uma hora de início de reunião
que já tenha passado. Se eles tentarem, a API solicitará a mensagem de erro: "060016 A hora de início da sessão deve ser posterior à hora atual". Se um usuário precisar agendar uma reunião instantânea, recomendamos que a hora de início da reunião seja configurada cinco minutos mais tarde que a hora atual.
APIs afetadas:
-
CriaretingTinguação
-
Definireting
Atualizações api 40.1.2
Atualizações XML API 40.1.2
Agendar uma reunião gera automaticamente uma senha se uma não for fornecida
Aprimoramos o CreateMeeting,
CreateEvent,
CreateTrainingSession
e CreateTeleconferenceSession
para incluir uma senha no corpo da resposta da API.
Por padrão, todas as reuniões/eventos/sessão devem ter uma configuração de senha habilitada. Nesse cenário, se a solicitação de API não inclui uma senha, uma senha é gerada automaticamente dos servidores API XML.
Se Todas as reuniões/eventos/sessão devem ter uma configuração de senha desativada e a solicitação de API não inclui uma senha, uma senha não é gerada a partir dos servidores API XML.
Se a solicitação de API incluir uma senha, então a resposta irá incluir essa senha, independentemente de Todas as reuniões/eventos/sessão ter uma configuração de senha sendo ativada ou desativada.
APIs afetadas:
-
CriaretingTinguação
-
Createevent
-
Criar treinamentoSessão
-
CriarTeleconferênciaSession
A resposta CreateMeeting
agora tem o elemento meetingPassword:
Criar reunião
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>siteName1</siteName>
<webExID>userID</webExID>
<password>*****</password>
<partnerID>webexpartner</partnerID>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.meeting.CreateMeeting">
<metaData>
<confName>Test_Auto_Generated_mtg_pwd</confName>
<meetingType>3</meetingType>
</metaData>
<startDate>28/10/2020 17:35:00</startDate>
</bodyContent>
</body>
Criar reunião
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="meet:createMeetingResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<meet:meetingkey>806745263</meet:meetingkey>
<meet:meetingPassword>UzXJuzUD428</meet:meetingPassword>
<meet:iCalendarURL>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=md225d5935256319ef21b71dd8ebd0640</serv:host>
https://hmwds6.qa.webex.com/hmwds6/j.php?MTID=m26bf5e25ca587d32302fb29951b92e15</serv:attendee>
</meet:iCalendarURL>
<meet:guestToken>cfc7f3246d4862f1bb69b803e8615b7a</meet:guestToken>
</serv:bodyContent>
A resposta CreateEvent
agora tem o elemento eventPassword:
As respostas de CreateTrainingSession e
CreateTeleconferenceSession agora
possuem o elemento sessionPassword:
Atualizações api 40.1.0
Atualizações XML API 40.1.0
Melhorias GetSessionInfo
Adicionamos novos elementos à API GetSessionInfo.
A API agora retorna informações para dispositivos móveis também.
APIs afetadas:
-
ObterInformações da sesessão
Informações do GetSession
Solicitar atualizações:
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>sqdemo11</siteName>
<webExID>administrador do site</webExID>
<password>P@ss1234</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.ep.GetSessionInfo">
<sessionKey>713707633</sessionKey>
https://go.webex.com/join/dongchen</pmrUrl>
<sipUrl>dongchen@go.webex.com ou 123456789_go@webex.com ou 123456789@go.webex.com</sipUrl>
https://go.webex.com/go/j.php?MTID=m814c6a483d4b5052d539f88d67acbad6</meetingLink>
<meetingUuid>34567323456787654323456787654</meetingUuid>
</bodyContent>
</body>
LstAccessAnywhereHistory
aprimoramentos
Adicionamos uma nova API, lstAccessAnywhereHistory , para responder com as informações
de relatório do Webex Access Anywhere.
APIs afetadas:
-
LstAccessAnywhereHistory
LstAccessAnywhereHistory
Solicitar atualizações:
LstAccessAnywhereHistory
Atualizações de resposta:
Exemplo de solicitação:
<?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">
<cabeçalho>
<securityContext>
<siteName>sqdemo6</siteName>
<webExID>teste</webExID>
<password>P@ss1234</password>
</securityContext>
</cabeçalho>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstAccessAnywhereHistory">
<hostWebexID>test1</hostWebexID>
<startTimeScope>
<sessionStartTimeStart>29/09/2019 00:42:34</sessionStartTimeStart>
<sessionStartTimeEnd>29/12/2019 04:42:34</sessionStartTimeEnd>
</startTimeScope>
<endTimeScope>
<sessionEndTimeStart>29/09/2019 02:42:34</sessionEndTimeStart>
<sessionEndTimeEnd>29/12/2019 05:42:34</sessionEndTimeEnd>
</endTimeScope>
<listControl>
<serv:startFrom>1</serv:startFrom>
<serv:maximumNum>10</serv:maximumNum>
<serv:listMethod>OU</serv:listMethod>
</listControl>
<orderBy>STARTTIME</orderBy>
<orderAD>ASC</orderAD>
</bodyContent>
</body>
Exemplo de resposta:
<?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>SUCESSO</serv:result>
<serv:gsbStatus>PRIMÁRIO</serv:gsbStatus>
</serv:resposta>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:LstAccessAnywhere HistoryResponse"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:matchingRecords>
<serv:total>775</serv:total>
<serv:returned>10</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
<history:accessAnyWhereInfo>
<history:confID>123456</history:confID>
<history:userName>dean</history:userName>
<history:computerName>6926_dean</history:computerName>
<history:clientIP>10.224.222.183</history:clientIP>
<history:startTime>29/11/2019 03:05:44</history:startTime>
<history:endTime>29/11/2019 03:10:06</history:endTime>
<history:duration>5</history:duration>
</history:accessAnyWhereInfo>
</serv:bodyContent>