{"meta":{"title":"GraphQL クライアントの使用","intro":"さまざまな GraphQL クライアントとライブラリを使って、実際の GitHub データに対してクエリを実行できます。","product":"GraphQL API","breadcrumbs":[{"href":"/ja/graphql","title":"GraphQL API"},{"href":"/ja/graphql/guides","title":"ガイド"},{"href":"/ja/graphql/guides/using-graphql-clients","title":"GraphQL クライアントの使用"}],"documentType":"article"},"body":"# GraphQL クライアントの使用\n\nさまざまな GraphQL クライアントとライブラリを使って、実際の GitHub データに対してクエリを実行できます。\n\n> \\[!WARNING]\n> GraphQL エクスプローラーは、2025 年 11 月 11 日にドキュメントから削除されました。\n> [changelog のお知らせ](https://github.blog/changelog/2025-11-07-graphql-explorer-removal-from-api-documentation-on-november-7-2025)をご覧ください。\n\n## GraphQL クライアント IDE の使用\n\nGitHub の GraphQL API にアクセスするために使用できるオープンソースのクライアントIDEが多数あります。\n\nHTTP メソッド、認証> GraphQL 呼び出し構造の詳細については、[GraphQLでの呼び出しの作成](/ja/graphql/guides/forming-calls-with-graphql) を参照してください。\n\nまず、クライアントを選びます。 一般的な選択肢として、GraphiQL、Insomnia、Altair (デスクトップ/Web/拡張機能) などがあります。 詳細なクライアント一覧については、[GraphQL organization のツール ディレクトリ](https://graphql.org/community/tools-and-libraries/?tags=services)に関するページを参照してください。\n\n次の汎用的な手順は、ほとんどの GraphQL クライアントで利用できます。\n\n1. クライアントの接続先として GraphQL エンドポイント `https://api.github.com/graphql` を指定します。\n\n2. `Authorization` ヘッダー `Authorization: Bearer TOKEN` を追加します (`TOKEN` を GitHub personal access token に置き換えてください)。 詳細については、[個人用アクセス トークンを管理する](/ja/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens)) を参照してください。\n\n3. 要求メソッドを `POST` に設定するか、利用できる場合はクライアントが提供する GraphQL モードを使います。\n\n4. エディターにクエリまたはミューテーションを入力し、必要に応じて \\[Variables] パネルに変数を指定します。\n\n   例:\n\n   ```graphql\n   query {\n     viewer {\n       login\n     }\n   }\n   ```\n\n5. クライアントでドキュメントのレンダリングやオートコンプリートを行うためにスキーマが必要な場合は、GraphQL イントロスペクション クエリを介してフェッチします。 多くのクライアントは、\\[Docs] パネルからこれを自動的に実行できます。\n\n   最小限のイントロスペクション クエリ:\n\n   ```graphql\n   query IntrospectionQuery {\n     __schema {\n       types {\n         name\n       }\n     }\n   }\n   ```\n\n6. 要求を実行し、JSON 応答を確認します。 例のクエリを実行すると、認証に使った GitHub personal access token に関連付けられたログインが返されるはずです。\n\nこのクライアント UI を使って、必要に応じてドキュメントの確認、クエリの実行、要求の保存を行います。\n\n## GitHub CLI\n\nGitHub CLI を使うと、コマンド ラインから GraphQL クエリを実行することもできます。\n\n1. [GitHub CLI をインストールし、認証を行います](https://cli.github.com/manual/gh_auth_login)。\n2. `https://api.github.com/graphql`で GraphQL エンドポイントを使用して、`gh api` に対してクエリを実行します。\n\n例:\n\n```shell\ngh api graphql -f query='query { viewer { login } }'\n```\n\nこのクエリを実行すると、認証に使った GitHub personal access token に関連付けられたログインが返されるはずです。\n\n## サポートのリクエスト\n\nGitHub Apps、OAuth apps、API 開発に関する疑問、バグ レポート、ディスカッションについては、[GitHub のコミュニティ ディスカッションの API と Webhook カテゴリ](https://github.com/orgs/community/discussions/categories/api-and-webhooks) を調べてください。 ディスカッションは、GitHub スタッフによって管理および維持され、GitHub コミュニティによって回答されます。\n\n次の場合は、お問い合わせフォームを使用して [GitHub サポート](https://support.github.com/)に直接連絡することを検討してください。\n\n* GitHub のスタッフからの確実なレスポンス\n* 機密データや個人的な心配に関連するサポート リクエスト\n* 機能に関する要求\n* GitHub の製品に関するフィードバック"}