GraphQL API로 구조화된 콘텐츠의 대규모 전달

REST API는 여러 서버 호출이나 과도한 데이터 페이로드로 애플리케이션 성능을 떨어뜨리고 개발을 복잡하게 만들기도 합니다. 이러한 문제는 Experience Manager Sites가 기본으로 제공하는 GraphQL API로 해결이 가능합니다. 프런트엔드 팀은 한 번의 요청으로 필요한 콘텐츠를 정확하게 쿼리할 수 있습니다.

Experience Manager Sites는 구조화된 콘텐츠 관리 기능과 최신 전달 기능이 결합된 엔터프라이즈 CMS 솔루션입니다. GraphQL 통합을 통해 경직된 엔드포인트 구조에서 벗어나 웹 사이트, 앱, 디지털 경험 전반에서 확장 가능한 고성능 콘텐츠를 전달할 수 있습니다.

컴포저블 아키텍처를 위해 설계된 Experience Manager Sites의 GraphQL API는 더 빠른 페이지 로드, 더 민첩한 개발, 그리고 진화하는 고객의 수요를 대규모로 정확하게 충족할 수 있는 유연성까지 제공합니다.

Experience Manager의 GraphQL API는 콘텐츠 조각과 같은 구조화된 콘텐츠가 모든 디지털 채널에 헤드리스 방식으로 전달되도록 설계되었습니다. 유연한 단일 엔드포인트 역할을 하는 이 API를 통해 클라이언트 애플리케이션은 필요한 콘텐츠를 필요한 순간에 정확하게 가져올 수 있습니다.

이 그래프 기반의 최신 접근 방식은 REST 방식보다 더 많은 이점을 제공합니다.

• 효율성. 여러 엔드포인트를 연결하지 않아도 됩니다. 한 번의 API 호출로 복잡하고 중첩된 콘텐츠 구조까지 검색할 수 있습니다. 이를 통해 개발이 간소화되고 페이지 로드도 빨라집니다.
• 정확성. 개발자는 필요한 필드만 정확하게 지정하여 쿼리할 수 있습니다. 이를 통해 페이로드를 줄이고 성능을 개선할 수 있습니다. 특히 모바일 네트워크에서 그 효과가 두드러집니다.
• 유연성. GraphQL API는 프런트엔드에 구애받지 않습니다. 독점 SDK에 얽매이지 않고 React, Angular, Vue 등 모든 프레임워크에서 자유롭게 구축할 수 있습니다.

GraphQL 스키마 생성

Experience Manager Sites는 콘텐츠 조각 모델에서 GraphQL 스키마를 자동으로 생성하므로 헤드리스 개발이 한결 수월합니다. 콘텐츠 아키텍트가 모델을 정의하거나 업데이트하면 Experience Manager가 해당 엔드포인트에서 변경 사항을 명확한 유형의 실시간 GraphQL 스키마로 변환합니다.

이 동적 스키마 생성 방식은 다음의 엔터프라이즈급 이점을 제공합니다.

• 강력한 유형 지정 및 사전 검증. 스키마 기반의 유형 지정은 예측 가능한 결과를 제공하고 실행 전에 잘못된 쿼리를 찾아내므로 개발 시간을 단축하고 오류를 최소화할 수 있습니다.
• 내장된 인트로스펙션 기능. 개발자는 스키마 자체를 쿼리하여 GraphQL 툴로 자동 완성, 유효성 검사, 인라인 문서화 등의 기능을 쉽게 이용할 수 있습니다.
• 콘텐츠 중심의 일관성. 스키마는 실제 콘텐츠 구조를 반영하며 단일 소스 역할을 합니다. 저작자와 개발자의 원활한 협업을 통해 스키마 불일치 문제를 방지할 수 있습니다.

스키마 생성을 자동화하는 Experience Manager Sites는 헤드리스 개발을 가속화하고, 유지 관리 오버헤드를 줄이고, 구조화된 콘텐츠와 확장 가능한 콘텐츠 전달 간의 격차를 해소합니다.

필요한 콘텐츠의 정확한 쿼리

GraphQL을 통해 클라이언트 애플리케이션은 콘텐츠 요청의 구조와 세부 사항을 정확하게 제어할 수 있습니다. 개발자는 Experience Manager Sites에서 GraphQL 쿼리를 사용해 애플리케이션의 요구 사항에 맞게 콘텐츠 조각에서 구조화된 콘텐츠를 효율적으로 검색할 수 있습니다. 주요 기능은 다음과 같습니다.

• 필드 선택. 필요한 필드만 검색하여 페이로드를 최소화하고 성능을 개선할 수 있습니다.
• 타겟팅 조각 액세스. 경로별로 개별 콘텐츠 조각을 쿼리하거나 모델 유형별로 목록을 반환할 수 있습니다.
• 고급 필터링. 필드 값에 필터를 적용하여 결과 범위를 좁힐 수 있습니다.
• 중첩된 콘텐츠 검색. 단일 쿼리에서 중첩되거나 연결된 콘텐츠 조각을 가져올 수 있습니다. 콘텐츠 관계가 복잡한 경우에 유용합니다.
• 지역 및 버전별 콘텐츠. 콘텐츠 조각의 특정 버전을 요청하여 지역 또는 채널별 개인화 경험을 제공할 수 있습니다.
• 변수를 사용한 동적 쿼리. 런타임에 ID, 검색어 등의 값을 삽입하여 구조를 다시 작성하지 않고도 유연하고 재사용 가능한 쿼리를 생성할 수 있습니다.

Experience Manager Sites의 GraphQL을 사용하면 속도, 확장성, 정확성을 고려하여 설계된 직관적인 인터페이스를 통해 콘텐츠를 헤드리스 방식으로 이용할 수 있습니다.

Experience Manager Sites에서 GraphQL 쿼리는 지정된 엔드포인트(헤드리스 콘텐츠 전달을 위한 액세스 포인트인 특정 URL)로 전송됩니다. 리소스마다 여러 엔드포인트가 있는 REST API와 달리, GraphQL은 구성당 단일 엔드포인트를 통해 상호 작용을 일원화하므로 개발과 유지 관리가 한층 수월해집니다.

거버넌스를 효과적으로 실행하기 위해 Experience Manager Sites의 GraphQL 엔드포인트는 관리자가 명시적으로 구성, 활성화, 게시해야 합니다. 이 같은 방식을 통해 구조화된 콘텐츠가 노출되기 전에 보안과 제어를 강화합니다. Experience Manager Sites는 다음 두 가지 유형의 GraphQL 엔드포인트를 지원합니다.

• 글로벌 엔드포인트. 모든 사이트별 구성의 모델과 함께, 글로벌 구성에 정의된 콘텐츠 조각 모델에 대한 액세스 권한을 부여합니다. 여러 프로젝트에서 재사용되는 공유 콘텐츠 구조에 적합합니다.
• 사이트별 엔드포인트. 특정 사이트 또는 프로젝트 구성에 연결된 이 엔드포인트는 해당 구성의 모델과 글로벌 범위의 모델에 대해서만 액세스를 제한합니다. 이를 통해 명확한 분리가 가능하고 프로젝트 간 노출을 최소화할 수 있습니다.

이 유연한 설정을 통해 브랜드, 지역, 비즈니스별로 콘텐츠 전달을 정확하게 관리하고, 보안과 투명성을 유지하면서 확장성을 극대화할 수 있습니다.