Este artigo fornece sugestões de resolução de problemas para erros comuns que podem ocorrer quando você usa a Cato para executar uma consulta de API com ferramentas e software de API. Por exemplo, Altair e Postman.
Problemas relacionados a scripts de API e codificação não são suportados.
Argumentos Necessários para a API
Estes são os argumentos que você deve incluir na consulta de API. Quando você remove um argumento opcional da consulta de API, o valor padrão é usado.
consulta accountMetrics
id - ID da Conta
timeframe - período de tempo dos dados que a consulta retorna
groupDevices - Para vários sites e sites com múltiplos Sockets, combine a análise em um único Socket (para valor booleano true)
consulta accountSnapshot
id - ID da Conta
Erros Comuns de GRAPHQL_PARSE_FAILED
Esta seção explica alguns exemplos comuns de mensagens de erro relacionadas ao esquema GraphQL da Cato.
Mensagem: Unexpected )
Há um parêntese extra na consulta. Frequentemente, este erro ocorre quando você não fornece um valor booleano para um argumento. Por exemplo, groupInterfaces: , em vez de groupInterfaces: true,
Mensagem: Expected Name, found <character>
O arquivo JSON não está formatado corretamente. A mensagem mostra um caractere que está relacionado ao caractere faltante ou extra. Por exemplo, Expected Name, found ( para o argumento accountSnapshot((id: 42). O formato correto para este argumento é accountSnapshot(id: 1941)
Mensagem: Expected Name, found <Invalid>
A mensagem de erro indica que há um valor inválido.
Por exemplo, o argumento timeFrame (accountMetrics) na API da Cato usa aspas para o padrão de data e hora ISO 8601, timeFrame: "last.P1D" está correto e timeFrame: last.P1D produz este erro.
Erros Comuns de GRAPH_QL_VALIDATION_FAILED
Esta seção explica alguns exemplos comuns de mensagens de erro relacionadas ao formato incorreto de argumentos na consulta.
Mensagem: Expected type String!, found <number>
A mensagem de erro indica que um argumento tem um valor inválido, geralmente relacionado ao formato do argumento.
Por exemplo, o argumento sites ids (accountMetrics > sites) é uma STRING, então você deve usar aspas para o valor, ids: ["4242"] está correto e ids:[4242] produz este erro.
Mensagem: Expected type Int!, found \"<number>\"
A mensagem de erro indica que um argumento tem um valor inválido, geralmente relacionado ao formato do argumento.
Por exemplo, o argumento sites ids (accountSnapshot > sites) é um INT, então você NÃO deve usar aspas para o valor, ids: [2626] está correto e ids:["2626"] produz este erro.
Mensagens de Erro da API
Esta seção explica mensagens de erro comuns que não estão especificamente relacionadas ao esquema GraphQL ou ao formato da Cato.
Mensagem: erro de autenticação ou 403
Há um problema com a chave da API para sua conta. Soluções sugeridas:
No Aplicativo de Gerenciamento Cato (Sistema > Gerenciamento de Acesso API), certifique-se de que:
A chave de API que você está usando ainda é válida (existe e não expirou)
Se a opção Permitir acesso de IPs estiver configurada, o cliente de API está fazendo a chamada de um endereço IP ou intervalo específico permitido
Confirme que a chave está configurada corretamente nas configurações de cabeçalho HTTP para o software de consulta API:
x-api-key: <valor da chave>, por exemplo,x-api-key: abcdef12345Se o problema continuar, gere uma nova chave de API e adicione-a ao software de consulta API
Este é um exemplo de cabeçalho HTTP válido para o Cliente 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: abcdef123456789Mensagem: não é possível separar dispositivos (groupDevices = false) quando múltiplos sites são selecionados
O valor para o argumento groupDevices (accountMetrics) deve ser true quando a consulta inclui múltiplos sites.
Convertendo Dados de Análise da API
A API da Cato retorna dados de tráfego em bytes. Para converter os dados em unidades maiores (como MB ou GB), você precisa dividir por valores exponenciais de 1024: 10242 para MB, e 10243 para GB.
Por exemplo, para converter 536,870,912,000 bytes em GB, divida por 10243 para mostrar 500GB de dados.