--- title: "Resolução de Problemas com Chamadas de API da Cato" slug: "troubleshooting-cato-api-calls" updated: 2026-07-30T01:43:09Z published: 2026-07-30T01:43:09Z canonical: "knowledge.catonetworks.com/troubleshooting-cato-api-calls" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Resolução de Problemas com Chamadas de API da Cato 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 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 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 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 \"\" 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: abcdef12345` - Se 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: ```plaintext 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 ``` ### Mensagem: 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.