REST의 Over-fetching과 N+1 문제를 해결하는 Strongly Typed Schema 기반의 단일 엔드포인트 설계

Context

REST 아키텍처의 고정된 페이로드 구조로 인한 Over-fetching 및 Under-fetching 발생. 클라이언트 요구사항 변경에 따른 엔드포인트 증식과 버전 관리의 복잡성 증가로 인한 유지보수 효율성 저하.

Technical Solution

• Schema Definition Language(SDL)를 통한 강타입 계약 기반의 API 인터페이스 정의
• Client-driven Data Fetching 구조를 채택하여 요청한 필드만 반환하는 정밀한 데이터 제어 구현
• 단일 엔드포인트 내에서 Graph Traversal 방식을 통해 여러 리소스를 한 번의 Round-trip으로 통합 조회
• Resolver 함수 기반의 Coordination Layer 설계를 통한 PostgreSQL, gRPC, Redis 등 이기종 데이터 소스의 추상화
• 버전 관리 대신 필드 추가 및 Deprecation 메타데이터를 활용한 가산적(Additive) 스키마 진화 전략 적용
• Fragment Colocation 및 Codegen 도입을 통한 프론트엔드-백엔드 간 타입 동기화 및 개발 경험 최적화