OpenAPI와 함께 사용하는 AEM 콘텐츠 조각 게재 aem-content-fragment-delivery-with-openapi
Adobe Experience Manager(AEM) as a Cloud Service에서 컨텐츠 조각 전달을 위한 AEM OpenAPI는 다음과 같습니다.
- 는 JSON 형식으로 AEM 컨텐츠 조각의 라이브 게재에 최적화된 OpenAPI입니다
- 컨텐츠 전달(성능, 확장성, CDN 통합, 최적화된 JSON 제어 및 출력)에 중점을 둡니다.
- 참조된 조각 및 에셋에 대해 JSON을 하이드레이션하는 기능이 포함되어 있습니다
이 API:
-
은(는) AEM Assets HTTP API에서 콘텐츠 조각 지원의 후속 항목입니다.
-
콘텐츠 조각 및 콘텐츠 조각 모델(CRUD)을 관리할 수 있도록 콘텐츠 조각 및 콘텐츠 조각 모델 OpenAPI를 보완합니다.
-
은(는) 콘텐츠 조각과 함께 사용하기 위한 AEM GraphQL API에 대한 HTTP REST 대안입니다
전체 문서를 보려면 OpenAPI를 사용한 AEM 콘텐츠 조각 배달을 참조하십시오.
- Cloud Service 프로그램 및 환경 ID
- 콘텐츠 조각 배달 OpenAPI로 해결할 사용 사례의 세부 정보
- Adobe이 응답하고 요청 및 프로젝트에 대해 계속 알려 주어야 하는 모든 연락처에 대한 세부 정보(필요한 경우)
캐싱 caching
AEM은 AEM CDN Fastly와 통합됩니다. 즉, 게시 계층에서 제공되는 JSON 응답이 Fastly 수준에서 캐시됩니다.
그러면 사전 정의된 캐싱 헤더를 기반으로 응답이 캐시됩니다(구성할 수 없음).
- 응답은 브라우저/클라이언트 캐시에서 5분 동안 캐시됩니다.
max-age=300
- 응답은 CDN 캐시에서 1시간 동안 캐시됩니다.
s-maxage=3600
- 최대 1시간 동안 새 요청의 유효성을 다시 검사하는 동안 오래된 콘텐츠를 제공할 수 있습니다.
stale-while-revalidate=3600
- 오래된 컨텐츠는 오류별로 최대 1일 동안 제공될 수 있습니다
stale-on-error=86400
사용 가능 availability
OpenAPI를 사용하는 콘텐츠 조각 전달은 미리보기 및 게시 계층에서 사용할 수 있습니다. OpenAPI는 미리보기 및 라이브 게재를 위해 콘텐츠 조각을 JSON 형식으로 전달합니다.
OpenAPI를 사용하여 콘텐츠 조각 게재를 미리 보는 경우 다음을 수행할 수 있습니다.
- 미리보기에 게시
- ip 허용 목록으로 미리 보기에 대한 액세스 활성화
- 미리보기 URL 가져오기
CORS cors
CORS 허용 원본은(는) API를 호출할 수 있는 원본을 정의합니다.
Dispatcher 구성 측, 특히 GraphQL에 대해 정의된 CORS 허용 출처는 이 API에서 고려되지 않습니다.
API 속도 제한 api-rate-limits
API를 사용하면 환경당 초당 최대 200개의 요청 비율로 새 요청을 허용할 수 있습니다.
이 제한을 초과하면 API에서 429 오류 응답을 보내기 시작합니다. 이러한 오류는 모든 클라이언트 애플리케이션에서 처리해야 하며, 기하급수적 백오프 재시도 후 실패한 요청을 다시 시도합니다. HTTP 응답에는 요청을 다시 보내기 전에 클라이언트가 대기해야 하는 시간을 나타내는 특정 헤더 Retry-After이(가) 함께 제공됩니다.
인증된 요청 authenticated-requests
인증된 요청에 대한 지원은 AEM CDN Edge 키를 사용하여 구현할 수 있습니다. AEM CDN Edge 키를 사용하면 AEM CDN을 사용할 수 있으며 특정 요청만 제공된 Edge 키 헤더를 기반으로 API에 액세스할 수 있습니다.
복합 품목 게재 deliver-a-composite-item
다음 API를 사용하여 복합 품목을 제공할 수 있습니다.
-
관리 OpenAPI(콘텐츠 조각 관리 API)에서
-
rest 게재 API. 다음 두 가지 경로가 있습니다.
- 게시 시 사전 설정
- AEM에서 처리 중 게재
-
하이드레이션된 참조 조각을 포함하는 OpenAPI 응답의 경우, 조합을 사용하면 참조 및 조각 메타데이터 오버헤드가 줄어들 수 있습니다. 페이로드 크기는 컨텐츠 구조 및 참조 포함 옵션에 따라 다릅니다. 임베드된 합성 콘텐츠는 참조 깊이와 독립적으로 포함되므로 약식 응답이 동등한 참조 기반 응답보다 클 수 있습니다.