GraphQL API로 모든 앱에 구조화된 콘텐츠를 전달하세요.

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

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

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

Experience Manager의 GraphQL API는 구조화된 콘텐츠, 특히 콘텐츠 프래그먼트를 모든 디지털 채널에 걸쳐 헤드리스 게재할 수 있도록 설계되었습니다. 단일의 유연한 엔드포인트로서, 클라이언트 애플리케이션이 필요한 데이터를 정확히, 필요한 시점에 가져올 수 있도록 지원합니다.

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

• 효율성. 단일 API 호출로 복잡하게 중첩된 콘텐츠 구조를 한 번에 가져올 수 있어 여러 엔드포인트를 연결할 필요가 없습니다. 개발이 간소화되고 페이지 로딩 속도도 빨라집니다.
• 정밀성. 개발자는 필요한 필드만 쿼리하여 페이로드 크기를 줄이고, 특히 모바일 네트워크에서 성능을 높일 수 있습니다.
• 유연성. GraphQL API는 프런트엔드에 종속되지 않아 React, Angular, Vue 등 원하는 프레임워크로 개발할 수 있으며, 독자적인 SDK에 얽매일 필요가 없습니다.

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 엔드포인트를 지원합니다.

• 글로벌 엔드포인트. 전역 구성에 정의된 콘텐츠 프래그먼트 모델과 모든 사이트별 구성의 모델에 대한 액세스를 허용합니다. 여러 프로젝트에서 반복 활용되는 공유 콘텐츠 구조에 적합합니다.
• 사이트별 엔드포인트. 특정 사이트 또는 프로젝트 구성에 연결된 이 엔드포인트는 해당 구성의 모델과 전역 범위의 모델에만 액세스를 제한하여, 명확한 격리를 제공하고 프로젝트 간 데이터 노출을 최소화합니다.

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