--- title: "Conectando-se à API Cato a partir do GraphQL Playground" slug: "connecting-to-the-cato-api-from-the-graphql-playground" updated: 2026-07-30T01:43:13Z published: 2026-07-30T01:43:13Z canonical: "knowledge.catonetworks.com/connecting-to-the-cato-api-from-the-graphql-playground" --- > ## 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. # Conectando-se à API Cato a partir do GraphQL Playground Este artigo explica como usar o GraphQL Playground para executar algumas consultas de amostra e testar a conectividade com o endpoint da API Cato Networks. ## Visão geral do GraphQL Playground O GraphQL Playground permite executar consultas de API que são enviadas diretamente para o servidor API Cato. Softwares de consulta de API de terceiros, como Altair ou Postman, oferecem funcionalidades poderosas para executar chamadas API. No entanto, se houver um problema de conectividade com consultas de API, você pode usar o Playground para ajudar a identificar a causa do problema. ### Requisitos Para executar uma consulta de API Cato a partir do GraphQL Playground, você deve ter a chave da API para sua conta (**Recursos > Chaves API**). Para mais informações sobre as chaves API, consulte [Gerando Chaves API para a API Cato](/v1/docs/generating-api-keys-for-the-cato-api). Você precisa inserir o ID da Aplicação de Gerenciamento Cato (CMA) para sua conta nas consultas de amostra. Você pode encontrar o ID da CMA na [página de Informações da Conta](/v1/docs/viewing-the-account-info). A URL para o endpoint da API é específica para o local onde a instância da Aplicação de Gerenciamento Cato (CMA) está hospedada. Pode haver um valor de que é adicionado à URL para sua conta CMA e ao endpoint da API. - Se não houver prefixo (`cc.catonetworks.com`), use a seguinte URL: `https://api.catonetworks.com/api/v1/graphql2` - Se houver um prefixo (como `cc.us1.catonetworks.com`), então você usaria a seguinte URL: `https://api.us1.catonetworks.com/api/v1/graphql2` ## Testando a Conectividade com Consultas de API Cato de Amostra Você pode executar uma consulta de API de amostra para testar a conectividade com o servidor da API Cato. Quando o argumento `accountID` e a chave API são configurados corretamente, a consulta de API de amostra retorna os dados da conta e mostra os resultados no GraphQL Playground. Se a consulta não retornar resultados para sua conta, então pode haver um problema de conectividade com o servidor API ou o servidor pode estar fora do ar. As seguintes consultas de API de amostra podem ajudá-lo a testar a conectividade com o servidor da API Cato: - [accountMetrics](https://support.catonetworks.com/hc/article_attachments/360013398157) - [accountSnapshot](https://support.catonetworks.com/hc/article_attachments/360013489978) ## Executando uma Consulta de API de Amostra no GraphQL Playground Use um navegador da Internet para abrir o GraphQL Playground para a API Cato. Configure o cabeçalho HTTP para o Playground com sua chave API. Cole a consulta de amostra no painel à esquerda e insira o ID da sua conta. Então você pode executar a consulta e ver os resultados no Playground. 1. Baixe uma das consultas de API de amostra deste artigo e abra o arquivo em um editor de texto, como o Notepad. 2. A partir de um navegador da Internet, vá para o GraphQL Playground para a API Cato. 3. Na parte inferior do painel à esquerda, clique em **HTTP HEADERS**. 4. Insira sua chave API neste formato: `{ "x-api-key" :"<chave API>" }`. A captura de tela a seguir mostra o cabeçalho HTTP configurado com a chave API**AaBbCcDdEeFf0123456789ABCDEF1234**: ![graphql1.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809308787229.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A44%3A34Z&se=2026-11-19T07%3A44%3A34Z&sr=b&sp=r&sig=FK9PBVQ7RbjaCxZOk6gy1sn50Vjl2wlJSJJGqAGuBqU%3D) 5. Copie e cole uma das consultas de amostra no painel à esquerda do Playground. 6. No topo da consulta, no argumento `accountID`, insira o ID da sua conta. A captura de tela a seguir mostra o argumento `accountID` configurado com o valor 2626: ![graphql2.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809288265885.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A44%3A34Z&se=2026-11-19T07%3A44%3A34Z&sr=b&sp=r&sig=1r2eiIQ3JEZd2SGcMINxJ%2FAw6z8DHVXtXl5G7zQT5xk%3D) 7. Clique no botão de execução. 8. O painel à direita mostra os resultados da consulta de API. A captura de tela a seguir mostra os resultados para a consulta accountMetrics de amostra para o ID da conta 2626: ![graphql3.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809302891165.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A44%3A34Z&se=2026-11-19T07%3A44%3A34Z&sr=b&sp=r&sig=ECbjhJtxRjTel9ppyjpBN2gtMbsFSueCW5QUmZYdSbE%3D)