Cet article fournit des suggestions de dépannage pour les erreurs courantes qui peuvent survenir lorsque vous utilisez Cato pour exécuter une requête API avec des outils et logiciels API. Par exemple, Altair et Postman.
Les problèmes liés aux scripts API et à la programmation ne sont pas pris en charge.
Ce sont les arguments que vous devez inclure dans la requête API. Lorsque vous retirez un argument optionnel de la requête API, la valeur par défaut est utilisée.
-
requête accountMetrics
-
id - ID de compte
-
timeframe - période de données que la requête renvoie
-
groupDevices - Pour plusieurs sites, et sites avec plusieurs Sockets, combinez les analyses en un seul Socket (pour la valeur booléenne true)
-
-
requête accountSnapshot
-
id - ID de compte
-
Cette section explique quelques exemples courants de messages d'erreur liés au schéma GraphQL de Cato.
Il y a une parenthèse supplémentaire dans la requête. Souvent, cette erreur est causée lorsque vous ne fournissez pas de valeur booléenne pour un argument. Par exemple, groupInterfaces: , au lieu de groupInterfaces: true,
Le fichier JSON n'est pas correctement formaté. Le message montre un caractère qui est lié au caractère manquant ou supplémentaire. Par exemple, Nom attendu, trouvé ( pour l'argument accountSnapshot((id: 42). Le format correct pour cet argument est accountSnapshot(id: 1941)
Le message d'erreur indique qu'il y a une valeur invalide.
Par exemple, l'argument timeFrame (accountMetrics) dans l'API Cato utilise des guillemets pour la norme de date et d'heure ISO 8601, timeFrame: "last.P1D" est correct et timeFrame: last.P1D produit cette erreur.
Cette section explique quelques exemples courants de messages d'erreur liés au format incorrect des arguments dans la requête.
Le message d'erreur indique qu'un argument a une valeur invalide, généralement liée au format de l'argument.
Par exemple, l'argument sites ids (accountMetrics > sites) est une CHAÎNE, vous devez donc utiliser des guillemets pour la valeur, ids: ["4242"] est correct et ids:[4242] produit cette erreur.
Le message d'erreur indique qu'un argument a une valeur invalide, généralement liée au format de l'argument.
Par exemple, l'argument sites ids (accountSnapshot > sites) est un INT, vous ne devez donc PAS utiliser de guillemets pour la valeur, ids: [2626] est correct et ids:["2626"] produit cette erreur.
Cette section explique les messages d'erreur courants qui ne sont pas spécifiquement liés au schéma ou au format GraphQL de Cato.
Il y a un problème avec la clé API de votre compte. Solutions suggérées :
-
Dans l'Application de gestion Cato (Système > Gestion de l'accès API), assurez-vous que :
-
La clé API que vous utilisez est toujours valide (elle existe et n'a pas expiré)
- Si l'option Autoriser l'accès à partir d'IPs est définie, le client API effectue l'appel à partir d'une adresse IP ou d'une plage IP autorisée spécifique
-
-
Confirmez que la clé est configurée correctement dans les paramètres d'en-tête HTTP pour le logiciel de requête API :
x-api-key: <key value>, par exemple,x-api-key: abcdef12345 -
Si le problème persiste, générez une nouvelle clé API et ajoutez-la au logiciel de requête API
Voici un exemple d'en-tête HTTP valide pour le client API :
POST /api/v1/graphql2 HTTP/2 Host: api.catonetworks.com User-Agent: curl/8.7.1 Accept: */* Content-Type:application/json x-api-key: abcdef123456789
L'API de Cato renvoie les données de trafic en octets. Pour convertir les données en unités plus grandes (telles que MB ou GB), vous devez diviser par des valeurs exponentielles de 1024 : 10242 pour MB, et 10243 pour GB.
Par exemple, pour convertir 536,870,912,000 octets en Go, divisez par 10243 pour afficher 500 Go de données.
0 commentaire
Vous devez vous connecter pour laisser un commentaire.