GraphQL

GraphQLとは？

GraphQLは、FacebookがRESTの課題を解決するために開発したAPIのクエリ言語・ランタイムです。2015年にオープンソース化され、現在はGraphQL Foundationが管理しています。

RESTとの主な違い

項目	REST API	GraphQL
エンドポイント	リソースごとに複数	通常1つ（/graphql）
データ取得	サーバーが決める	クライアントが指定
オーバーフェッチ	起きやすい	起きない
アンダーフェッチ	複数リクエストが必要	1リクエストで完結
型システム	なし（OpenAPIで補完）	スキーマで型定義必須

GraphQLクエリの例

query {
  user(id: "1") {
    name
    email
    posts {
      title
      publishedAt
    }
  }
}

必要なフィールドだけを指定して取得できます。

主な実装

種別	代表的なライブラリ
クライアント	Apollo Client, urql
サーバー（Node.js）	Apollo Server, Pothos, Nexus
スキーマファースト	graphql-tools

まとめ

GraphQLは複雑なデータ要件を持つアプリに有効ですが、単純なCRUDにはREST APIの方がシンプルです。BFFパターン（Backend for Frontend）でGraphQLを採用するケースが増えています。