Cet article sert de plateforme pour les notifications concernant les modifications récentes et prévues du schéma API GraphQL de Cato. Il contient des nouvelles et des mises à jour mettant en avant de nouvelles fonctionnalités, telles que des API et des outils d'automatisation récemment publiés.
Pour des informations sur les modifications qui pourraient vous obliger à mettre à jour votre client API, consultez Cato API Potentially Breaking Changes and EoL.
Les termes de l'API utilisées dans cet article sont expliqués dans Quoi est l'API Cato.
Pour tous les clients utilisant l'API Cato, nous vous recommandons de cliquer sur Suivre pour recevoir automatiquement des notifications par e-mail pour les mises à jour de cet article concernant les changements apportés à l'API.
Pour plus d'informations sur les API, consultez le Cato Networks GraphQL API Reference.
Nouvelles et mises à jour
Actions Utilisateur Supplémentaires
Modification : API Mis à jour
Titre Fonctionnalité : Administration simplifiée des utilisateurs via des flux de travail externes et des systèmes de gestion d'identité
L' API soutient l'activation des utilisateurs (enableUser) et la désactivation des utilisateurs (disableUser).
Analyses améliorées pour les résultats de l'API AppStats groupés - 21 juin 2026
Titre de la fonctionnalité : Analyses améliorées pour les résultats de l'API AppStats et Événements groupés
Lors de la requête de données API AppStats ou Événements et de leur classification par dimension, telle que le pays ou le type d'appareil, vous avez la possibilité d'afficher les enregistrements sans valeur pour cette dimension comme un groupe vide. Cela permet de garantir des totaux cohérents dans les requêtes API et affiche les données précédemment cachées dans les tableaux de bord et rapports CMA.
Nouveau paramètre booléen au niveau de la requête :
IncludeEmptyDimension, aucun impact sur les scripts API existantsS'applique aux requêtes API et aux données affichées dans le CMA
Champs ajoutés pour appStats API pour Clients DEM - 19 Avril 2026
Modification : API mis à jour
Titre de la Fonctionnalité : Mises à jour de l'API appStats pour les métriques de l'expérience application
Les nouveaux champs suivants pour l'API appStats sont disponibles pour les mesures de l'expérience des applications afin de permettre un accès programmatique aux données de performance des utilisateurs, des hôtes et des applications.
experience_score_level- Indicateur de score d'expérience agrégéttfb- Temps jusqu'au premier octet, mesure de la réactivité du serveurtls_latency- Temps pour établir la connexion TLStcp_latency- Temps de configuration de la connexion TCPhttp_latency- Latence de la requête HTTP de bout en bouthttp_error_rate- Taux d'erreurs HTTP observées
Note : Ces champs sont disponibles uniquement pour les clients disposant d'une licence DEM.
Mutations API ajoutées pour Webhooks, Listes de diffusion, et Groupes d'abonnement - 29 Mars 2026
Modification : Nouvelle API
Titre de la fonctionnalité : Support API pour la gestion des webhooks, listes de diffusion, et groupes d'abonnement
Utilisez les API suivantes pour assigner, remplacer, mettre à jour et supprimer des licences de site via API pour les licences uniques et groupées
Gérez les intégrations de webhooks en utilisant
createWebhook,updateWebhook,deleteWebhook,webhook,webhookList, ettestWebhookGérez les listes de diffusion en utilisant
createMailingList,updateMailingList,deleteMailingList,mailingList, etmailingListListCombinez les webhooks et les listes de diffusion dans les 'groupes d'abonnement en utilisant'
createSubscriptionGroup,updateSubscriptionGroup,deleteSubscriptionGroup,subscriptionGroup, etsubscriptionGroupList
Pour les détails sur la gestion des notifications dans le CMA, consultez les articles de la Notifications KB
Actualités précédentes des API et mises à jour
Mises à jour des API de politique de tunnel fractionné - Jan 18, 2026
Modification : API mis à jour
Titre de la fonctionnalité : Mises à jour des mutations de la politique de tunnel fractionné
Les API suivantes ont été modifiées pour s'aligner plus précisément avec le comportement de la fonctionnalité dans l'application de gestion Cato.
Ces modifications s'appliquent à toutes les mutations de la politique de tunnel fractionné :
Exclude- changé en RouteAllToCatoExceptInclude- changé en RouteOnlySelectedCoverage- changé en ConnectionModednsExclusion- changé en dnsSuffix
Ces APIs sont actuellement disponibles en version bêta.
Mutations API ajoutées pour Licences de bande passante de site - 11 Août 2025
Modification : Nouvelle API
Titre de la Fonctionnalité : Support API pour la gestion des licences de bande passante de site
Utilisez les API suivantes pour assigner, remplacer, mettre à jour et supprimer des licences de site via API pour les licences uniques et groupées
Mutations APIs :
assignSiteBwLicense- assigne une licence à un siteupdateSiteBwLicense- pour les licences groupées, met à jour la bande passante d'un sitereplaceSiteBwLicense- remplace la licence du site sans temps d'arrêtremoveSiteBwLicense- retire une licence d'un site
Ces APIs sont actuellement disponibles en version bêta.
APIs de requête ajoutées pour Catalogue d'applications et Types de contenu DLP - 19 Mai 2025
Modification : Nouvelle API
Titre de la Fonctionnalité : Support API pour interroger le Catalogue d'Applications et les Types de Contenu DLP
Catalogue d'Applications - Interrogez les données des applications, y compris la conformité, la sécurité et les activités CASB :
catalogApplicationList- Toutes les applications et donnéescatalogApplication- Application unique
Contenu DLP - Interrogez les types de contenu pour la règle de Protection des Données Inline DLP
contentTypeGroupList
Ces APIs sont actuellement disponibles en version bêta.
Mutations API ajoutées pour HA vSocket secondaire - 2 Mars 2025
Modification : Nouvelle API
Titre de la Fonctionnalité : Support API pour le vSocket secondaire pour les configurations HA
Utilisez les APIs suivantes pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires
Mutations APIs :
addSecondaryAwsVSocketInputPour AWS vSocket avec une configuration HA, ajoutez un vSocket secondaireAddSecondaryAzureVSocketInputPour AWS vSocket avec une configuration HA, ajoutez un vSocket secondaire
Ces APIs sont actuellement disponibles en version bêta.
Mutation API XDR ajoutée - 12 Janvier 2025
Modification : Nouvelle API
Titre de la Fonctionnalité : Support API pour les histoires et commentaires XDR
Utilisez les APIs suivantes pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires
Mutations APIs :
addStoryCommentPubliez des commentaires qui aident à suivre l'enquête sur l'histoireanalystFeedbackGérer les actions de l'histoire, telles que le verdict de l'histoire, le type et la classification.deleteStoryCommentSupprimez un commentaire précédemment publié en utilisant l'ID du commentaire
Cette API est actuellement disponible en version Bêta.
La bande passante du dernier kilomètre prend en charge les Kbps - Jan 12, 2025
Changement : Amélioration pour les API
Titre de la Fonctionnalité : Définissez les valeurs de bande passante du site incluant une décimale (par ex. 1.5 Mbps) pour une précision plus granulée
Utilisez les APIs suivantes pour définir les verdicts d'histoire, changer le statut et ajouter des commentaires
Types concernés pour les API :
LastMileBwInputInterfaceInfoSocketInterfaceBandwidthInput
Ces types d'API sont actuellement disponibles en version Bêta.
Modifications du compteSnapshot et des compteMetrics pour les sites IPsec IKEv2 - Jan 12, 2025
Changement : Mise à jour de la valeur Primary à Primary 1
Titre de la Fonctionnalité : Support API pour les sites IPsec IKEv2
La valeur récupérée du champ InterfaceId dans les requêtes accountSnapshot et accountMetrics va changer à partir de la sortie progressive du support pour les configurations Actif/Actif le 12 janvier 2025.
Ancienne Valeur | Nouvelle Valeur | Notes |
|---|---|---|
Primaire | Primaire1 | Ce changement nous permet de soutenir plusieurs tunnels principaux |
Nouvelle API de peering BGP - Dec 23, 2024
Modification : Nouvelle API
Titre de la Fonctionnalité : Support API pour le Pair à Pair BGP
Utilisez les APIs suivantes pour simplifier la configuration et la surveillance des pairs BGP pour les sites
Mutations APIs :
addBgpPeerAjoutez un nouveau pair BGP à un siteupdateBgpPeerMettre à jour les paramètres pour une configuration de pair BGP existanteremoveBgpPeerSupprimez une configuration de pair BGP pour un site
APIs de Requête :
bgpPeerRécupérer des informations sur un pair BGP spécifiquesiteBgpStatusAfficher le statut BGP actuel, y compris les détails de la session et les informations de routage
Cette API est actuellement disponible en version Bêta.