Changelog de la API de Cato

Prev Next

Este artículo es una plataforma para notificaciones sobre cambios recientes y planeados en el esquema de la API GraphQL de Cato. Contiene noticias y actualizaciones que destacan nuevas capacidades, como nuevas APIs liberadas y herramientas de automatización.

Para obtener información sobre cambios que podrían requerir que actualices tu cliente de API, ve Cato API Potentially Breaking Changes and EoL.

Los términos de API utilizados en este artículo se explican en Qué es el Cato API.

Para cualquier cliente que utilice la API de Cato, recomendamos que hagas clic en Seguir para recibir automáticamente notificaciones por correo electrónico sobre actualizaciones de este artículo acerca de cambios en la API.

Para más información sobre las APIs, consulte la Referencia de la API GraphQL de Cato Networks.

Noticias y Actualizaciones

Acciones Adicionales de Usuario

Modificar: API Actualizado

Título de la Función: Administración de usuarios simplificada a través de flujos de trabajo externos y sistemas de gestión de identidad

El API soporta habilitar usuarios (enableUser) y deshabilitar usuarios (disableUser).

Análisis Mejorado para los Resultados de AppStats API Agrupados - Jun 21, 2026

Modificar: Actualizado API

Título de Funcionalidad: Análisis Mejorado para los Resultados de AppStats y Eventos API Agrupados

Al consultar datos de AppStats o Eventos API y agrupar por una dimensión, como país o tipo de dispositivo, puede elegir mostrar los registros sin valor para esa dimensión como un grupo vacío. Esto ayuda a garantizar totales consistentes en las consultas API y muestra datos previamente ocultos en paneles de control e informes CMA.

  • Nuevo parámetro booleano a nivel de consulta: IncludeEmptyDimension, sin impacto en los scripts API existentes

  • Se aplica a consultas API y datos mostrados en el CMA.

Campos agregados para la API de estadísticas de aplicaciones para clientes DEM - 19 abril de 2026

Modificar: Actualizado API

Título de la Función: Actualizaciones a la API appStats para métricas de experiencia de aplicación

Los siguientes nuevos Campos para la API appStats están disponibles para las métricas de la Experiencia de la Aplicación para Habilitar el acceso programático a Usuario, Host, y Rendimiento de la Aplicación:

  • experience_score_level - Indicador de puntaje de Experiencia agregado

  • ttfb - Tiempo hasta el Primer Byte, mide la capacidad de respuesta del Servidor

  • tls_latency - Tiempo para establecer Conexión TLS

  • tcp_latency - Configuración de tiempo de Conexión TCP

  • http_latency - Latencia de solicitud HTTP de extremo a extremo

  • http_error_rate - Tasa de errores HTTP observados

Nota: Estos campos solo están disponibles para clientes con una Licencia DEM

Agregadas APIs de mutación para Webhooks, Listas de Correo, y Grupos de Suscripción - 29 marzo de 2026

Modificar: Nueva API

Título de la Característica: Soporte API para gestionar webhooks, listas de correo, y grupos de suscripción

  • Utilice las siguientes APIs para asignar, reemplazar, actualizar y eliminar licencias de sitio a través de API para licencias individuales y agrupadas

      • Gestiona integraciones webhook usando createWebhook, updateWebhook, deleteWebhook, webhook, webhookList, y testWebhook

      • Gestiona listas de correo usando createMailingList, updateMailingList, deleteMailingList, mailingList, y mailingListList

      • Combina webhooks y listas de correo en 'grupos de suscripción usando' createSubscriptionGroup, updateSubscriptionGroup, deleteSubscriptionGroup, subscriptionGroup, y subscriptionGroupList

    Para detalles sobre la gestión de notificaciones en el CMA, consulta los artículos KB de Notificaciones

Noticias y Actualizaciones de API Previas

Actualizaciones a las APIs de Política de Túnel Dividido - 18 Ene, 2026

Modificar: Actualizado API

Título de la característica: Actualizaciones de SplitTunnelPolicyMutations

  • Las siguientes APIs han sido modificadas para alinearse más exactamente con el comportamiento de la característica en la Aplicación de Gestión de Cato.

    • Estos cambios se aplican a todas las mutaciones para la Política de Túnel Dividido: 

      • Excluir - cambiado a RouteAllToCatoExcept

      • Incluir - cambiado a RouteOnlySelected

      • Cobertura - cambiado a ConnectionMode

      • dnsExclusion - cambiado a dnsSuffix

Estas APIs están actualmente disponibles como Beta.

Agregadas APIs de mutación para licencias de ancho de banda del sitio - 11 agosto de 2025

Modificar: Nueva API

Título de la Característica: Soporte de API para gestionar licencias de ancho de banda del sitio

  • Utilice las siguientes APIs para asignar, reemplazar, actualizar y eliminar licencias de sitio a través de API para licencias individuales y agrupadas

    • APIs de mutación: 

      • assignSiteBwLicense - asigna una Licencia a un Sitio

      • updateSiteBwLicense - para Licencias Agrupadas, actualiza el Ancho de Banda de un Sitio

      • replaceSiteBwLicense - reemplaza la Licencia del Sitio sin tiempo de inactividad

      • removeSiteBwLicense - elimina una Licencia de un Sitio

Estas APIs están actualmente disponibles como Beta.

Agregadas APIs de consulta para catálogo de aplicaciones y tipos de contenido DLP - 19 mayo de 2025

Modificar: Nueva API

Título de la Característica: Soporte de API para consultar Tipos de Contenido de Catálogo de Aplicaciones y DLP

  • Catálogo de Aplicaciones - Consulta los datos de aplicaciones, incluyendo Cumplimiento, Seguridad y Actividades CASB:

    • catalogApplicationList - Todas las Aplicaciones y Datos

    • catalogApplication - Aplicación única

  • Contenido DLP - Consulta los tipos de contenido para la regla de Protección de Datos Inline de DLP

    • contentTypeGroupList

Estas APIs están actualmente disponibles como Beta.

Agregada API de mutación para vSocket secundario de HA - 2 marzo de 2025

Modificar: Nueva API

Título de la Característica: Soporte de API para vSocket secundario en configuraciones de HA

  • Utiliza los siguientes APIs para establecer veredictos de historias, cambiar el estado y agregar comentarios

    • APIs de mutación: 

      • addSecondaryAwsVSocketInput Para AWS vSocket con configuración HA, agregar un vSocket secundario

      • AddSecondaryAzureVSocketInput Para AWS vSocket con configuración HA, agregar un vSocket secundario

Estas APIs están actualmente disponibles como Beta.

Agregada API de mutación XDR - 12 enero de 2025

Modificar: Nueva API

Título de la Característica: Soporte de API para historias y comentarios XDR

  • Utiliza los siguientes APIs para establecer veredictos de historias, cambiar el estado y agregar comentarios

    • APIs de mutación: 

      • addStoryComment Publica comentarios que ayudan a hacer el seguimiento de la investigación de la historia

      • analystFeedback Gestiona Acciones de historia, como el Veredicto de la historia, Tipo, y Clasificación.

      • deleteStoryComment Elimina un comentario publicado previamente usando el ID del comentario

Esta API está disponible actualmente como Beta.

Ancho de Banda de Última Milla Compatible con Kbps - 12 Ene, 2025

Cambio: Mejora para APIs

Título de la Característica: Establecer valores de ancho de banda del sitio que incluyan un decimal (por ejemplo, 1.5 Mbps) para mayor precisión granular

  • Utiliza los siguientes APIs para establecer veredictos de historias, cambiar el estado y agregar comentarios

    • Tipos impactados por API: 

      • LastMileBwInput 

      • InterfaceInfo 

      • SocketInterfaceBandwidthInput 

Estos tipos de API están disponibles actualmente como Beta.

Cambios a accountSnapshot y accountMetrics para Sitios IPsec IKEv2 - 12 Ene, 2025

Cambio: Actualización del valor de Primary a Primary 1

Título de la Característica: Soporte de API para sitios IPsec IKEv2

El valor recuperado del campo InterfaceId en las consultas accountSnapshot y accountMetrics está cambiando con la liberación gradual del soporte para configuraciones Activo/Activo el 12 de enero de 2025.

Valor Antiguo

Nuevo Valor

Notas

Primario

Primario1

Este cambio nos permite soportar más de un túnel primario

Nuevo API de Peering BGP - 23 Dic, 2024

Modificar: Nueva API

Título de la Característica: Soporte de API para Peering BGP

  • Utiliza los siguientes APIs para simplificar la configuración y la monitorización de pares BGP para sitios

    • APIs de mutación: 

      • addBgpPeer Agrega un nuevo par BGP a un sitio

      • updateBgpPeer Actualiza configuraciones para una configuración de par BGP existente

      • removeBgpPeer Elimina una configuración de par BGP para un sitio

    • APIs de Consulta: 

      • bgpPeer Recupera información sobre un par BGP específico

      • siteBgpStatus Muestra el estado actual de BGP, incluyendo detalles de sesión e información de ruta

Esta API está disponible actualmente como Beta.