Show Menu
主題×

Assets HTTP API

概覽

資產HTTP API可讓您對數位資產(包括中繼資料、轉譯和注釋)以及使用內容片段的結構化內容進行建立——讀取——更新——刪除(CRUD) Experience Manager 作業。 它在公開, /api/assets 並實作為REST API。 它包含 內容片段支援
若要存取API:
  1. 在中開啟API服務文檔 https://[hostname]:[port]/api.json
  2. 請依循「資產」服務連結,前往 https://[hostname]:[server]/api/assets.json
API回應是某些MIME類型的JSON檔案,也是所有MIME類型的回應代碼。 JSON回應是選擇性的,可能無法使用,例如PDF檔案。 請依賴回應程式碼進行進一步分析或動作。
在關閉 時間後,資產及其轉譯無法透過網頁介 Assets 面和HTTP API使用。 如果「開機時間」是未來,或「關機時間 」是過去 ,API會傳回404錯誤訊息。

內容片段

容片段 ,是特殊的資產類型。 它可用來存取結構化資料,例如文字、數字、日期等。 由於資產有數種差 standard 異(例如影像或檔案),因此處理內容片段時會套用一些其他規則。

Data model

資產HTTP API會公開兩個主要元素、資料夾和資產(適用於標準資產)。
此外,它還會針對描述「內容片段」中結構化內容的自訂資料模型公開更詳細的元素。 如需詳 細資訊,請參閱內容片段資料模型

資料夾

資料夾與傳統檔案系統中的目錄類似。 它們是其他資料夾或斷言的容器。 資料夾具有以下元件:
實體 : 資料夾的實體是其子元素,可以是資料夾和資產。
屬性 :
  • name 是資料夾的名稱。 這與URL路徑中沒有副檔名的最後一個區段相同。
  • title 是可顯示的資料夾的可選標題,而非其名稱。
資料夾或資產的某些屬性會對應至不同的首碼。 首碼 jcr 為、 jcr:title 和的 jcr:description 前置詞將被 jcr:language 前置詞 dc 替換。 因此,在傳回的JSON dc:title 中, dc:description 並分別 jcr:title 包含值和 jcr:description 值。
「連結 」檔案夾會公開三個連結:
  • self : 連結到自己。
  • parent : 連結至父資料夾。
  • thumbnail : (選用)資料夾縮圖影像的連結。

資產

在Experience Manager中,資產包含下列元素:
  • 資產的屬性和中繼資料。
  • 多個轉譯,例如原始轉譯(原始上傳的資產)、縮圖和各種其他轉譯。 其他轉譯可能是不同大小的影像、不同的視訊編碼,或從PDF或Adobe InDesign檔案擷取的頁面。
  • 選用的注釋。
如需內容片段元素的詳細資訊,請參 閱Experience Manager Assets HTTP API中的內容片段支援
在Experience Manager中,檔案夾包含下列元件:
  • 實體: 資產的子系是其轉譯。
  • 屬性.
  • 連結.
資產HTTP API包含下列功能:
  • 檢索資料夾清單。
  • 建立資料夾。
  • 建立資產。
  • 更新資產二進位檔。
  • 更新資產中繼資料。
  • 建立資產轉譯。
  • 更新資產轉譯。
  • 建立資產註解。
  • 複製資料夾或資產。
  • 移動資料夾或資產。
  • 刪除資料夾、資產或轉譯。
為方便閱讀,下列範例會省略完整的cURL符號。 事實上,此符號確實與 Resty (其為的指令碼包裝函式)相關 cURL
必備條件
  1. 前往 https://[aem_server]:[port]/system/console/configMgr .
  2. 導覽至 Adobe Granite CSRF Filter
  3. 請確定屬性篩選 方法 : 貼文,放置,刪除。

檢索資料夾清單

檢索現有資料夾及其子實體(子資料夾或資產)的Siren表示法。
要求 : GET /api/assets/myFolder.json
回應碼 : 響應代碼為:
  • 200 —— 好——成功。
  • 404 —— 找不到——資料夾不存在或無法訪問。
  • 500 —— 內部伺服器錯誤——如果有其它問題。
回應 : 傳回的實體類別為資產或資料夾。 包含實體的屬性是每個實體的完整屬性集的子集。 為了取得實體的完整表示法,用戶端應擷取連結所指向之URL的內容,連結 rel self :

建立資料夾

建立新 sling : OrderedFolder 在給定的路徑上。 如果提 * 供的是節點名稱,則servlet將參數名稱用作節點名稱。 接受為請求資料是新資料夾的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 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

建立資產

將提供的檔案置於提供的路徑,以在DAM儲存庫中建立資產。 如果提 * 供的是節點名稱,則servlet將使用參數名稱或檔案名作為節點名稱。
參數 : 參數是 name 資產名稱和檔 file 案參考的參數。
要求
  • POST /api/assets/myFolder/myAsset.png -H"Content-Type: image/png" --data-binary "@myPicture.png"
  • POST /api/assets/myFolder/* -F"name=myAsset.png" -F" file=@myPicture.png "
回應碼 : 響應代碼為:
  • 201 —— 已建立——如果資產已成功建立。
  • 409 —— 衝突——如果資產已存在。
  • 412 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

更新資產二進位檔

更新資產的二進位格式(原始名稱的轉譯)。 更新會觸發預設資產處理工作流程,如果已設定,則會執行。
要求 : PUT /api/assets/myfolder/myAsset.png -H"Content-Type: image/png" --data-binary @myPicture.png
回應碼 : 響應代碼為:
  • 200 —— 確定——如果資產已成功更新。
  • 404 —— 找不到——如果在提供的URI中找不到或訪問資產,請執行此操作。
  • 412 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

更新資產中繼資料

更新資產中繼資料屬性。 如果您更新命名空間中的任 dc: 何屬性,API會更新命名空間中的相同 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 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

建立資產轉譯

為資產建立新的資產轉譯。 如果未提供請求參數名稱,則會使用檔案名稱做為轉譯名稱。
參數 :參數是 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 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

更新資產轉譯

更新會分別以新的二進位資料取代資產轉譯。
要求 : PUT /api/assets/myfolder/myasset.png/renditions/myRendition.png -H"Content-Type: image/png" --data-binary @myRendition.png
回應碼 :回應碼:
  • 200 —— 確定——如果已成功更新轉譯。
  • 404 —— 找不到——如果在提供的URI中找不到或訪問資產,請執行此操作。
  • 412 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

在資產上新增註解

建立新資產註解。
參數 : 參數是 message 注釋的訊息內文和JSON annotationData 格式的附註資料。
要求 : POST /api/assets/myfolder/myasset.png/comments/* -F"message=Hello World." -F"annotationData={}"
回應碼 : 響應代碼為:
  • 201 —— 已建立——如果已成功建立注釋。
  • 404 —— 找不到——如果在提供的URI中找不到或訪問資產,請執行此操作。
  • 412 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

複製資料夾或資產

複製位於提供路徑中的可用資料夾或資產,以連至新目標。
請求標題 : 參數包括:
  • 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 —— 前提條件失敗——如果缺少請求標題。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

移動資料夾或資產

將指定路徑上的資料夾或資產移動到新目標。
請求標題 : 參數包括:
  • 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 —— 前提條件失敗——如果缺少請求標題。
  • 500 —— 內部伺服器錯誤——如果有其它問題。

刪除資料夾、資產或轉譯

刪除提供路徑上的資源(-tree)。
要求
  • DELETE /api/assets/myFolder
  • DELETE /api/assets/myFolder/myAsset.png
  • DELETE /api/assets/myFolder/myAsset.png/renditions/original
回應碼 : 響應代碼為:
  • 200 —— 確定——如果資料夾已成功刪除。
  • 412 - PRECONDITATION FAILED —— 如果找不到或存取根系列。
  • 500 —— 內部伺服器錯誤——如果有其它問題。