- Página inicial
- /
- Artigo
Encontre todas as informações importantes de que você precisa sobre a API do Cisco Webex Meetings, como alterações de esquema e outros anúncios.
Para obter mais informações sobre a API XML 39 e API XML 11, consulte a Visão geral das atualizações da API XML do Cisco Webex Meetings (API XML 39 e anterior).
Para obter mais informações sobre a API XML 40, consulte a Visão geral das atualizações da API XML do Cisco Webex Meetings (API XML 40 e posterior).
Para obter atualizações da API XML 11 SP9 e anteriores, acesse Cisco DevNet.
Atualizações da API 41.12.0
Atualizações da API XML 41.12.0
O XMLAPI bloqueará a programação e edição do Webex Events (Clássico) de acordo com o item de configuração do site de EnableClassicEvent
que é falso
APIs impactadas e alterações de esquema
Na página de configuração da administração do site, se a caixa de seleção Ativar evento clássico for falsa, este site não oferecerá mais suporte a reuniões do Webex Events (clássico).
Se a caixa de seleção Ativar classicEvent for falsa, ligue para essas APIs para operar a reunião do Webex Events (clássico):
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
A API responderá a uma nova exceção 010106 O Evento clássico foi desativado .
Alterações do esquema
Nenhum esquema muda.
Exemplo de solicitação e resposta de API
Criando evento Solicitação e resposta de API
Solicitação de CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>Teste EC XMLAPI</sessionName>
</metaData>
<schedule>
<startDate>17/07/2021 01:29:15</startDate>
<openTime>15</openTime>
</schedule>
</bodyContent>
Resposta do evento criado
<?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:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>FALHA </serv:result>
<serv:reason> O Evento clássico foi desativado.</serv:reason>
<serv:gsbStatus>PRIMÁRIO <UNK> </serv:gsbStatus> <UNK>
<serv:exceptionID> <UNK> 010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
APIs de efeitos do CreateEvent3.1.3:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
responderá ao novo elemento de subProductCodePrefix
APIs impactadas
Atual a API LstMeetingType
elemento de resposta de productionCodePrefix
: PRO, AUO e outros que são prefixo de tipo de reunião predefinido do Webex.
Após esse novo aprimoramento, a API responderá a um novo elemento de subProdctCodePrefix
:PRO1, PRO2, etc., que podem ser personalizados atender prefixo tipo.
Alterações de esquema na API: LstMeetingType
Ele responderá a um novo elemento: subProdctCodePrefix
Exemplo de solicitação e resposta de API
LstMeetingType
Solicitação e resposta de API
Solicitação de LstMeetingType
<bodyContent xsi:type="java:com.webex.service.binding.meetingtype.LstMeetingType">
<meetingTypeID>13810</meetingTypeID>
</bodyContent>
Resposta de LstMeetingType
<serv:body>
<serv:bodyContent xsi:type="mtgtype:lstMeetingTypeResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<mtgtype:matchingRecords>
<serv:total>1</serv:total>
<serv:returned>1</serv:returned>
<serv:startFrom>1</serv:startFrom>
</mtgtype:matchingRecords>
<mtgtype:meetingType>
<mtgtype:productCodePrefix>PRO</mtgtype:productCodePrefix>
<mtgtype:subProductCodePrefix>PRO3</mtgtype:subProductCodePrefix> //Novo elemento para o tipo de reunião personalizado
<mtgtype:active>ATIVADO</mtgtype:active>
<mtgtype:name>Cus_Chat_Fechado</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Fechado</mtgtype:displayName>
Atualizações da API 41.11.0
Atualizações da API XML 41.11.0
A API XML oferece suporte à compatibilidade de encaminhamento na API de gerenciamento de usuários para sites gerenciados pelo Control Hub
APIs impactadas e alterações de esquema
Se o aplicativo de integração estiver usando APIs de gerenciamento de usuários Webex XMLAPI: CreateUser
, SetUser
, DelUser
, e GetUser
para provisionar ou gerenciar usuários, depois que seu site clássico Webex convertido no site gerenciado pelo Control Hub, essas APIs continuarão a funcionar para compatibilidade avançada. Existem algumas alterações de comportamento, conforme observado abaixo:
Ao usar createUser - se o status do usuário no Control Hub não estiver "ativo", o status do usuário no site não estará ativo. Se o status do usuário no Control Hub estiver active , o status do usuário no site também estará ativo, consulte: Status do usuário de usuários novos e convertidos no Control Hub .
O password elemento de CreateUser e SetUser APIs será ignorado, começamos a enviar e-mail de ativação para novos usuários, os usuários podem clicar no link no e-mail para nova conta ativa e inserir nova senha.
O active element of CreateUser API será ignorado, novo usuário (não verificado) não poderá ser ativado através deste parâmetro usando a API SetUser ...
O valor de webExId elemento no corpo Conteúdo das APIs CreateUser deve ser o mesmo que o e-mail. Se webExId é diferente de email , nós vamos tratar o webExId o mesmo que o e-mail ao armazená-lo no WebDB e o valor será ignorado.
O valor de webExId elemento no corpo Conteúdo de SetUser APIs deve ser a identidade do usuário do endereço de e-mail, você pode alterá-lo usando < email > em Conteúdo do corpo.
A API SetUser oferecerá suporte à alteração do e-mail do usuário existente: será bem-sucedido se a conta de operação no SecurityContext for o administrador completo do site do Control Hub. Caso contrário, a API relata um erro com o novo código de erro e a mensagem abaixo:
030120 A conta deve ser um administrador completo do site para alterar o e-mail.
O elemento newWebExId no corpo Conteúdo da API SetUser será ignorado.
A API SetUser tenta alterar para um e-mail que já está em uso, a API levanta abaixo o novo código de erro e a mensagem de erro:
030118 O e-mail já é usado em sites gerenciados pelo Control Hub.
A API DelUser desativa o usuário no lado da reunião Webex e a licença de reunião correspondente é removida do site Webex. Este usuário desativado pode ser reativado usando a API: SetUser (<active> ATIVADO </active>), desde que o usuário seja verificado antes.
As APIs CreateUser e SetUser levanta novo código de erro e mensagem de erro, conforme mostrado abaixo:
030117 , este usuário existe fora da sua organização, portanto, precisa ser reivindicado, para se mover para sua organização através do processo de reivindicação de usuário. Para saber as etapas sobre como reivindicar o usuário em sua organização, consulte Reivindicar usuários para sua organização (Converter usuários). Você precisará verificar o domínio ao qual o usuário pertence antes de reivindicar o usuário.
030119 O token de acesso do CI deve incluir o escopo webexsquare: administrador ao provisionar usuário.
Somente por um período limitado, a compatibilidade de encaminhamento é suportada. Forneceremos um aviso prévio antes de essa compatibilidade ser removida. |
Alterações do esquema
Nenhuma alteração de esquema nessas APIs: CreateUser
, SetUser
, DelUser
, e GetUser
.
Exemplo de solicitação e resposta de API
CriateUser Solicitação de API e resposta
Solicitação de 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"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{site Admin account}</webExID>
<email>{site Admin account}</email>
<sessionTicket>xxxx</sessionTicket> ou <password> ou <webExAccessToken>
ou <accessToken>, ao usar o CI "accessToken", ele deve incluir o escopo webexsquare:admin ao provisionar o usuário
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- deveria ser a identidade do usuário do endereço de e-mail
<email>Jack@qa.webex.com</email>
<firstName>Jack.</firstName>
<lastName>Smith.</lastName>
<password>...</password>
<privilege>
<host>verdadeiro</host>
</privilege>
<active>ATIVADO</active> ---esse parâmetro não poderá ativar o usuário diretamente até que o usuário se ative por e-mail de ativação.
</bodyContent>
</body>
Exemplo de resposta da API:
<?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>ÊXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:createUserResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:userId>23778617</use:userId>
</serv:bodyContent>
</serv:body>
</serv:message>
APIs de efeito:
Criar usuário
SetUser
DelUser
A API XML suporta a compatibilidade de encaminhamento de autenticação do usuário existente depois que o site clássico Webex é convertido para o site gerenciado pelo Control Hub
APIs impactadas
Depois que o site clássico Webex é convertido para o site gerenciado pelo Control Hub, o valor do <webExID> elemento <securityContext> precisa ser igual ao e-mail, detalhes abaixo:
Para usuários existentes criados no site Webex clássico, oferecemos suporte para os dois antigos webExID (Por exemplo: Jack) e novo webExID (o conteúdo é o mesmo que e-mail, exemplo: Jack@xx.com) para efetuar logon, esta compatibilidade retroativa de autenticação é para todas as APIs XML.
Para novos usuários criados em sites gerenciados pelo Control Hub, o valor do elemento webExID deve ser igual ao e-mail para logon.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- usuários existentes foram criados no site clássico webEx, pode ser: jack ou jack@xx.com; novo usuário deve usar jack@xx.com
<sessionTicket> xxxx </sessionTicket> ou <password> ou <webExAccessToken> ou <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
APIs de efeito:
Todas as APIs XML.
Depois que o site clássico Webex convertido em um site gerenciado pelo Control Hub, o valor do <webExID> elemento < bodyContent > precisa ser igual ao e-mail, detalhes abaixo:
Para usuários existentes criados no site Webex clássico, oferecemos suporte para os dois antigos webExId (por exemplo: Jack) e novo webExId (o conteúdo é o mesmo que o e-mail, por exemplo: Jack@xx.com) em bodyContent .
Para novos usuários criados em sites gerenciados pelo Control Hub, o valor de webExId o elemento deve ser igual ao e-mail em
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx </webExId> --- usuários existentes foram criados no site clássico do webEx, pode ser: jack ou jack@xx.com; o novo usuário deve usar jack@xx.com
</bodyContent>
APIs de efeito:GetUser
, SetUser
, e DelUser
.
Alterações do esquema
Nenhum esquema de alterações em APIs.
Exemplo de solicitação e resposta de API
GetUser Solicitação e resposta da API
Solicitação de 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"
xsi:schemaLocation="http://www.webex.com/schemas/2002/06/servicehttp://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- usuários existentes foram criados no site clássico do webEx, pode ser: jack ou jack@xx.com; o novo usuário deve usar jack@xx.com
<sessionTicket>xxxx</sessionTicket> ou <password> ou <webExAccessToken> ou <accessToken>
</accessToken></webExAccessToken></password></securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- usuários existentes foram criados no site clássico do webEx, pode ser: jack ou jack@xx.com; o novo usuário deve usar jack@xx.com
</bodyContent>
</body>
Exemplo de resposta da API:
O mesmo de antes.
API do relatório do histórico de visualização de gravação aprimorada para oferecer suporte ao Webex Meetings, Webex Events (novo) e Webex Events (clássico)
APIs impactadas
API atual: lstrecordaccessHistory
e lstrecordaccessDetailHistory
suporta apenas o relatório do histórico acessado da exibição de gravações do Webex Trainings. O novo aprimoramento também suporta Webex Meetings, Webex Events (novo) e Webex Events (clássico) exibição de gravação acessou relatório de histórico.
Alterações do esquema
Suportamos abaixo o novo esquema no corpo da solicitação API lstrecordaccessHistory no corpo da solicitação API:
<serviceTypes>
<serviceType>MeetingCenter </serviceType>
<serviceType> TrainingCenter </serviceType>
<serviceType> EventCenter</serviceType>
</serviceTypes>
Detalhes
A API: lstrecordaccessHistory
é capaz de retornar o histórico de acesso da exibição de gravação do Webex Meetings, Webex Events (novo), Webex Events (clássico) e Webex Trainings.
Se não houver serviceType especificado na solicitação de API, a API de
lstrecordaccessHistory
retorna a exibição de gravação do Webex Trainings apenas para histórico acessado.Quando o serviceType é o MeetingCenter, a API de
lstrecordaccessHistory
retorna o histórico acessado da exibição de gravação do Webex Meetings e Webex Events (novo).Quando o serviceType é o EventCenter, a API de
lstrecordaccessHistory
retorna o histórico acessado da exibição de gravação do Webex Events (clássico).
A API: lstrecordaccessDetailHistory
pode retornar detalhes por recordID
do Webex Meetings, Webex Events (novo), Webex Events (clássico) e Webex Trainings.
Exemplo de solicitação e resposta de API
lstrecordaccessHistory
Solicitação e resposta da API
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<header>
<securityContext>
<webExID>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.history.LstrecordaccessHistory">
<viewTimeScope>
<viewTimeStart>20/09/2021 00:00:00</viewTimeStart>
<viewTimeEnd>28/09/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy>GRAVADO</orderBy>
<orderAD>ASC</orderAD>
</order>
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
</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>ÊXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Teste do LstrecordaccessHistory TC-20210924 1324-1</history:recordName>
<history:creationTime>24/09/2021 13:28:13</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>2</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Testerollment_001-20210610 1905-1</history:recordName>
<history:creationTime>06/10/2021 19:10:15</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>3</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Testar reprodução instantânea 2-20210705 0709-1</history:recordName>
<history:creationTime>05/07/2021 07:15:06</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>EC2.0_232423-20210922 0447-1</history:recordName>
<history:creationTime>22/09/2021 04:53:05</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>0</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>Teste de histórico do LstrecordaccessHistory EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>24/09/2021 13:19:00</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory teste MC-20210924 1319-1</history:recordName>
<history:creationTime>24/09/2021 13:25:12</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:recordAccessHistory>
<history:recordID>1XXXXXXX7</history:recordID>
<history:recordName>LstrecordaccessHistory teste EC classic-20210924 1331-1</history:recordName>
<history:creationTime>24/09/2021 13:37:28</history:creationTime>
<history:registered>0</history:registered>
<history:downloaded>1</history:downloaded>
<history:viewed>1</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordAccessHistory>
<history:matchingRecords>
<serv:total>8</serv:total>
<serv:returned>7</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
lstrecordaccessDetailHistory
Solicitação e resposta da 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>{userName}</webExID>
<password>{password}</password>
<siteName>{siteName}</siteName>
</securityContext>
</header>
<body>
<bodyContent xsi:type="">
"java:com.webex.service.binding.history.LstrecordaccessDetailHistory">
<recondID>1XXXXXX7</recondID>
<timeZoneID>20</timeZoneID>
</body>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>ÊXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history:lstrecordaccessDetailHistoryResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24/09/2021 13:27:26</history:accessTime>
<history:registered>falso</history:registered>
<history:downloaded>falso</history:downloaded>
<history:viewed>verdadeiro</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:recordDetail>
<history:viewID>1XXXXXX7</history:viewID>
<history:participantName>Axxxg</history:participantName>
<history:participantEmail>Axxxg@qa.webex.com</history:participantEmail>
<history:accessTime>24/09/2021 13:27:39</history:accessTime>
<history:registered>falso</history:registered>
<history:downloaded>verdadeiro</history:downloaded>
<history:viewed>falso</history:viewed>
<history:timeZoneID>20</history:timeZoneID>
</history:recordDetail>
<history:matchingRecords>
<serv:total>2</serv:total>
<serv:returned>2</serv:returned>
<serv:startFrom>1</serv:startFrom>
</history:matchingRecords>
</serv:bodyContent>
</serv:body>
</serv:message>
APIs de efeito:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Corrija a lacuna máxima permitida da descrição do Webex Events (Clássico) entre a página XMLAPI e Webex.
APIs impactadas
A API XML: Crie o elemento e SetEvent do descrição permitirá a entrada máxima de 10000 caracteres, se a inserção de tamanho superior, resultará no novo código de erro e na mensagem:
060068 Descrição de entrada ilegal. Esta descrição não pode exceder 10000 caracteres.
Alterações do esquema
Nenhuma alteração no esquema.
Exemplo de solicitação e resposta de API
Criar evento Solicitação e resposta da API
#Exemplo de solicitação de API:
...
<body>
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
xmlns: att="http://www.webex.com/schemas/2002/06/service/event" xsi:schemaLocation="http://www.webex.com/schemas/2002/06/service/eventhttp://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVADO</listing>
</accessControl>
<metaData>
<sessionName>Teste EC</sessionName>
<description>....... Suponha que você preencha 10000 caracteres na descrição.......</description>
</metaData>
...
------------------------------------
Exemplo de resposta API quando a descrição excede 10000 caracteres:
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common" xmlns:event="http://www.webex.com/schemas/2002/06/service/event">
<serv:header>
<serv:response>
<serv:result>FALHA </serv:result>
<serv:reason> Descrição de entrada ilegal. A descrição não pode exceder 10000 caracteres </serv:reason>
<serv:gsbStatus> PRIMARY </serv:gsbStatus>
<serv:exceptionID> 060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
APIs de efeito:
CreateEvent
SetEvent
API XML: GetUser retorna novo elemento de freeAccount
APIs impactadas
GetUser
retorna um novo elemento que identifica freeAccount
a conta de usuário é FreeAccount
ou não.
Alterações do esquema
Exemplo de resposta do GetUser
Resposta do GetUser:
<use:initials>AW </use:initials>
<use:isUploaded> false </use:isUploaded>
<use:largeEventCapacity> 3 </use:largeEventCapacity>
<use:freeAccount> false</use:freeAccount>
APIs de efeito:
GetUser
Atualizações da API 41.10.0
Não há alterações de esquema no esquema XML API 41.10.0. |
Atualizações da API 41.9.0
Atualizações da API XML 41.9.0
Desativar XML API 10.0.0 para todos os sites T31
O Webex planeja encerrar a vida útil do suporte XML API ver 10.0.0 para todos os sites T31.
Estamos desativando o código XML API 10.0.0 de todas as produções na atualização 41.9.0.
Atualizações da API 41.8.0
Atualizações da API XML 41.8.0
Desativar XML API 10.0.0 para todos os sites T31
O Webex planeja encerrar a vida útil do suporte XML API ver 10.0.0 para todos os sites T31.
O Webex encontrou alguns clientes que acessam a URL da API XML usando a maneira incorreta como: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, a maneira correta de acessar a URL da API XML como: https://{siteName}.webex.com/WBXService/XMLService.
Alterne o XML API de acesso ao código usando a maneira correta de evitar impacto antes de terminarmos o suporte à API XML versão 10.0.0.
Atualizações da API 41.7.0
Atualizações da API XML 41.7.0
A exclusão e edição de gravação de dispositivos móveis devem ser controladas pela opção de administração do site: Permitir que os organizadores reatribuam, editem, desabilitem e excluam gravações
APIs impactadas e alterações de esquema
GetSite
: retornará novos elementos nomeando enableNBRMCModify
, e separateNoRecordingEdit
em ferramentas.
Exemplo de resposta
GetSiteResponse
:
GetSite
<?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>ÊXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:tools>
...
<ns1:enableNBRMCModify> false </ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit> true </ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Atualizações da API 41.6.3
Atualizações da API XML 41.6.3
GetSite
Novo elemento de resposta de supportLargeEvent
APIs impactadas e alterações de esquema
GetSite : retorna novos elementos nomeando supportLargeEvent
em siteCommonOptions
para informar ao autor da chamada se o site é compatível com o Grande Evento (Webex Event (novo)) ou não.
Alteração de esquema
Exemplo de resposta
GetSiteResponse
:
GetSite
<?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>ÊXITO</serv:result>
<serv:gsbStatus>PRINCIPAL</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
...
<ns1:siteCommonOptions>
...
<ns1:enablePreMeetingLobby> false </ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent> true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Atualizações da API 41.6.0
Atualizações da API XML 41.6.0
XMLAPI suporta o Webex Events 2.0 no provisionamento
APIs impactadas
GetUser
: retorna novo elemento nomeando largeEventCapacity
que mostra a capacidade do novo Evento 2.0 (EC 2.0) nesta conta de usuário. Por exemplo, se a conta de usuário tiver a licença CI _ EC3K, o valor de largeEventCapacity
é 3000.
Alterações do esquema
Exemplo de resposta
Resposta GetUserResponse:
XMLAPI LstRecording's CreateTime aplica a hora de início da gravação
APIs impactadas
LstRecording
: LstRecording
resposta CreateTime
como a hora em que o usuário realmente pressiona o botão Gravar.
Detalhes
No passado, a API XML usou o carimbo de data/hora de quando a gravação foi criada no banco de dados como a hora de criação em LstRecording
resposta. Agora é a hora que o usuário realmente começa a fazer a gravação. Essa alteração se aplica a todas as gravações de serviço. Não há mudanças de esquema.
Atualizações da API 41.5.0
Atualizações da API XML 41.5.0
O XMLAPI pode iniciar reuniões Webex agendadas do PSTN como organizador
APIs impactadas
CreateUser
: gerahostPIN
independentemente da PMR do usuário estar habilitada ou não quando a função do usuário é organizador ou administradores do site completo ou de somente leitura ou de gerenciamento de usuários.SetUser
: conjuntoshostPIN
usandophones.hostPIN
quandopersonalMeetingRoom.hostPIN
não está na solicitação XML (pré-condição: alternância de recursosAllowStartScheduledMtgFromPhone
está ativado).GetUser
: retornaphones.hostPIN
independentemente do usuário PMR estar ativado ou não. (pré-condição: alternância de recursosAllowStartScheduledMtgFromPhone
está ativado).
Alterações de esquema
GetUserResponse
:
SetUser
:
Exemplo de resposta
GetUserResponse
:
SetUser
:
XMLAPI GetSite
responder dois novos elementos para o cliente móvel
APIs impactadas
GetSite
:GetSite
Agora responderá a dois novos elementos para suportar o cliente móvel que tem a lógica de exibir ou não a guia de gravação.enableRecordingAccess
: verdadeiro ou falso, os superadministradores Webex podem ativar ou desativar o acesso à gravação pelo ggle(EnableRecordingAccesses
).storageEmptyStatus
: verdadeiro ou falso, se ambos os sites não suportam a função NBR e alocaram o espaço de armazenamento NBR como zero, então a resposta de status é verdadeira, caso contrário é falsa.
Alterações de esquema
Solicitação de amostra para GetSite
Resposta de amostra para Getsite
O assunto do e-mail que tem caracteres não ASCII será codificado com o RFC2047. No caso de um assunto de e-mail de caractere ASCII puro, não há codificação
APIs impactadasNão há impactos em nenhuma solicitação de API, carga de respostas, mas isso muda o comportamento de codificação do assunto do e-mail. Quando o assunto do e-mail que tem caracteres não ASCII será codificado com o RFC2047. No caso de um assunto de e-mail de caractere ASCII puro, não há codificação.
Alterações de esquema
Não há alterações de esquema.
Atualizações da API 41.4.0
Atualizações da API XML 41.4.0
Criar evento agendado Webex Events pode aproveitar o padrão no nível do site no tom de entrada e saída
O XMLAPI se alinha com a nova lógica atual para controlar o tom de entrada e saída. Todos os tons do Webex Events foram controlados por uma configuração diferente na administração do site. No GetSite
, XMLAPI retorna um campo extra entryExitToneEC
para indicar o valor. Originalmente, quando o administrador do site definir um padrão para o tom, criar Evento não vai aproveitar essa configuração, aplicando o padrão XMLAPI.
APIs impactadas
A API XML: GetSite retorna um novo elemento entryExitToneEC
para indicar o valor.
A API XML: CreateEvent, SetEvent, GetEvent lógica comercial de back-end lê o valor de entryExitToneEC
.
Alterações do esquema
API XML: Exemplo de resposta do GetSite:
<ns1:defaults>
<ns1:emailReminders>verdadeiro</ns1:emailReminders>
<ns1:entryExitTone>ANUNCIAMENTO</ns1:entryExitTone>
<ns1:entryExitToneEC>RUÍDO</ns1:entryExitToneEC>
<ns1:voip>verdadeiro</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NENHUM</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>verdadeiro</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>falso</ns1:updateTSPAccount>
</ns1:defaults>
APIs de efeito:
GetSite
CriarEvento
DefinirEvento
GetEvent
XMLAPI simplesmente retorna as informações detalhadas do grande evento (Webex Event 2.0)
Se a reunião Webex for o grande evento ou webcast,
GetSessionInfo
retorna algumas informações detalhadas, incluindo senha da reunião, senha numérica da reunião, senha de membro de equipe e senha numérica de membro de equipe (nenhum esquema será alterado).O XMLAPI não suporta a criação e edição de nenhum grande recurso de evento ou webcast, portanto,
CreateMeeting
eSetMeeting
retorne uma nova exceção (110064, O tipo de sessão de evento e webcast não é compatível.) para grandes eventos ou casos de webcast.
APIs de impacto
Nome da API | Descrição | Observação |
---|---|---|
| Se a reunião Webex for o grande evento ou webcast, | Nenhum esquema será alterado. |
| Se o usuário tentar usar | Comportamento alterado. |
Atualizações da API 41.3.0
Atualizações da API XML 41.3.0
As novas alterações da API XML suportam o recurso Webex Events 2.0
APIs impactadas
Ambas as APIs: GetSessionInfo e GetMeeting elementos de retorno enableEvent
e enableWebniar
Também.
Nome do elemento | Descrição |
---|---|
possibilitar evento | Suporta EC 2.0 em uma reunião Webex |
enableWebniar | Suporta Webinar em uma reunião Webex |
O suporte ao XMLAPI retorna acima de dois elementos para o EC 2.0. A versão atual da API XML não é compatível com o agendamento e a configuração da reunião EC2.0. |
Alterações do esquema
GetSessionInfo
retorna elementos enableEvent
e enableWebniar
para o EC 2.0.
GetMeeting
retorna elementos enableEvent
e enableWebniar
para o EC 2.0.
Amostra de resposta:
GetSessionInfo
resposta:
<ep:accessControl>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>verdadeiro</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadeiro</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
resposta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>verdadeiro</meet:HQvideo>
<meet:HDvideo>verdadeiro</meet:HDvideo>
<meet:viewVideoThumbs>verdadeiro</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>verdadeiro</meet:enablePreMeetingLobby>
As novas alterações do XMLAPI suportam o recurso de lobby pré-reunião
APIs impactadas
A API XML: GetSite
, LstSummarySession
, GetSessionInfo
, e GetMeeting
responderá ao novo elemento enablePreMeetingLobby
para o lobby pré-reunião.
Alterações do esquema
A API XML: GetSite
retorna elemento enablePreMeetingLobby
para o lobby pré-reunião.
A API XML: LstSummarySession
retorna elemento enablePreMeetingLobby
para o lobby pré-reunião.
A API XML: GetSessionInfo
retorna elemento enablePreMeetingLobby
para o lobby pré-reunião.
A API XML: GetMeeting
retorna elemento enablePreMeetingLobby
para o lobby pré-reunião.
Amostra de resposta:
GetSite
resposta:
<ns1:siteCommonOptions>
<ns1:SupportCustomDialRestriction>falso</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>falso</ns1:SupportTelePresence>
<ns1:SupportTelePresencePlus>falso</ns1:SupportTelePresencePlus>
<ns1:EnableCloudTelepresence>verdadeiro</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>verdadeiro</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>verdadeiro</ns1:enablePersonalMeetingRoom>
<ns1:SupportAlternateHost>verdadeiro</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturnScheduledPMR>falso</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>verdadeiro</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>verdadeiro</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
resposta:
<ep:isException>falso</ep:isException>
<ep:isNextUpcomingInstance>verdadeiro</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadeiro</ep:enablePreMeetingLobby>
GetSessionInfo
resposta:
<ep:accessControl>
<ep:listStatus>PÚBLICO</ep:listStatus>
<ep:registration>falso</ep:registration>
<ep:passwordReq>verdadeiro</ep:passwordReq>
<ep:isEnforceAudioPassword>falso</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>falso</ep:isEnforceAudioLogin>
<ep:enableEvent>falso</ep:enableEvent>
<ep:enableWebniar>falso</ep:enableWebniar>
<ep:enablePreMeetingLobby>verdadeiro</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
resposta:
<meet:supportPKI>falso</meet:supportPKI>
<meet:HQvideo>verdadeiro</meet:HQvideo>
<meet:HDvideo>verdadeiro</meet:HDvideo>
<meet:viewVideoThumbs>verdadeiro</meet:viewVideoThumbs>
<meet:enableEvent>falso</meet:enableEvent>
<meet:enableWebniar>falso</meet:enableWebniar>
<meet:enablePreMeetingLobby>verdadeiro</meet:enablePreMeetingLobby>
A API XML GetSite
alteração de comportamento das Informações de resposta divulgada
APIs impactadas
A API XML: GetSite
apenas a resposta abaixo dos elementos da conta de administrador, que incluem funções: SiteAdmin
, RO_SiteAdmin
, e UserAdmin
.
<ns1:activeUserCount>...</ns1:activeUserCount>
<ns1:EEActiveUserCount>...</ns1:EEActiveUserCount>
<ns1:activeCETHost>...</ns1:activeCETHost>
<ns1:auoActiveUserCount>...</ns1:auoActiveUserCount>
<ns1:MCActiveUserCount>...</ns1:MCActiveUserCount>
<ns1:ECActiveUserCount>...</ns1:ECActiveUserCount>
<ns1:TCActiveUserCount>...</ns1:TCActiveUserCount>
<ns1:SCActiveUserCount>...</ns1:SCActiveUserCount>
Comportamento alterado
Permitir apenas a função de Administrador tem resposta dados de licença de GetSite
. O organizador ou convidado não obterá esses dados de licença no GetSite
resposta.
Veja a seguir a API: GetSite's
exemplo de resposta para siteadmin
ou somente pronto siteadmin
ou administrador de gerenciamento de usuários:
Atualizações da API 41.2.0
Atualizações da API XML 41.2.0
O XMLAPI deve suportar "VOIP CMR híbrido" se o site suportar a telefonia Webex
APIs impactadas
GetSite
retorna um novo elementoIsWebexTelephony
na resposta.CreateUser
eSetUser
pode atualizar ocmrHybridVoip
elemento seIsWebexTelephony
é verdadeiro junto com outras condições.IsTSPUsingTelephonyAPI
Não é mais consequencial.
Alterações do esquema
API XML: GetSite
a resposta retorna um elemento adicional IsWebexTelephony
GetSite
a resposta inclui este novo elemento:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>verdadeiro</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>falso</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Nº de Conferência Pessoal</ns1:serviceName>
<ns1:participantAccessCodeLabel>Código de acesso do convidado</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Código de acesso do organizador</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>ID do convidado</ns1:attendeeIDLabel>
....
</ns1:telephonyConfig>
LstSummarySession
suporta o EC2.0
As APIs XML serão afetadas
LstSummarySession
retornará novos dois elementos para suportar o EC 2.0
Nome do elemento | Descrição |
---|---|
possibilitar evento | Suporta EC 2.0 em uma reunião Webex |
enableWebniar | Suporta Webinar em uma reunião Webex |
Alterações do esquema
API XML: LstSummarySession
: Anexar o < enableEvent
> e < enableWebniar
> elementos
Resposta da API XML: LstSummarySession
Resposta para EC 2.0
<ep:isNextUpcomingInstance>verdadeiro</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>falso</ep:isScheduledPMR>
<ep:enableEvent>verdadeiro</ep:enableEvent>
<ep:enableWebniar>verdadeiro</ep:enableWebniar>
O XMLAPI suporta o retorno de usuário do site Webex-voice-assistant
opção de integração MCT
API afetada
GetUser
retorna um novo elemento webexAssistantEnabled
(verdadeiro ou falso) na resposta.
Alterações do esquema
getUserResponse
:
Exemplo de resposta
Atualizações da API 41.1.0
Não há alterações de esquema no esquema XML API 41.1. |