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 XML API 39 e XML API 11, consulte a visão geral das atualizações da API XML Cisco Webex Meetings (XML API 39 e anterior).
Para obter mais informações sobre a XML API 40, consulte a visão geral Cisco Webex Meetings atualizações da API XML (XML API 40 e posterior).
Para atualizações para XML API 11 SP9 e anterior, vá para Cisco DevNet.
Atualizações api 41.12.0
Atualizações XML API 41.12.0
XMLAPI bloqueará Webex Events agendamento e edição (clássico) de acordo com o item de configuração do site do EnableClassicEvent
que é falso
Alterações de APIs e esquema afetados
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 suportará mais Webex Events reuniões (clássicas).
Se a caixa de seleção Habilitar clássicoEvent for falsa, você liga para estas APIs para operar Webex Events reunião (clássica) :
CreateEvent
, SetEvent
, GetEvent
, GetSessionInfo
, LstsummaryEvent
, LstrecordedEvent
, LstsummaryProgram
, UploadEventImage
A API responderá à nova exceção 010106O evento clássico foidesativado.
Alterações de esquema
Nenhuma alteração de esquema.
Exemplo de resposta e solicitação API
Solicitação e resposta API CreateEvent
Solicitação de CreateEvent
<bodyContent xsi:type="java:com.webex.service.binding.event.CreateEvent">
<accessControl>
<sessionPassword>XXXXXXXX</sessionPassword>
</accessControl>
<metaData>
<sessionName>XMLAPI EC Testing</sessionName>
</metaData>
<schedule>
<startDate>07/17/2021 01:29:15</startDate>
<openTime>15</openTime>
</schedule>
</bodyContent>
</body>
</serv:message>
Resposta de CreateEvent
<?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>FAILURE</serv:result>
<serv:reason>The classic Event has been disabled.</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>010106</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
CreateEvent3.1.3 Afeta as APIs:
SetEvent GetEvent
GetSessionInfo
LstsummaryEvent
LstrecordedEvent
LstsummaryProgram
UploadEventImage
XMLAPI LstMeetingType
será responder a um novo elemento de subProductCodePrefix
APIs impactadas
Atualmente a API LstMeetingType
elemento de resposta de productionCodePrefix
: PRO, AUO e outros que são Prefixos de tipo de reunião predefinidos pelo Webex.
Após este novo aprimoramento, a API responderá a um novo elemento de subProdctCodePrefix
:P RO1, PRO2, etc. que podem ser personalizados ao atender o prefixo do tipo.
Alterações de esquema na API: LstMeetingType
Será um novo elemento de resposta: subProdctCodePrefix
Exemplo de resposta e solicitação 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>
</body>
</serv:message>
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> //New element for customized meeting
type
<mtgtype:active>ACTIVATED</mtgtype:active>
<mtgtype:name>Cus_Chat_Closed</mtgtype:name>
<mtgtype:displayName>Cus_Chat_Closed</mtgtype:displayName>
Atualizações api 41.11.0
Atualizações XML API 41.11.0
Compatibilidade encaminhada de suporte API xml na API de gerenciamento de usuários para sites gerenciados pelo Control Hub
Alterações de APIs e esquema afetados
Se o seu aplicativo de integração estiver usando atualmente APIs de gerenciamento de usuário XMLAPI Webex: CreateUser
, SetUser
, DelUser
, e GetUser
para provisionar ou gerenciar usuários depois que o site clássico Webex for convertido no site gerenciado do Control Hub, esses APIs continuarão a funcionar para compatibilidade encaminhada. Existem algumas mudanças de comportamento, como se pode ver abaixo:
Ao usar createUser - se o status do usuário no Control Hub não for "ativo", o status do usuário no site não estará ativo. Se o status do usuário no Control Hub estiver ativo, o status do usuário no site também será ativo, referência: Status do usuário de usuários novos e convertidos no Control Hub.
O elemento de senha das APIs CreateUser e SetUser será ignorado. Começará a enviar e-mail de ativação para novos usuários e os usuários poderão clicar no link no e-mail para ativar a nova conta e inserir a nova senha.
O elemento ativo da API CreateUser será ignorado; um novo usuário (não verificado) não poderá ser ativado através deste parâmetro usando o APISetUser.
O valor do elemento webExId no corpoContent de CreateUser APIs deve ser igual ao e-mail. Se webExId for diferente do e-mail, trataremos o webExId da mesma forma que o e-mail ao armazenar no WebDB e o valor será ignorado.
O valor do elemento webExId no corpoContent de SetUser APIs deve ser a identidade do usuário do endereço de e-mail, você pode alterá-lo usando e-mail >bodyContent.
A API SetUser suportará a alteração do e-mail do usuário existente: isso será bem-sucedido se a conta de operação no SecurityContext for o administrador completo do site do Control Hub. Caso contrário, o API reporta erro com novo código de erro e mensagem abaixo:
030120 A conta deve ser um administrador completo do site para alterar o e-mail.
O elemento newWebExId no bodyContent do SetUser API será ignorado.
A API SetUser tenta alterar para um e-mail que já está em uso, a API aumenta abaixo o novo código de erro e a mensagem de erro:
030118 e-mail já está sendo usado nos sites gerenciados do Control Hub.
A API do DelUser desativa o usuário do 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 o API: SetUser ( ATIVADO ) desde que o usuário seja verificado<active></active>antes.
As APIs CreateUser e SetUser levantam o novo código de erro e a mensagem de erro como mostrado abaixo:
030117 , esse usuário existe fora da sua organização, então precisa ser reivindicado para mover para a sua organização através do processo dereivindicação de usuário. Para saber as etapas para 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 que o usuário pertence antes de reivindicar o usuário.
030119 O token de acesso CI deve incluir o escopo webexsquare: admin ao provisionar usuário.
Somente a compatibilidade de encaminhamento de um período limitado é suportada. Forneceremos um aviso avançado antes que essa compatibilidade seja removida. |
Alterações de esquema
Nenhuma alteração de esquema nessas APIs: CreateUser
, SetUser
, DelUser
, e GetUser
.
Exemplo de resposta e solicitação API
Solicitação e resposta de API CreateUser
API request:
<?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/service http://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> or <password> or <webExAccessToken>
or <accessToken>, when using CI "accessToken", it must include scope webexsquare:admin when provisioning
user
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.CreateUser">
<webExId>Jack@qa.webex.com</webExId> --- it should is user identity of email address
<email>Jack@qa.webex.com</email>
<firstName>Jack</firstName>
<lastName>Smith</lastName>
<password>....</password>
<privilege>
<host>true</host>
</privilege>
<active>ACTIVATED</active> ---this parameter can't active the user directly until the user self activate itself via activation
email.
</bodyContent>
</body>
</serv:message>
API response example:
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common"
xmlns:use="http://www.webex.com/schemas/2002/06/service/user">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="use:createUserResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<use:userId>23778617</use:userId>
</serv:bodyContent>
</serv:body>
</serv:message>
Afetar APIs:
Createuser
Setuser
DelUser
API XML suporta a compatibilidade encaminhada 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 webex clássico é convertido para o site gerenciado pelo Control Hub, o valor do elemento em precisa ser igual <webExID> ao e-mail, <securityContext> os detalhes abaixo:
Para usuários existentes criados no site clássico Webex, suportamos tanto o webExID antigo (por exemplo: Jack) e o novo webExID (o conteúdo é o mesmo que o e-mail, exemplo: Jack@xx.com) para fazer logon, essa compatibilidade com compatibilidade retrotrógrada de autenticação é para todas as APIs XML.
Para novos usuários criados nos sites gerenciados pelo Control Hub, o valor do elemento webExID deve ser o mesmo que o e-mail para logon.
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com;
new user must use jack@xx.com
<sessionTicket>xxxx</sessionTicket> or <password> or <webExAccessToken> or <accessToken>
</securityContext>
</header>
Afetar APIs:
Todas as APIs XML.
Depois que o site Webex clássico convertido em um site gerenciado pelo Control Hub, o valor do corpo do elementoContent > precisa ser igual ao e-mail, <webExID> osdetalhesabaixo:
Para usuários existentes criados no site clássico Webex, suportamos tanto o webExId antigo(por exemplo: Jack) e o novo webExId (o conteúdo é o mesmo que o e-mail, por exemplo: Jack@xx.com) no bodyContent.
Para novos usuários criados nos sites gerenciados pelo Control Hub, o valor do elemento webExId deve ser igual ao e-mail no
bodyContent
.
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com; new user
must use jack@xx.com
</bodyContent>
Afetar APIs:GetUser
, SetUser
, e DelUser
.
Alterações de esquema
Nenhuma alteração de esquema em nenhuma APIs.
Exemplo de resposta e solicitação API
Solicitação e resposta de API GetUser
API request:
<?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/service http://www.webex.com/schemas/2002/06/service/service.xsd">
<header>
<securityContext>
<siteName>{siteName}</siteName>
<webExID>{userName}</webExID> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com;
new user must use jack@xx.com
<sessionTicket>xxxx</sessionTicket> or <password> or <webExAccessToken> or <accessToken>
</securityContext>
</header>
<body>
<bodyContent xsi:type="java:com.webex.service.binding.user.GetUser or SetUser or DelUser">
<webExId>xxxx</webExId> --- existing users were created in webEx classic site, it can be: jack or jack@xx.com; new user
must use jack@xx.com
</bodyContent>
</body>
</serv:message>
API response example:
...same as before
Melhoria na API do relatório de histórico de exibição de gravação para suportar Webex Meetings, Webex Events (nova) e Webex Events (clássica)
APIs impactadas
API atual: lstrecordaccessHistory
e lstrecordaccessDetailHistory
suportam apenas a exibição de gravação de treinamentos Webex do relatório de histórico acessado. O novo aprimoramento suporta Webex Meetings, Webex Events (novo) e Webex Events (clássico) relatório de histórico de gravação acessado também.
Alterações de esquema
Suportamos abaixo novo esquema no API lstrecordaccessHistory no corpo da solicitação de API:
<serviceTypes>
<serviceType>MeetingCenter</serviceType>
<serviceType>TrainingCenter</serviceType>
<serviceType>EventCenter</serviceType>
</serviceTypes>
Detalhes
A API: lstrecordaccessHistory
pode retornar o histórico de visualização de gravações acessado para Webex Meetings, Webex Events (novo), Webex Events (clássico) e Treinamentos Webex.
Se não houver nenhum serviceType especificado na solicitação de API, a API de
lstrecordaccessHistory
retorna somente a exibição de gravação de treinamentos Webex do histórico acessado.Quando o serviceType é MeetingCenter, a API de
lstrecordaccessHistory
retorna o Webex Meetings e o Webex Events (novo) histórico de visualização de gravação acessado.Quando o serviceType é o EventCenter, a API de
lstrecordaccessHistory
retorna Webex Events (clássico) histórico de visualização de gravação acessado.
A API: lstrecordaccessDetailHistory
pode retornar detalhes por recordID
da Webex Meetings, Webex Events (novo), Webex Events (clássico) e Treinamentos Webex.
Exemplo de resposta e solicitação 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>9/20/2021 00:00:00</viewTimeStart>
<viewTimeEnd>9/28/2021 23:59:59</viewTimeEnd>
</viewTimeScope>
<listControl>
<startFrom>1</startFrom>
<maximumNum>100</maximumNum>
</listControl>
<order>
<orderBy>RECORDID</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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</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>LstrecordaccessHistory test TC-20210924 1324-1</history:recordName>
<history:creationTime>09/24/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>Test instant playback 2-20210705 0709-1</history:recordName>
<history:creationTime>07/05/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>09/22/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>LstrecordaccessHistory test EC2.0-20210924 1315-1</history:recordName>
<history:creationTime>09/24/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 test MC-20210924 1319-1</history:recordName>
<history:creationTime>09/24/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 test EC classic-20210924 1331-1</history:recordName>
<history:creationTime>09/24/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>
</bodyContent>
</body>
</serv:message>
<?xml version="1.0" encoding="UTF-8"?>
<serv:message xmlns:serv="http://www.webex.com/schemas/2002/06/service" xmlns:com="http://www.webex.com/schemas/2002/06/common"
xmlns:history="http://www.webex.com/schemas/2002/06/service/history">
<serv:header>
<serv:response>
<serv:result>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="history: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>09/24/2021 13:27:26</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>false</history:downloaded>
<history:viewed>true</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>09/24/2021 13:27:39</history:accessTime>
<history:registered>false</history:registered>
<history:downloaded>true</history:downloaded>
<history:viewed>false</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>
Afetar APIs:
lstrecordaccessHistory
lstrecordaccessDetailHistory
Corrige a lacuna máxima permitida Webex Events tamanho da descrição (clássica) entre XMLAPI e a página Webex.
APIs impactadas
A API XML: O elemento de descrição CreateEvent e SetEvent permitirá no máximo 10000 caracteres entradas, se a entrada for maior do que o tamanho, resultará no novo código de erro e mensagem:
060068 entrada ilegal. Esta descrição não pode exceder 10000 caracteres.
Alterações de esquema
Nenhuma alteração de esquema.
Exemplo de resposta e solicitação API
Solicitação e resposta API CreateEvent
#API request example:
...
<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/event
http://www.webex.com/schemas/2002/06/service/event/event.xsd">
<accessControl>
<sessionPassword>111111</sessionPassword>
<listing>PRIVATE</listing>
</accessControl>
<metaData>
<sessionName>EC test</sessionName>
<description>.......Suppose you filling in 10000 characters in description.......</description>
</metaData>
...
------------------------------------
#API response example when the description exceeds 10000 characters:
<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>FAILURE</serv:result>
<serv:reason>Illegal input description. The description can't exceed 10000 characters</serv:reason>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
<serv:exceptionID>060068</serv:exceptionID>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent/>
</serv:body>
</serv:message>
Afetar APIs:
CreateEvent
SetEvent
API de XML: GetUser retorna novo elemento de conta livre
APIs impactadas
GetUser
retorna um novo elemento que identifica freeAccount
o conta de usuário é FreeAccount
ou não.
Alterações de esquema
Exemplo de resposta GetUser
GetUser response:
<use:initials>AW</use:initials>
<use:isUploaded>false</use:isUploaded>
</use:avatar>
<use:largeEventCapacity>3</use:largeEventCapacity>
<use:freeAccount>false</use:freeAccount>
</serv:bodyContent>
</serv:body>
</serv:message>
Afetar APIs:
GetUser
Atualizações api 41.10.0
Não há alterações de esquema no esquema XML API 41.10.0. |
Atualizações api 41.9.0
Atualizações xml API 41.9.0
Descompactar XML API 10.0.0 para todos os sites T31
A Webex planeja fim da vida útil 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 api 41.8.0
Atualizações xml API 41.8.0
Descompactar XML API 10.0.0 para todos os sites T31
A Webex planeja fim da vida útil XML API ver 10.0.0 para todos os sites T31.
A Webex encontrou alguns clientes acessando a URL da API XML usando a maneira incorreta como: https://{siteName}.webex.com/WBXService/xml10.0.0/XMLService, a maneira certa de acessar a URL de API XML como: https://{siteName}.webex.com/WBXService/XMLService.
Alternar a API XML de acesso de código usando a maneira certa para evitar o impacto antes de fim da vida útil suporte sobre XML API versão 10.0.0.
Atualizações api 41.7.0
Atualizações xml API 41.7.0
A exclusão e edição de gravação móvel deve ser controlada pela opção de administração do site: Permitir que os hosts reatribuam, editem, desabilitem e excluam gravações
Alterações de APIs e esquema afetados
GetSite
: retornará os novos elementos de nomeação 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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
<ns1:tools>
...
<ns1:enableNBRMCModify>false</ns1:enableNBRMCModify>
<ns1:separateNoRecordingEdit>true</ns1:separateNoRecordingEdit>
...
</ns1:tools>
</serv:bodyContent>
</serv:body>
</serv:message>
Atualizações api 41.6.3
Atualizações XML API 41.6.3
GetSite
Novo elemento de resposta de supportLargeEvent
Alterações de APIs e esquema afetados
GetSite: retorna novos elementos de nomeação supportLargeEvent
em siteCommonOptions
para permitir que o chamador saiba se o site tem suporte para Evento grande (evento Webex (novo)ou não.
Alteração do 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>SUCCESS</serv:result>
<serv:gsbStatus>PRIMARY</serv:gsbStatus>
</serv:response>
</serv:header>
<serv:body>
<serv:bodyContent xsi:type="ns1:getSiteResponse" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
....
<ns1:siteCommonOptions>
...
<ns1:enablePreMeetingLobby>false</ns1:enablePreMeetingLobby>
<ns1:supportLargeEvent>true</ns1:supportLargeEvent>
</ns1:siteCommonOptions>
</serv:bodyContent>
</serv:body>
</serv:message>
Atualizações api 41.6.0
Atualizações XML API 41.6.0
Suporte a XMLAPI Webex Events 2.0 no provisionamento
APIs impactadas
GetUser
: retorna nova nomeação de elemento largeEventCapacity
que mostra a capacidade do novo Evento 2.0 (EC 2.0) neste conta de usuário. Por exemplo, se o conta de usuário tem licença CI_EC3K, o valor de largeEventCapacity
é 3000.
Alterações de esquema
Exemplo de resposta
GetUserResponse:
CreateTime de XMLAPI LstRecording aplica hora de início da gravação
APIs impactadas
LstRecording
: LstRecording
Resposta CreateTime
como o horário em que o usuário realmente pressiona o botão gravar.
Detalhes
No passado, a API XML usada 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á nenhuma alteração de esquema.
Atualizações api 41.5.0
Atualizações xml API 41.5.0
XMLAPI tem a habilidade de iniciar reuniões Webex agendadas a PSTN como o anfitrião
APIs impactadas
CreateUser
: gerahostPIN
independentemente de PMR usuário está habilitado ou não quando a função de usuário é o host ou administradores completos ou de site de gerenciamento de usuários ou somente leitura.SetUser
: conjuntoshostPIN
Usandophones.hostPIN
QuandopersonalMeetingRoom.hostPIN
não está na solicitação XML (pré-condição: alternância de recursosAllowStartScheduledMtgFromPhone
está habilitado).GetUser
: retornaphones.hostPIN
independentemente da PMR usuário está habilitado ou não. (pré-condição: alternância de recursosAllowStartScheduledMtgFromPhone
está habilitado).
Alterações de esquema
GetUserResponse
:
SetUser
:
Exemplo de resposta
GetUserResponse
:
SetUser
:
XMLAPI GetSite
resposta dois novos elementos para o cliente móvel
APIs impactadas
GetSite
:GetSite
agora responderá dois novos elementos para suportar que o cliente móvel tenha a lógica de exibir ou não a guia de gravação.enableRecordingAccess
: verdadeiro ou falso, os super administradores Webex podem ativar ou desativar o acesso à gravação com o alternância (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, outra é falsa.
Alterações de esquema
Solicitação de amostra para GetSite
Resposta de amostra para Getsite
Assunto do e-mail que tem caracteres não ASCII será codificado com RFC2047. No caso de um e-mail de caractere ASCII puro, não há codificação
APIs impactadasNão há impactos sobre qualquer solicitação de API, carga de respostas, mas isso altera o comportamento de codificação do assunto do e-mail. Quando o assunto do e-mail que tiver caracteres não ASCII será codificado com RFC2047. No caso de um e-mail de caractere ASCII puro, não há codificação.
Alterações de esquema
Não há alterações de esquema.
Atualizações api 41.4.0
Atualizações xml API 41.4.0
Criar evento agendado Webex Events aproveitar o padrão no nível do site no tom de entrada e saída
XMLAPI se alinha com a nova lógica atual para controlar o tom de entrada e saída. Todos os tons para o Webex Events foram controlados por uma configuração diferente na administração do site. Em 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 aproveitará essa configuração aplicando XMLAPI padrão.
APIs impactadas
A API XML: GetSite retorna um novo elemento entryExitToneEC
para indicar o valor.
A API XML: CreateEvent, SetEvent, GetEvent back end business logic lê o valor do entryExitToneEC
.
Alterações de esquema
API de XML: Amostra de resposta getSite:
<ns1:defaults>
<ns1:emailReminders>true</ns1:emailReminders>
<ns1:entryExitTone>ANNOUNCENAME</ns1:entryExitTone>
<ns1:entryExitToneEC>NOTONE</ns1:entryExitToneEC>
<ns1:voip>true</ns1:voip>
<ns1:teleconference>
<ns1:telephonySupport>NONE</ns1:telephonySupport>
</ns1:teleconference>
<ns1:joinTeleconfNotPress1>true</ns1:joinTeleconfNotPress1>
<ns1:updateTSPAccount>false</ns1:updateTSPAccount>
</ns1:defaults>
Afetar APIs:
GetSite
Createevent
Setevent
Getevent
XMLAPI simplesmente retorna as informações de detalhes do evento grande (Webex Event 2.0)
Se o Webex Meetings for um grande evento ou webcast,
GetSessionInfo
retorna algumas informações detalhadas, incluindo senha numérica da reunião, senha numérica da reunião e senha numérica do palestrante (nenhum esquema será alterado).XMLAPI não suporta a criação e edição de qualquer grande evento ou recurso de webcast, portanto
CreateMeeting
eSetMeeting
retornar uma nova exceção (110064, O evento e o webcast tipo de sessão não são suportados.) para um grande evento ou caso de webcast.
APIs de impacto
Nome da API |
Descrição |
Observação |
---|---|---|
|
Se o Webex Meetings for um grande evento ou webcast, |
Nenhum esquema será alterado. |
|
Se o usuário tentar usar |
Comportamento a ser alterado. |
Atualizações api 41.3.0
Atualizações xml API 41.3.0
As novas alterações da API XML suportam Webex Events recurso 2.0
APIs impactadas
Ambos os APIs: Obterinformaçõesdesessão e elementos de retorno da GetMeeting enableEvent
e enableWebniar
Também.
Nome do elemento |
Descrição |
---|---|
enableEvent |
Suporta EC 2.0 em uma reunião Webex |
habilitarWebniar |
Suporta webinar em uma reunião Webex |
O suporte XMLAPI retorna acima dos dois elementos para o EC 2.0. A versão atual da API XML não suporta agendar e definir reuniões EC2.0. |
Alterações de esquema
GetSessionInfo
retorna elementos enableEvent
e enableWebniar
ec 2.0.
GetMeeting
retorna elementos enableEvent
e enableWebniar
ec 2.0.
Exemplo de resposta:
GetSessionInfo
Resposta:
<ep:accessControl>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
Resposta:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>true</meet:HQvideo>
<meet:HDvideo>true</meet:HDvideo>
<meet:viewVideoThumbs>true</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
</meet:enableOptions>
As novas alterações do XMLAPI suportam o recurso de lobby de Pré-reunião
APIs impactadas
A API XML: GetSite
, LstSummarySession
, GetSessionInfo
, e GetMeeting
responderá ao novo elemento enablePreMeetingLobby
para lobby de pré-reunião.
Alterações de esquema
A API XML: GetSite
retorna elemento enablePreMeetingLobby
para lobby de pré-reunião.
A API XML: LstSummarySession
retorna elemento enablePreMeetingLobby
para lobby de pré-reunião.
A API XML: GetSessionInfo
retorna elemento enablePreMeetingLobby
para lobby de pré-reunião.
A API XML: GetMeeting
retorna elemento enablePreMeetingLobby
para lobby de pré-reunião.
Exemplo de resposta:
GetSite
Resposta:
<ns1:siteCommonOptions>
<ns1:SupportCustomDialRestriction>false</ns1:SupportCustomDialRestriction>
<ns1:SupportTelePresence>false</ns1:SupportTelePresence>
<ns1:SupportTelePresencePlus>false</ns1:SupportTelePresencePlus>
<ns1:EnableCloudTelepresence>true</ns1:EnableCloudTelepresence>
<ns1:EnableCMRForAllUsers>true</ns1:EnableCMRForAllUsers>
<ns1:enablePersonalMeetingRoom>true</ns1:enablePersonalMeetingRoom>
<ns1:SupportAlternateHost>true</ns1:SupportAlternateHost>
<ns1:SupportXMLAPIReturnScheduledPMR>false</ns1:SupportXMLAPIReturnScheduledPMR>
<ns1:SupportAnyoneHostMeetings>true</ns1:SupportAnyoneHostMeetings>
<ns1:enablePreMeetingLobby>true</ns1:enablePreMeetingLobby>
</ns1:siteCommonOptions>
LstSummarySession
Resposta:
<ep:isException>false</ep:isException>
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>false</ep:isScheduledPMR>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:session>
GetSessionInfo
Resposta:
<ep:accessControl>
<ep:listStatus>PUBLIC</ep:listStatus>
<ep:registration>false</ep:registration>
<ep:passwordReq>true</ep:passwordReq>
<ep:isEnforceAudioPassword>false</ep:isEnforceAudioPassword>
<ep:isEnforceAudioLogin>false</ep:isEnforceAudioLogin>
<ep:enableEvent>false</ep:enableEvent>
<ep:enableWebniar>false</ep:enableWebniar>
<ep:enablePreMeetingLobby>true</ep:enablePreMeetingLobby>
</ep:accessControl>
GetMeeting
Resposta:
<meet:supportPKI>false</meet:supportPKI>
<meet:HQvideo>true</meet:HQvideo>
<meet:HDvideo>true</meet:HDvideo>
<meet:viewVideoThumbs>true</meet:viewVideoThumbs>
<meet:enableEvent>false</meet:enableEvent>
<meet:enableWebniar>false</meet:enableWebniar>
<meet:enablePreMeetingLobby>true</meet:enablePreMeetingLobby>
</meet:enableOptions>
A API XML GetSite
divulgação do comportamento das informações de resposta
APIs impactadas
A API XML: GetSite
somente a resposta abaixo elementos para a conta de administrador, que inclui 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 que a função de Administrador tenha dados de licença de resposta do GetSite
. O host ou o participante não conseguirão esses dados de licença em GetSite
Resposta.
Abaixo estão as API: GetSite's
exemplo de resposta para siteadmin
ou apenas pronto siteadmin
ou administrador de gerenciamento de usuários:
Atualizações api 41.2.0
Atualizações xml API 41.2.0
XMLAPI deve suportar "CMR híbrida VOIP" se o site suportar telefonia Webex
APIs impactadas
GetSite
retorna um novo elementoIsWebexTelephony
na resposta.CreateUser
eSetUser
pode atualizar ocmrHybridVoip
elemento seIsWebexTelephony
o é verdadeiro juntamente com outras condições.IsTSPUsingTelephonyAPI
não é mais conseqüente.
Alterações de esquema
API de XML: GetSite
resposta retorna um elemento adicional IsWebexTelephony
GetSite
a resposta incluir este novo elemento:
<ns1:telephonyConfig>
<ns1:isWebexTelephony>true</ns1:isWebexTelephony>
<ns1:isTSPUsingTelephonyAPI>false</ns1:isTSPUsingTelephonyAPI>
<ns1:serviceName>Personal Conference No.</ns1:serviceName>
<ns1:participantAccessCodeLabel>Attendee access code</ns1:participantAccessCodeLabel>
<ns1:subscriberAccessCodeLabel>Host access code</ns1:subscriberAccessCodeLabel>
<ns1:attendeeIDLabel>Attendee ID</ns1:attendeeIDLabel>
.....
</ns1:telephonyConfig>
LstSummarySession
suporta EC2.0
APIs XML serão impactadas
LstSummarySession
retornará novos dois elementos para suportar a EC 2.0
Nome do elemento |
Descrição |
---|---|
enableEvent |
Suporta EC 2.0 em uma reunião Webex |
habilitarWebniar |
Suporta webinar em uma reunião Webex |
Alterações de esquema
API de XML: LstSummarySession
: Anexar o < enableEvent
> e enableWebniar
> elementos
Resposta de XML API: LstSummarySession
Resposta para EC 2.0
<ep:isNextUpcomingInstance>true</ep:isNextUpcomingInstance>
<ep:seriesMeetingKey>0</ep:seriesMeetingKey>
<ep:isScheduledPMR>false</ep:isScheduledPMR>
<ep:enableEvent>true</ep:enableEvent>
<ep:enableWebniar>true</ep:enableWebniar>
</ep:session>
XMLAPI suporta o retorno do usuário do site Webex-voice-assistant
opção para integração MCT
API afetada
GetUser
retorna um novo elemento webexAssistantEnabled
(verdadeiro ou falso) na resposta.
Alterações de esquema
getUserResponse
:
Exemplo de resposta
Atualizações api 41.1.0
Não há alterações de esquema no esquema XML API 41.1. |