콘텐츠 API
Content API (REST / GraphQL)
헤드리스 CMS 저장소에서 프론트엔드로 콘텐츠 데이터를 JSON 규격으로 전송하는 인터페이스
백엔드와 프론트엔드가 독립된 레이어로 분리되어 API로만 통신하는 소프트웨어 구조입니다. 정의와 상세 설명을 통해 기술적 원리를 이해하고, 비즈니스에 미치는 영향과 실무 적용 방법, 구현 시 고려할 주의사항을 관련 용어와 함께 확인하세요.
Decoupled Architecture
디커플드 아키텍처는 헤드리스보다 넓은 개념으로, 반드시 콘텐츠 API가 아니어도 백엔드 서비스와 프론트엔드가 네트워크 경계로 분리된 모든 구조를 포괄한다(예: 마이크로서비스 + SPA 조합). 결합도가 낮아지는 대신 인증 토큰 관리, CORS 설정, 프리뷰 모드 구현처럼 예전에는 프레임워크가 알아서 해주던 문제를 팀이 직접 설계해야 하는 트레이드오프가 생긴다. 특히 편집자가 발행 전 화면을 실시간으로 확인하는 라이브 프리뷰는 별도 인증 토큰과 draft API 엔드포인트를 구축해야 하는 대표적인 난제다.
시스템 간 결합도가 낮아 유지보수와 트래픽 스케일링에 매우 유리
인증 처리 및 실시간 미리보기(Live Preview) 파이프라인 정밀 설계 필요
Content API (REST / GraphQL)
헤드리스 CMS 저장소에서 프론트엔드로 콘텐츠 데이터를 JSON 규격으로 전송하는 인터페이스
Token
AI 모델이 텍스트를 처리할 때 사용하는 최소 언어 단위(단어 글자 서브워드 조각)
Headless Content Management System
콘텐츠 관리 백엔드와 프론트엔드 UI를 분리하고 API를 통해 콘텐츠를 서빙하는 아키텍처
JavaScript APIs and Markup
클라이언트 JS와 재사용 API 및 사전 빌드된 마크업으로 웹을 구성하는 아키텍처
Static Site Generation
빌드 타임에 모든 페이지의 HTML CSS JS를 미리 렌더링해 정적 파일로 생성하는 방식
Server-Side Rendering
요청이 들어올 때마다 서버에서 동적으로 HTML을 실시간 생성하여 브라우저에 전달하는 방식