GraphQL

탄생 배경 — REST API의 한계

• 사용자 이름

• 사용자가 작성한 게시글 목록

• 각 게시글에 달린 댓글 수

1. /users/1 → 이름을 포함한 사용자 전체 정보

2. /users/1/posts → 게시글 목록

3. 각 게시글마다 /posts/:id/comments → 댓글 수

GraphQL의 핵심 개념

{
  user(id: 1) {
    name
    posts {
      title
      commentCount
    }
  }
}

{
  "data": {
    "user": {
      "name": "Lucas",
      "posts": [
        { "title": "GraphQL", "commentCount": 12 },
        { "title": "REST API vs GraphQL", "commentCount": 5 }
      ]
    }
  }
}

스키마 (Schema)

type User {
  id: ID!
  name: String!
  posts: [Post!]!
}

type Post {
  id: ID!
  title: String!
  commentCount: Int!
}

type Query {
  user(id: ID!): User
}

REST와의 차이

Mutation

mutation {
  createPost(input: { title: "새 글", userId: 1 }) {
    id
    title
  }
}

{
  "data": {
    "createPost": {
      "id": 42,
      "title": "새 글"
    }
  }
}

단점

• 엔드포인트가 하나뿐이기 때문에 캐싱 구현이 어렵다.

• 데이터 쿼리 작업을 처리하기 위한 서버 복잡도가 높아진다.

• 단순한 API엔 오히려 과한 선택일 수 있다.