설명서AEM as a Cloud Service사용 안내서

Adobe Experience Manager Assets HTTP API를 사용하여 디지털 자산 관리 assets-http-api

Last update: Fri Mar 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 개발자
  • 관리자
새로 만들기 Dynamic Media Prime 및 Ultimate
새로 만들기 AEM Assets Ultimate
새로 만들기 Edge Delivery Services과 AEM Assets 통합
새로 만들기 UI 확장성
새로 만들기 Dynamic Media Prime 및 Ultimate 사용
모범 사례 검색
메타데이터 모범 사례
Content Hub
OpenAPI 기능이 포함된 Dynamic Media
AEM Assets 개발자 설명서
버전
문서 링크
AEM 6.5
여기 클릭
AEM as a Cloud Service
이 문서

AEM Assets HTTP API 시작 overview

AEM Assets HTTP API는 /api/assets에서 사용할 수 있는 REST 인터페이스를 통해 디지털 에셋에서 CRUD(만들기, 읽기, 업데이트 및 삭제) 작업을 활성화합니다. 이러한 작업은 에셋 메타데이터, 렌디션 및 주석에 적용됩니다. 여기에는 콘텐츠 조각 지원이 포함됩니다.

NOTE
콘텐츠 조각 관리 API의 현대화된 OpenAPI 구현을 사용할 수 있습니다. 전체 설명서는 콘텐츠 조각 관리 API를 참조하십시오. 새로운 OpenAPI 구현을 사용하는 것이 좋습니다. 컨텐츠 조각에 대한 Assets HTTP API의 기존 사용은 새로운 컨텐츠 조각 관리 OpenAPI로 마이그레이션해야 합니다.

API에 액세스하려면:

  1. https://[hostname]:[port]/api.json에서 API 서비스 문서를 엽니다.
  2. https://[hostname]:[server]/api/assets.json(으)로 이어지는 Assets 서비스 링크를 따르십시오.

API 응답은 일부 MIME 유형에 대한 JSON 파일이며 모든 MIME 유형에 대한 응답 코드입니다. JSON 응답은 선택 사항이며 예를 들어 PDF 파일에 사용하지 못할 수 있습니다. 추가적인 분석 또는 작업을 위해 응답 코드를 사용합니다.

NOTE
일반적으로 에셋 또는 바이너리(예: 렌디션)를 업로드하거나 업데이트하는 것과 관련된 모든 API 호출은 Experience Manager에서 Cloud Service 배포로 더 이상 사용되지 않습니다. 바이너리를 업로드하려면 직접 바이너리 업로드 API를 대신 사용하십시오.

콘텐츠 조각 관리 content-fragments

콘텐츠 조각은(는) 텍스트, 숫자 및 날짜를 저장하는 구조화된 자산입니다. standard개의 자산(예: 이미지 또는 문서)에 몇 가지 차이점이 있으므로 콘텐츠 조각 처리에 몇 가지 추가 규칙이 적용됩니다.

자세한 내용은 Experience Manager Assets HTTP API🔗에서 콘텐츠 조각 지원을 참조하십시오.

NOTE
사용 가능한 다양한 API에 대한 개요와 관련된 몇 가지 개념의 비교는 구조화된 컨텐츠 배달 및 관리를 위한 AEM API를 참조하십시오.
콘텐츠 조각 및 콘텐츠 조각 모델 OpenAPI도 사용하실 수 있습니다.

데이터 모델 검사 data-model

Assets HTTP API는 주로 폴더와 표준 자산의 두 요소를 노출합니다. 또한 콘텐츠 조각에 사용되는 사용자 지정 데이터 모델에 대한 세부 요소를 제공합니다. 자세한 내용은 콘텐츠 조각 데이터 모델 을 참조하십시오. 자세한 내용은 콘텐츠 조각 데이터 모델을 참조하세요.

NOTE
콘텐츠 조각 및 콘텐츠 조각 모델 OpenAPI도 사용하실 수 있습니다.

폴더 관리 folders

폴더는 기존 파일 시스템에서처럼 디렉토리와 같습니다. 폴더에는 에셋, 하위 폴더 또는 둘 다 포함될 수 있습니다. 폴더에는 다음과 같은 구성 요소가 있습니다.

엔터티: 폴더의 엔터티는 폴더 및 에셋일 수 있는 하위 요소입니다.

속성:

  • name: 폴더 이름(확장명이 없는 URL 경로의 마지막 세그먼트)입니다.
  • title: 폴더 이름 대신 표시되는 선택적 제목입니다.
NOTE
폴더 또는 에셋의 일부 속성이 다른 접두사에 매핑됩니다. jcr:title, jcr:description 및 jcr:language의 jcr 접두사가 dc 접두사로 대체되었습니다. 따라서 반환된 JSON에서 dc:title 및 dc:description에는 각각 jcr:title 및 jcr:description의 값이 포함됩니다.

링크 폴더에는 세 개의 링크가 있습니다.

  • self: 폴더 자체에 대한 링크입니다.
  • parent: 상위 폴더에 대한 링크입니다.
  • thumbnail(선택 사항): 폴더 썸네일 이미지에 대한 링크입니다.

자산 관리 assets

Experience Manager에서 자산에 다음 요소가 포함되어 있습니다.

  • 속성 및 메타데이터: 자산에 대한 설명 정보입니다.
  • 이진 파일: 원래 업로드된 파일입니다.
  • 렌디션: 다양한 크기의 이미지, 다양한 비디오 인코딩 또는 PDF/Adobe InDesign 파일의 추출된 페이지 등 구성된 여러 렌디션.
  • 댓글(선택 사항): 사용자가 입력한 설명.

콘텐츠 조각의 요소에 대한 자세한 내용은 Experience Manager Assets HTTP API의 콘텐츠 조각 지원을 참조하십시오.

NOTE
콘텐츠 조각 및 콘텐츠 조각 모델 OpenAPI도 사용하실 수 있습니다.

Experience Manager에서 폴더에 다음 구성 요소가 있습니다.

  • 엔티티: 에셋의 하위 항목이 렌디션입니다.
  • 속성.
  • 링크.

사용 가능한 API 작업 탐색 available-features

Assets HTTP API에는 다음 기능이 포함되어 있습니다.

NOTE
쉽게 읽을 수 있도록 다음 예제에서는 전체 cURL 표기법을 생략합니다. 표기법은 cURL에 대한 스크립트 래퍼인 Resty와(과) 상관 관계가 있습니다.

폴더 목록 검색 retrieve-a-folder-listing

기존 폴더 및 하위 엔티티(하위 폴더 또는 에셋)의 Siren 표현을 검색합니다.

요청: GET /api/assets/myFolder.json

응답 코드: 응답 코드는 다음과 같습니다.

  • 200 - 확인 - 성공.
  • 404 - 찾을 수 없음 - 폴더가 없거나 액세스할 수 없습니다.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

응답: 반환된 엔터티의 클래스가 에셋 또는 폴더입니다. 포함된 엔티티의 등록 정보는 각 엔티티의 전체 등록 정보 세트의 하위 집합입니다. 엔터티의 전체 표현을 가져오려면 클라이언트는 self의 rel을(를) 가진 링크가 가리키는 URL의 콘텐츠를 검색해야 합니다.

폴더 만들기 create-a-folder

지정된 경로에 sling: OrderedFolder을(를) 만듭니다. *이(가) 노드 이름 대신 제공된 경우 서블릿은 매개 변수 이름을 노드 이름으로 사용합니다. 요청은 다음 중 하나를 수락합니다.

  • 새 폴더의 Siren 표현
  • application/www-form-urlencoded 또는 multipart/ form- data(으)로 인코딩된 이름-값 쌍 집합입니다. 이러한 기능은 HTML 양식에서 직접 폴더를 만드는 데 유용합니다.

또한 폴더의 속성을 URL 쿼리 매개 변수로 지정할 수 있습니다.

제공된 경로의 부모 노드가 없는 경우 500 응답 코드로 API 호출이 실패합니다. 폴더가 있는 경우 호출에서 응답 코드 409을(를) 반환합니다.

매개 변수: name은(는) 폴더 이름입니다.

요청

  • POST /api/assets/myFolder -H"Content-Type: application/json" -d '{"class":"assetFolder","properties":{"title":"My Folder"}}'
  • POST /api/assets/* -F"name=myfolder" -F"title=My Folder"

응답 코드: 응답 코드는 다음과 같습니다.

  • 201 - 작성됨 - 작성됨.
  • 409 - 충돌 - 폴더가 있는 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

에셋 만들기 create-an-asset

이 HTTP API를 통해서는 자산 만들기가 지원되지 않습니다. 에셋을 만들려면 에셋 업로드 API를 사용하십시오.

자산 바이너리 업데이트 update-asset-binary

자산 바이너리를 업데이트하는 방법에 대한 자세한 내용은 자산 업로드를 참조하십시오. HTTP API를 사용하여 자산 바이너리를 업데이트할 수 없습니다.

에셋의 메타데이터 업데이트 update-asset-metadata

이 작업은 자산의 메타데이터를 업데이트합니다. dc: 네임스페이스의 속성을 업데이트할 때 해당 jcr: 속성이 업데이트됩니다. 그러나 API는 두 네임스페이스 아래의 속성을 동기화하지 않습니다.

요청: PUT /api/assets/myfolder/myAsset.png -H"Content-Type: application/json" -d '{"class":"asset", "properties":{"dc:title":"My Asset"}}'

응답 코드: 응답 코드는 다음과 같습니다.

  • 200 - 확인 - 에셋이 성공적으로 업데이트된 경우.
  • 404 - 찾을 수 없음 - 제공된 URI에서 에셋을 찾거나 액세스할 수 없는 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

에셋 렌디션 만들기 create-an-asset-rendition

에셋에 대한 렌디션을 만듭니다. 요청 매개변수 이름이 제공되지 않으면 파일 이름이 렌디션 이름으로 사용됩니다.

매개 변수: 매개 변수는 다음과 같습니다.

name: 렌디션 이름입니다.
file: 참조용 렌디션의 이진 파일입니다.

요청

  • POST /api/assets/myfolder/myasset.png/renditions/web-rendition -H"Content-Type: image/png" --data-binary "@myRendition.png"
  • POST /api/assets/myfolder/myasset.png/renditions/* -F"name=web-rendition" -F"file=@myRendition.png"

응답 코드

  • 201 - 작성됨 - 표현물이 성공적으로 작성된 경우.
  • 404 - 찾을 수 없음 - 제공된 URI에서 에셋을 찾거나 액세스할 수 없는 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

에셋 렌디션 업데이트 update-an-asset-rendition

업데이트는 각각 에셋 렌디션을 새 바이너리 데이터로 바꿉니다.

요청: PUT /api/assets/myfolder/myasset.png/renditions/myRendition.png -H"Content-Type: image/png" --data-binary @myRendition.png

응답 코드: 응답 코드는 다음과 같습니다.

  • 200 - 확인 - 표현물이 성공적으로 업데이트된 경우.
  • 404 - 찾을 수 없음 - 제공된 URI에서 에셋을 찾거나 액세스할 수 없는 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

자산에 주석 추가 create-an-asset-comment

매개 변수: 댓글의 메시지 본문에는 매개 변수가 message이고 JSON 형식의 주석 데이터에는 매개 변수가 annotationData입니다.

요청: POST /api/assets/myfolder/myasset.png/comments/* -F"message=Hello World." -F"annotationData={}"

응답 코드: 응답 코드는 다음과 같습니다.

  • 201 - 작성됨 - 주석이 성공적으로 생성된 경우.
  • 404 - 찾을 수 없음 - 제공된 URI에서 에셋을 찾거나 액세스할 수 없는 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

폴더 또는 에셋 복사 copy-a-folder-or-asset

제공된 경로에서 사용할 수 있는 폴더 또는 에셋을 새 대상에 복사합니다.

요청 헤더: 매개 변수는 다음과 같습니다.

  • X-Destination - 리소스를 복사할 API 솔루션 범위 내의 새 대상 URI입니다.
  • X-Depth - infinity 또는 0. 0을(를) 사용하면 리소스와 해당 속성만 복사되고 하위 속성은 복사되지 않습니다.
  • X-Overwrite - 기존 대상에서 에셋을 덮어쓰지 않도록 하려면 F을(를) 사용합니다.

요청: COPY /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-copy"

응답 코드: 응답 코드는 다음과 같습니다.

  • 201 - 생성됨 - 폴더/에셋이 존재하지 않는 대상에 복사된 경우.
  • 204 - 콘텐츠 없음 - 폴더/에셋이 기존 대상에 복사된 경우.
  • 412 - PRECONDITION FAILED - 요청 헤더가 누락된 경우
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

폴더 또는 자산 이동 move-a-folder-or-asset

지정된 경로의 폴더 또는 자산을 새 대상으로 이동합니다.

요청 헤더: 매개 변수는 다음과 같습니다.

  • X-Destination - 리소스를 복사할 API 솔루션 범위 내의 새 대상 URI입니다.
  • X-Depth - infinity 또는 0. 0을(를) 사용하면 리소스와 해당 속성만 복사되고 하위 속성은 복사되지 않습니다.
  • X-Overwrite - T을(를) 사용하여 기존 리소스를 강제로 삭제하거나 F을(를) 사용하여 기존 리소스를 덮어쓰지 않도록 합니다.

요청: MOVE /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-moved"

응답 코드: 응답 코드는 다음과 같습니다.

  • 201 - 생성됨 - 폴더/에셋이 존재하지 않는 대상에 복사된 경우.
  • 204 - 콘텐츠 없음 - 폴더/에셋이 기존 대상에 복사된 경우.
  • 412 - PRECONDITION FAILED - 요청 헤더가 누락된 경우
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

폴더, 에셋 또는 렌디션 삭제 delete-a-folder-asset-or-rendition

제공된 경로에서 리소스(-트리)를 삭제합니다.

요청

  • DELETE /api/assets/myFolder
  • DELETE /api/assets/myFolder/myAsset.png
  • DELETE /api/assets/myFolder/myAsset.png/renditions/original

응답 코드: 응답 코드는 다음과 같습니다.

  • 200 - 확인 - 폴더가 성공적으로 삭제된 경우.
  • 412 - 사전 조건 실패 - 루트 컬렉션을 찾거나 액세스할 수 없는 경우.
  • 500 - 내부 서버 오류 - 다른 문제가 발생한 경우.

모범 사례 및 참고 제한 사항 준수 tips-limitations

  • 해제 시간에 도달하면 Assets 웹 인터페이스와 HTTP API를 통해 Assets 및 해당 표현물을 사용할 수 없게 됩니다. 설정 시간이 미래이거나 해제 시간이 과거인 경우 API가 404 오류를 반환합니다.

  • Assets HTTP API는 메타데이터의 하위 집합만 반환합니다. 네임스페이스는 하드코딩되고 해당 네임스페이스만 반환됩니다. 전체 메타데이터에 대해서는 자산 경로 /jcr_content/metadata.json을(를) 참조하십시오.

  • 폴더 또는 에셋의 일부 속성은 API를 사용하여 업데이트할 때 다른 접두사에 매핑됩니다. jcr:title, jcr:description 및 jcr:language의 jcr 접두사가 dc 접두사로 대체되었습니다. 따라서 반환된 JSON에서 dc:title 및 dc:description에는 각각 jcr:title 및 jcr:description의 값이 포함됩니다.

관련 리소스 살펴보기

Related Articles
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab