GraphQL API

GraphQL 계약 관리

클라이언트가 필요한 필드를 고를 수 있다는 장점은 스키마가 신뢰 가능할 때 빛납니다. TypeGraphQL이나 NestJS GraphQL에서도 같은 경계를 둡니다.

schema

API가 약속한 모양

Object Type, Query, Mutation, Input Type을 명확히 두어 클라이언트가 요청 가능한 필드를 알게 합니다.

resolver

필드별 실제 데이터

리졸버는 스키마 필드를 데이터베이스, 서비스, 외부 API 호출로 연결합니다.

validation

입력값 런타임 검증

타입스크립트 타입과 별개로 zod나 class-validator로 실제 요청 값을 확인합니다.

codegen

프론트 타입 공유

스키마 기반 타입 생성을 쓰면 쿼리 변경과 화면 코드의 불일치를 빨리 발견합니다.

과다 조회

필요한 필드만 요청해 응답 크기를 줄입니다.

field select
부족 조회

여러 리소스를 한 쿼리에서 묶어 왕복 횟수를 줄입니다.

single request
버전 관리

필드 추가, deprecate, 제거 순서로 클라이언트 영향을 관리합니다.

schema evolve