はじめに

先日、実務で初めて触れたGraphQLについて、キャッチアップした内容をまとめておきます！

目次

GraphQLは「APIのクエリ言語（Query Language）」です。
簡単に言うと、「欲しいデータだけを指定して取得できる仕組み」

普通のAPI（REST API）だと、サーバーが決めたデータがそのまま返ってくるけど、GraphQLならクライアント（フロントエンド）が「このデータだけ欲しい！」と細かく指定できる。

2012年に主に3つの理由からFacebookが開発！

REST APIだと「全部入りのデータ」が返ってくることが多い。

でも、スマホアプリとかだと「一部のデータだけ欲しい」のに、無駄にデータを取ることになってしまう。

例えば「ユーザー情報＋その投稿一覧」が欲しいとき、REST APIだと「ユーザー情報API → 投稿一覧API」と2回リクエストすることが多い。

REST APIは「ユーザー情報用」「投稿一覧用」など、用途ごとにAPIを作るから、エンドポイントがその分増える。

💡 GraphQLなら「/graphql」みたいに1つのエンドポイントだけでOK！

GraphQLには3つの主要な操作がある！

例えば「ユーザーの名前とメールアドレスが欲しい！」

query {
  user(id: 1) {
    name
    email
  }
}

💡 必要なデータだけ取れる！

例えば「新しい投稿を作成する」

mutation {
  createPost(title: "GraphQL最高！", content: "RESTより便利") {
    id
    title
  }
}

💡 データを変更するリクエスト

WebSocketを使って、データの更新をリアルタイムに取得できる

例えば「新しいコメントが投稿されたら即座に通知」

subscription {
  newComment(postId: 1) {
    id
    content
    author {
      name
    }
  }
}

💡 チャットアプリや通知系の機能でめっちゃ便利！

GraphQLはめっちゃ多くの企業で使われてる！