AEM Assets HTTP API의 콘텐츠 조각 지원 content-fragments-support-in-aem-assets-http-api

개요 overview

Adobe Experience Manager(AEM) Headless 전달 기능의 중요한 부분인 Assets HTTP API의 콘텐츠 조각에 대한 지원에 대해 알아봅니다.

Assets REST API를 사용하면 Adobe Experience Manager as a Cloud Service의 개발자가 CRUD(만들기, 읽기, 업데이트, 삭제) 작업을 통해 HTTP API를 통해 직접 콘텐츠(AEM에 저장됨)에 액세스할 수 있습니다.

API를 사용하면 Adobe Experience Manager as a Cloud Service 프론트엔드 애플리케이션에 컨텐츠 서비스를 제공하여 JavaScript as a headless CMS(컨텐츠 관리 시스템)를 운영할 수 있습니다. 또는 HTTP 요청을 실행하고 JSON 응답을 처리할 수 있는 다른 모든 애플리케이션.

예를 들어 프레임워크 기반 또는 사용자 지정 SPA(단일 페이지 애플리케이션)은(는) HTTP API를 통해 제공되는 콘텐츠(종종 JSON 형식)가 필요합니다.

AEM 핵심 구성 요소는 이 용도로 필요한 읽기 작업을 수행하고 JSON 출력을 사용자 지정할 수 있는 사용자 지정 가능한 API를 제공하지만, 구현을 위해 AEM WCM(웹 콘텐츠 관리) 노하우가 필요합니다. 전용 AEM 템플릿을 기반으로 하는 페이지에서 호스팅해야 하기 때문입니다. 모든 SPA 개발 조직이 이러한 지식에 직접 액세스할 수 있는 것은 아닙니다.

이때 Assets REST API를 사용할 수 있습니다. 이를 통해 개발자는 페이지에 에셋을 먼저 임베드할 필요 없이 에셋(예: 이미지 및 콘텐츠 조각)에 직접 액세스하고 콘텐츠를 직렬화된 JSON 형식으로 전달할 수 있습니다.

Assets REST API를 사용하면 개발자가 기존 에셋, 콘텐츠 조각 및 폴더를 새로 만들거나 업데이트하거나 삭제하여 콘텐츠를 수정할 수도 있습니다.

Assets REST API:

사전 요구 사항 prerequisites

Assets REST API는 기본적으로 제공되는 최신 Adobe Experience Manager as a Cloud Service 버전 설치에서 사용할 수 있습니다.

주요 개념 key-concepts

Assets REST API는 AEM 인스턴스 내에 저장된 자산에 대한 REST 스타일 액세스를 제공합니다.

/api/assets 끝점을 사용하며 자산 경로를 사용하여 액세스합니다(선행 /content/dam 없음).

예를 들어 /content/dam/wknd/en/adventures/cycling-tuscany에 액세스하기 위해 /api/assets/wknd/en/adventures/cycling-tuscany.json을 요청합니다.

HTTP 메서드는 실행할 작업을 결정합니다.

지원되는 요청의 정확한 형식은 API 참조 설명서에 정의되어 있습니다.

트랜잭션 동작 transactional-behavior

모든 요청은 원자입니다.

즉, 후속(write) 요청은 단일 엔터티로 성공하거나 실패할 수 있는 단일 트랜잭션으로 결합할 수 없습니다.

AEM(Assets) REST API 및 AEM 구성 요소 aem-assets-rest-api-versus-aem-components

보안 security

Assets REST API가 특정 인증 요구 사항 없이 환경 내에서 사용되는 경우 AEM의 CORS 필터를 올바르게 구성해야 합니다.

특정 인증 요구 사항이 있는 환경에서는 OAuth가 권장됩니다.

사용 가능한 기능 available-features

콘텐츠 조각은 특정 유형의 자산입니다. 콘텐츠 조각을 사용하여 작업을 참조하세요.

API를 통해 사용할 수 있는 기능에 대한 자세한 내용은 다음을 참조하십시오.

페이징 paging

Assets REST API는 URL 매개 변수를 통해 (GET 요청에 대한) 페이징을 지원합니다.

응답에 SIREN 출력의 properties 섹션의 일부로 페이징 정보가 포함되어 있습니다. 이 srn:paging 속성에는 요청에 지정된 총 (하위) 엔티티 수(total), 오프셋 및 제한(offset, limit)이 포함됩니다.

예: 페이징 example-paging

GET /api/assets.json?offset=2&limit=3

...
"properties": {
    ...
    "srn:paging": {
        "total": 7,
        "offset": 2,
        "limit": 3
    }
    ...
}
...

엔티티 유형 entity-types

폴더 folders

폴더는 에셋 및 기타 폴더의 컨테이너 역할을 합니다. 이는 AEM 콘텐츠 저장소의 구조를 반영합니다.

Assets REST API는 폴더의 속성에 대한 액세스를 노출합니다. (예: 이름 및 제목) Assets은 폴더 및 하위 폴더의 하위 엔티티로 노출됩니다.

자산 assets

에셋이 요청되면 응답은 제목, 이름 및 각 에셋 스키마에서 정의한 기타 정보와 같은 메타데이터를 반환합니다.

자산의 이진 데이터가 content 유형의 SIREN 링크로 노출됩니다.

Assets에는 여러 표현물이 있을 수 있습니다. 일반적으로 자식 엔터티로 노출됩니다. 한 가지 예외는 썸네일 렌디션으로, thumbnail(rel="thumbnail") 형식의 링크로 노출됩니다.

콘텐츠 조각 content-fragments

콘텐츠 조각은(는) 특별한 유형의 자산입니다. 텍스트, 숫자, 날짜 등 구조화된 데이터에 액세스하는 데 사용할 수 있습니다.

표준 자산(예: 이미지 또는 오디오)에 몇 가지 차이점이 있으므로 이를 처리하는 데 일부 추가 규칙이 적용됩니다.

표시 representation

컨텐츠 조각:

콘텐츠 모델 및 콘텐츠 조각 content-models-and-content-fragments

현재 콘텐츠 조각의 구조를 정의하는 모델은 HTTP API를 통해 노출되지 않습니다. 따라서 consumer ​은(는) 페이로드에서 대부분의 정보를 유추할 수 있지만, 데이터 형식 등은 정의의 일부입니다.

콘텐츠 조각을 만들려면 모델의 (내부 저장소) 경로를 제공해야 합니다.

관련 콘텐츠 associated-content

연결된 콘텐츠가 노출되지 않았습니다.

사용 using

특정 사용 사례와 함께 AEM Author 또는 Publish 환경을 사용하는지 여부에 따라 사용이 다를 수 있습니다.

제한 사항 limitations

몇 가지 제한 사항이 있습니다.

상태 코드 및 오류 메시지 status-codes-and-error-messages

관련 상황에서 다음 상태 코드를 볼 수 있습니다.

API 참조 api-reference

자세한 API 참조는 여기를 참조하십시오.

추가 리소스 additional-resources

자세한 내용은 다음 문서를 참조하십시오.