Content API (REST / GraphQL)
콘텐츠 API
핵심 정의 및 원리TERM #8
헤드리스 CMS 저장소에서 프론트엔드로 콘텐츠 데이터를 JSON 규격으로 전송하는 인터페이스
BUSINESS IMPACT실무 적용 및 비즈니스 영향
필요 필드만 선별 요청(GraphQL)하거나 엔드포인트 캐싱(REST)으로 페이로드 최소화
IMPLEMENTATION구현 가이드 및 주의사항
REST의 Over-fetching 문제 및 GraphQL의 복잡한 백엔드 쿼리 부하 관리 필요
ARCHITECTURAL DEEP DIVE
심층 분석 및 아키텍처 원리
REST API는 엔드포인트마다 고정된 필드 구성을 반환해 캐싱이 쉬운 대신 필요 없는 데이터까지 함께 오는 Over-fetching이 흔하고, GraphQL은 클라이언트가 필요한 필드만 쿼리로 명시해 페이로드를 최소화할 수 있지만 서버가 매 쿼리를 해석해야 해 캐싱 전략이 더 복잡하다. 대규모 헤드리스 CMS(Contentful, Sanity 등)는 대부분 두 방식을 함께 제공해 팀이 상황에 맞게 선택하도록 한다. 실무에서는 목록 페이지는 REST로 빠르게 캐싱하고, 복잡한 상세 페이지는 GraphQL로 필요한 필드만 정밀하게 가져오는 하이브리드 전략이 자주 쓰인다.