Skip to main content

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2023-01-18. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise にアップグレードします。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせく� さい

GraphQL APIについて

GitHubのGraphQL APIは、柔軟性と、フェッチしたいデータを正確に定義できる機能を提供します。

概要

以下は、GraphQL APIを使い始めるためのクイックリンクです。

GraphQLについて

GraphQL データ クエリ言語は次のとおりです。

  • 仕様です。 仕様によって、API サーバー上の スキーマ の有効性が決まります。 スキーマは、クライアントの呼び出しの正当性を決定します。

  • 厳密に型指定されます。 スキーマによって、API の型システ� とすべてのオブジェクト リレーションシップが定義されます。

  • 内省的です。 クライアントはスキーマに対してクエリを実行して、スキーマの詳細を確認できます。

  • 階層構� です。 GraphQL 呼び出しの構� は、返される JSON データの構� を反� しています。 入れ子になったフィールドを使用すると、1 回のラウンド トリップで指定したデータのみをクエリおよび受信できます。

  • アプリケーション レイヤーです。 GraphQL は、ストレージ モデルまたはデータベース クエリ言語ではありません。 graph は、スキーマで定義されたグラフ構� を指します。ノードでオブジェクトが定義され、エッジでオブジェクト間のリレーションシップが定義されます。 APIは、データがどのように保存されているかに関係なく、スキーマ定義に従ってアプリケーションデータをトラバースして返します。

GitHubがGraphQLを使う理由

GitHubは、インテグレーターにとって大きな柔軟性を提供してくれることから、GraphQLを選択しました。 必要—なデータを正確に定義する機能と、必要 なデータ のみを—定義できることは、従来の REST API エンドポイントよりも強力な利点です。 GraphQL を使用すると、複数の REST 要求を 1 回の呼び出しに 置き換えて、指定したデータをフェッチできます。

GitHub が GraphQL に投資した理由の詳細については、元のお知らせブログ記事をご覧く� さい。

GraphQLのスキーマ参照について

サイドバーのドキュメントは、GitHub GraphQL スキーマから生成されます。 すべての呼び出しは、このスキーマに対して検証され、実行されます。 以下のドキュメントを使って、呼び出せるデータを見つけてく� さい。

この同じコンテンツには、Explorer のドキュメントのサイドバーからアクセスできます。 GraphQL APIの呼び出しをうまく行うためには、ドキュメントとスキーマ検証の両方に依存しなければならないことがあります。

認証やレート制限の詳細など、その他の情� �については「ガイド」を参照してく� さい。

サポートのリクエスト

GitHub Apps、OAuth Apps、および API 開発に関する疑問、バグ レポート、議論については、 を調べてく� さい。 このディスカッションは GitHub のスタッフによって進行および管理されていますが、フォーラ� に投稿された質問に GitHub のスタッフが必ずしも返答するとは限りません。

次の� �合は、お問い合わせフォー� を使用して GitHub サポートに直接連絡することを検討してく� さい。

  • GitHub Enterprise Serverのスタッフからの反応を確実に得たい� �合
  • センシティブなデータやプライベートな懸念事� �に関わるサポートリクエスト
  • 機能リクエスト
  • GitHub Enterprise Serverの製品に関するフィードバック