Este artigo é uma plataforma para notificações sobre mudanças recentes e planejadas no esquema da API GraphQL do Cato. Ele contém notícias e atualizações destacando novas capacidades, como APIs recém-lançadas e ferramentas de automação.
Para informações sobre alterações que podem exigir que você atualize seu cliente de API, consulte Cato API Potentially Breaking Changes and EoL.
Os termos da API usados neste artigo são explicados em O que é a API Cato.
Para qualquer cliente usando a API do Cato, recomendamos que você clique em Seguir para receber automaticamente notificações por email de atualizações neste artigo sobre mudanças na API.
Para mais informações sobre as APIs, consulte a Referência da API GraphQL da Cato Networks.
Notícias e Atualizações
Ações Adicionais de Usuário
Alterar: API Atualizado
Título da Funcionalidade: Administração simplificada de usuários através de fluxos de trabalho externos e sistemas de gerenciamento de identidade
A API suporta ativar usuários (enableUser) e desativar usuários (disableUser).
Análises Melhoradas para Resultados de API de AppStats Agrupados - 21 de Jun 2026
Título da Funcionalidade: Análises Melhoradas para Resultados de API de AppStats e Eventos Agrupados
Ao consultar dados da API AppStats ou Eventos e agrupar por uma dimensão, como país ou tipo de dispositivo, você pode optar por exibir registros sem valor para essa dimensão como um grupo vazio. Isso ajuda a garantir totais consistentes nas consultas da API e mostra dados anteriormente ocultos em painéis de controle e relatórios CMA.
Novo parâmetro booleano a nível de consulta:
IncludeEmptyDimension, sem impacto nos scripts de API existentes.Aplica-se às consultas de API e dados exibidos no CMA
Campos adicionados para API appStats para Clientes DEM - 19 de abril de 2026
Alterar: API Atualizado
Título do Recurso: Atualizações para API appStats para métrica de experiência de aplicação
Os seguintes novos Campos para a API appStats estão Disponíveis para Métricas de Experiência de Aplicação para habilitar o Acesso Programático a Dados de Usuário, Anfitrião e Desempenho de Aplicação:
experience_score_level- Indicador de Pontuação de Experiência Agregadattfb- Tempo até o Primeiro Byte, mede a capacidade de resposta do Servidortls_latency- Tempo para estabelecer Conexão TLStcp_latency- Tempo de configuração da Conexão TCPhttp_latency- Latência de solicitação HTTP de ponta a pontahttp_error_rate- Taxa de Erros HTTP observados
Nota: Esses campos estão disponíveis apenas para clientes com licença DEM.
APIs de Mutação adicionadas para Webhooks, Listas de Email e Grupos de Assinatura - 29 de março de 2026
Alterar: Nova API
Título do Recurso: Suporte a API para gerenciar webhooks, listas de email e grupos de assinatura
Use as seguintes APIs para atribuir, substituir, atualizar e remover licenças de sites via API para licenças individuais e agrupadas
Gerencie integrações de webhook usando
createWebhook,updateWebhook,deleteWebhook,webhook,webhookList, etestWebhookGerencie Lista de Emails usando
createMailingList,updateMailingList,deleteMailingList,mailingList, emailingListListCombine webhooks e Listas de Emails em 'Grupos de Assinatura usando'
createSubscriptionGroup,updateSubscriptionGroup,deleteSubscriptionGroup,subscriptionGroup, esubscriptionGroupList
Para detalhes sobre a gestão de notificações no CMA, consulte os artigos de Notificações do KB
Novas Notícias e Atualizações de API Anteriores
Atualizações nas APIs de Política de Túnel Dividido - 18 de jan, 2026
Alterar: API Atualizado
Título do Recurso: Atualizações para SplitTunnelPolicyMutations
As seguintes APIs foram alteradas para alinhar mais precisamente com o comportamento do recurso no Aplicativo de Gerenciamento Cato.
Essas mudanças se aplicam a todas as mutações para a política de Túnel Dividido:
Exclude- alterado para RouteAllToCatoExceptInclude- alterado para RouteOnlySelectedCoverage- alterado para ConnectionModednsExclusion- alterado para dnsSuffix
Essas APIs estão atualmente disponíveis como Beta.
APIs de Mutação adicionadas para Licenças de Largura de Banda do Site - 11 de agosto de 2025
Alterar: Nova API
Título do Recurso: Suporte da API para gerenciar licenças de largura de banda do site
Use as seguintes APIs para atribuir, substituir, atualizar e remover licenças de sites via API para licenças individuais e agrupadas
APIs de Mutação:
assignSiteBwLicense- atribui uma licença a um siteupdateSiteBwLicense- para licenças agrupadas, atualiza a largura de banda para um sitereplaceSiteBwLicense- substitui a licença de site sem tempo de inatividaderemoveSiteBwLicense- remove uma licença de um site
Essas APIs estão atualmente disponíveis como Beta.
APIs de Consulta adicionadas para Catálogo de Aplicativos e Tipos de Conteúdo DLP - 19 de maio de 2025
Alterar: Nova API
Título do Recurso: Suporte da API para consulta de Catálogo de Aplicativos e Tipos de Conteúdo DLP
Catálogo de Aplicativos - Consulte os dados para aplicativos, incluindo Conformidade, Segurança e Atividades CASB:
catalogApplicationList- Todos os aplicativos e dadoscatalogApplication- Aplicativo único
Conteúdo DLP - Consulte os tipos de conteúdo para a regra de Proteção de Dados Inline DLP
contentTypeGroupList
Essas APIs estão atualmente disponíveis como Beta.
API de Mutação adicionada para HA Secundário vSocket - 2 de março de 2025
Alterar: Nova API
Título do Recurso: Suporte da API para vSocket secundário para configurações HA
Use as seguintes APIs para definir veredictos de história, alterar o status e adicionar comentários
APIs de Mutação:
addSecondaryAwsVSocketInputPara vSocket AWS com configuração HA, adicione um vSocket secundárioAddSecondaryAzureVSocketInputPara vSocket AWS com configuração HA, adicione um vSocket secundário
Essas APIs estão atualmente disponíveis como Beta.
API de Mutação XDR adicionada - 12 de janeiro de 2025
Alterar: Nova API
Título do Recurso: Suporte da API para histórias e comentários XDR
Use as seguintes APIs para definir veredictos de história, alterar o status e adicionar comentários
APIs de Mutação:
addStoryCommentPoste comentários que ajudam no rastreamento da investigação da históriaanalystFeedbackGerencie Ações da História, como o Veredito, Tipo e Classificação da história.deleteStoryCommentExclua um comentário postado anteriormente usando o ID do comentário
Esta API está atualmente disponível como Beta.
Suporte à Largura de Banda de Última Milha Suporta Kbps - 12 de jan, 2025
Mudança: Melhoria para APIs
Título do Recurso: Defina valores de largura de banda do site que incluam um ponto decimal (por exemplo, 1.5 Mbps) para maior precisão granular
Use as seguintes APIs para definir veredictos de história, alterar o status e adicionar comentários
Tipos impactados para APIs:
LastMileBwInputInterfaceInfoSocketInterfaceBandwidthInput
Esses tipos de API estão atualmente disponíveis como Beta.
Mudanças para accountSnapshot e accountMetrics para Sites IPsec IKEv2 - 12 de jan, 2025
Mudança: Atualização do valor Principal para Principal 1
Título do Recurso: Suporte da API para sites IPsec IKEv2
O valor recuperado do campo InterfaceId nas consultas accountSnapshot e accountMetrics está mudando a partir do lançamento gradual de suporte para configurações Ativas/Ativas em 12 de Janeiro de 2025.
Valor Antigo | Novo Valor | Nota |
|---|---|---|
Principal | Principal1 | Esta mudança nos permite suportar mais de um túnel principal |
Nova API de Peering BGP - 23 de dez, 2024
Alterar: Nova API
Título do Recurso: Suporte da API para Emparelhamento BGP
Use as APIs a seguir para simplificar a configuração e o monitoramento de pares BGP para locais
APIs de Mutação:
addBgpPeerAdicione um novo par BGP a um siteupdateBgpPeerAtualizar configurações para uma configuração de par BGP existenteremoveBgpPeerExcluir uma configuração de par BGP para um site
APIs de Consulta:
bgpPeerRecupere informações sobre um par BGP específicositeBgpStatusMostrar o status atual do BGP, incluindo detalhes da sessão e informações de rota
Esta API está atualmente disponível como Beta.