--- title: "GraphQLプレイグラウンドからCato APIへの接続" slug: "connecting-to-the-cato-api-from-the-graphql-playground" updated: 2026-07-30T01:21:20Z published: 2026-07-30T01:21:20Z 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. # GraphQLプレイグラウンドからCato APIへの接続 この記事では、いくつかのサンプルクエリを実行し、Cato Networks APIエンドポイントへの接続をテストするためにGraphQL プレイグラウンドを使用する方法を説明します。 ## GraphQL プレイグラウンドの概要 GraphQL プレイグラウンドでは、Cato API サーバーに直接送信されるAPI クエリを実行できます。 AltairやPostmanなどのサードパーティ製API クエリソフトウェアは、API呼び出しを実行するための強力な機能を提供します。 しかし、API クエリで接続の問題が発生した場合は、プレイグラウンドを使用して問題の原因を特定するのに役立ちます。 ### 前提条件 GraphQL プレイグラウンドからCato API クエリを実行するには、アカウント用のAPI キーが必要です（**リソース > API キー**）。 API キーについて詳しくは、「[Cato API用API キーの生成](/v1/docs/generating-api-keys-for-the-cato-api)」をご覧ください。 サンプルクエリにはアカウントのCato Management Application (CMA) IDを入力する必要があります。 [アカウント情報ページ](/v1/docs/viewing-the-account-info)でCMA IDを見つけることができます。 APIエンドポイントのURLは、Cato Management Application (CMA)インスタンスがホストされている場所に特有です。 あなたのCMAアカウントとAPIエンドポイント用のURLに追加される可能性のある 値があります。 - プレフィックス（`cc.catonetworks.com`）がない場合、次のURLを使用してください：`https://api.catonetworks.com/api/v1/graphql2` - プレフィックス（例：`cc.us1.catonetworks.com`）がある場合、次のURLを使用します：`https://api.us1.catonetworks.com/api/v1/graphql2` ## サンプルCato API クエリを使用した接続テスト Cato API サーバーへの接続をテストするために、サンプルAPI クエリを実行できます。 `accountID`引数とAPI キーが正しく設定されていると、サンプルAPI クエリがアカウントデータを返し、GraphQL プレイグラウンドに結果が表示されます。 クエリがアカウントの結果を返さない場合、API サーバーへの接続性の問題、またはサーバーがダウンしている可能性があります。 以下のサンプルAPI クエリがCato API サーバーへの接続テストに役立ちます： - [accountMetrics](https://support.catonetworks.com/hc/article_attachments/360013398157) - [accountSnapshot](https://support.catonetworks.com/hc/article_attachments/360013489978) ## GraphQL プレイグラウンドでサンプルAPI クエリを実行中 インターネットブラウザを使用して、Cato API のGraphQL プレイグラウンドを開きます。 プレイグラウンドのためのHTTP ヘッダーをAPI キーで設定します。 左側のペインにサンプルクエリを貼り付け、アカウントIDを入力してください。 その後、クエリを実行してPlaygroundで結果を見ることができます。 1. この記事からサンプルAPI クエリをダウンロードし、メモ帳などのテキストエディタでファイルを開きます。 2. インターネットブラウザからCato API 用のGraphQL プレイグラウンドへ行きます。 3. 左ペインの下部で**HTTP ヘッダー**をクリックします。 4. 次の形式でAPI キーを入力します: `{ "x-api-key" :"<api key>" }`。 以下のスクリーンショットは、APIキー**AaBbCcDdEeFf0123456789ABCDEF1234**で設定されたHTTPヘッダーを示しています： ![graphql1.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809308787229.png?sv=2026-02-06&spr=https&st=2026-11-10T16%3A50%3A12Z&se=2026-11-10T17%3A50%3A12Z&sr=c&sp=r&sig=41zaA2YArby6J3rQGfr6eja6hJS6jejqFJHnD7wBNAo%3D) 5. プレイグラウンドの左ペインにサンプルクエリをコピーして貼り付けます。 6. クエリの先頭で、`accountID`引数にあなたのアカウントIDを入力します。 以下のスクリーンショットは、値2626で設定された`accountID`引数を示しています： ![graphql2.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809288265885.png?sv=2026-02-06&spr=https&st=2026-11-10T16%3A50%3A12Z&se=2026-11-10T17%3A50%3A12Z&sr=c&sp=r&sig=41zaA2YArby6J3rQGfr6eja6hJS6jejqFJHnD7wBNAo%3D) 7. 再生ボタンをクリックします。 8. 右ペインにAPI クエリの結果が表示されます。 下記のスクリーンショットは、アカウントID 2626のためのサンプルaccountMetricsクエリの結果を示しています： ![graphql3.png](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/24809302891165.png?sv=2026-02-06&spr=https&st=2026-11-10T16%3A50%3A12Z&se=2026-11-10T17%3A50%3A12Z&sr=c&sp=r&sig=41zaA2YArby6J3rQGfr6eja6hJS6jejqFJHnD7wBNAo%3D)