Assets HTTP API

概觀

此 Assets HTTP API允許對數位資產進行建立 — 讀取 — 更新 — 刪除(CRUD)操作，包括對中繼資料、轉譯和評論的操作，以及使用的結構化內容 Experience Manager 內容片段。 它公開於 /api/assets 和實作為REST API。 其中包括 支援內容片段.

若要存取API：

1. 開啟API服務檔案，網址為 https://[hostname]:[port]/api.json.
2. 請遵循 Assets 服務連結導向 https://[hostname]:[server]/api/assets.json.

API回應是適用於某些MIME型別的JSON檔案，也是適用於所有MIME型別的回應代碼。 JSON回應為選用，可能不可使用(例如PDF檔案)。 依賴回應代碼進行進一步分析或執行動作。

晚於 關閉時間，無法透過 Assets 網頁介面以及透過HTTP API。 如果 準時 為未來或 關閉時間 為過去。

內容片段

A 內容片段 是一種特殊型別的資產。 它可用來存取結構化資料，例如文字、數字、日期等。 由於有幾項差異， standard 資產（例如影像或檔案），則處理內容片段會套用一些其他規則。

如需詳細資訊，請參閱 Experience Manager Assets HTTP API中的內容片段支援.

資料模型

此 Assets HTTP API會顯示兩個主要元素，資料夾和資產（適用於標準資產）。

此外，它會公開描述內容片段中結構化內容的自訂資料模型更詳細的元素。 另請參閱 內容片段資料模型 以取得進一步資訊。

資料夾

資料夾就像傳統檔案系統中的目錄。 它們是其他資料夾或判斷提示的容器。 資料夾包含下列元件：

實體：資料夾的實體是它的子元素，可以是資料夾和資產。

屬性:

• name 是資料夾的名稱。 這與URL路徑中沒有副檔名的最後一個區段相同。
• title 是資料夾的可選標題，可顯示而非其名稱。

連結 資料夾會顯示三個連結：

• self：連結至本身。
• parent：連結至父資料夾。
• thumbnail：（選用）連結至資料夾縮圖影像。

Assets

在Experience Manager中，資產包含以下元素：

• 資產的屬性和中繼資料。
• 多個轉譯，例如原始轉譯（即最初上傳的資產）、縮圖和各種其他轉譯。 其他轉譯可能是不同大小的影像、不同的視訊編碼，或從PDF或擷取的頁面 Adobe InDesign 檔案。
• 選擇性註解。

如需內容片段中元素的相關資訊，請參閱 Experience Manager Assets HTTP API中的內容片段支援.

在 Experience Manager 資料夾包含下列元件：

• 實體：資產的子系為其轉譯。
• 屬性.
• 連結.

此 Assets HTTP API包含下列功能：

• 擷取資料夾清單.
• 建立資料夾.
• 建立資產.
• 更新資產二進位檔.
• 更新資產中繼資料.
• 建立資產轉譯.
• 更新資產轉譯.
• 建立資產註解.
• 複製資料夾或資產.
• 行動資料夾或資產.
• 刪除資料夾、資產或轉譯.

必備條件

• 存取 https://[aem_server]:[port]/system/console/configMgr.
• 導覽至 AdobeGranite CSRF篩選器.
• 確認屬性 篩選方法 包括： POST， PUT， DELETE.

擷取資料夾清單

擷取現有資料夾及其子系實體（子資料夾或資產）的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查詢引數。

API呼叫失敗，因為 500 回應代碼（如果所提供路徑的父節點不存在）。 呼叫傳回回應代碼 409 若資料夾已存在。

引數： name 是資料夾名稱。

要求

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

回應代碼：回應程式碼為：

• 201 — 建立 — 成功建立時。
• 409 — 衝突 — 如果資料夾已存在。
• 412 - PRECONDITION 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 - CREATED — 如果已成功建立資產。
• 409 — 衝突 — 如果資產已存在。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

更新資產二進位檔

更新資產的二進位檔（名稱為原始的轉譯）。 如果已設定，更新會觸發預設資產處理工作流程執行。

請求： PUT /api/assets/myfolder/myAsset.png -H"Content-Type: image/png" --data-binary @myPicture.png

回應代碼：回應程式碼為：

• 200 — 確定 — 如果資產已成功更新。
• 404 — 找不到 — 如果在提供的URI中找不到或無法存取資產。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

更新資產中繼資料

更新資產中繼資料屬性。 如果您更新 dc: 名稱空間中，API會更新 jcr 名稱空間。 API不會同步兩個名稱空間下的屬性。

請求： PUT /api/assets/myfolder/myAsset.png -H"Content-Type: application/json" -d '{"class":"asset", "properties":{"jcr:title":"My Asset"}}'

回應代碼：回應程式碼為：

• 200 — 確定 — 如果資產已成功更新。
• 404 — 找不到 — 如果在提供的URI中找不到或無法存取資產。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

同步中繼資料更新，介於 dc 和 jcr 名稱空間

API方法會更新 jcr 名稱空間。 使用使用者介面進行的更新會變更 dc 名稱空間。 若要同步中繼資料值，請執行下列動作： dc 和 jcr 名稱空間，您可以建立工作流程並設定Experience Manager，以在資產編輯時執行工作流程。 使用ECMA指令碼來同步必要的中繼資料屬性。 以下範例指令碼會同步標題字串於 dc:title 和 jcr:title.

var workflowData = workItem.getWorkflowData();
if (workflowData.getPayloadType() == "JCR_PATH")
{
 var path = workflowData.getPayload().toString();
 var node = workflowSession.getSession().getItem(path);
 var metadataNode = node.getNode("jcr:content/metadata");
 var jcrcontentNode = node.getNode("jcr:content");
if (jcrcontentNode.hasProperty("jcr:title"))
{
 var jcrTitle = jcrcontentNode.getProperty("jcr:title");
 metadataNode.setProperty("dc:title", jcrTitle.toString());
 metadataNode.save();
}
}

建立資產轉譯

為資產建立新的資產轉譯。 如果未提供請求引數名稱，則會使用檔案名稱作為轉譯名稱。

引數：引數包括 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 - CREATED — 如果已成功建立轉譯。
• 404 — 找不到 — 如果在提供的URI中找不到或無法存取資產。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

更新資產轉譯

更新會分別以新的二進位資料取代資產轉譯。

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

回應代碼：回應程式碼為：

• 200 - OK — 如果已成功更新轉譯。
• 404 — 找不到 — 如果在提供的URI中找不到或無法存取資產。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

在資產上新增註解

建立新的資產註解。

引數：引數包括 message 註解的訊息內文和 annotationData JSON格式的附注資料。

請求： POST /api/assets/myfolder/myasset.png/comments/* -F"message=Hello World." -F"annotationData={}"

回應代碼：回應程式碼為：

• 201 - CREATED — 如果評論已成功建立。
• 404 — 找不到 — 如果在提供的URI中找不到或無法存取資產。
• 412 - PRECONDITION 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 - CREATED — 若資料夾/資產已複製到不存在的目的地。
• 204 — 無內容 — 若資料夾/資產已複製到現有目的地。
• 412 - PRECONDITION失敗 — 如果缺少請求標頭。
• 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"

不要使用 /content/dam 在URL中。 移動資產和覆寫現有資產的命令範例為：

curl -u admin:admin -X MOVE https://[aem_server]:[port]/api/assets/source/file.png -H "X-Destination: https://[aem_server]:[port]/api/assets/destination/file.png" -H "X-Overwrite: T"

回應代碼：回應程式碼為：

• 201 - CREATED — 若資料夾/資產已複製到不存在的目的地。
• 204 — 無內容 — 若資料夾/資產已複製到現有目的地。
• 412 - PRECONDITION失敗 — 如果缺少請求標頭。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

刪除資料夾、資產或轉譯

刪除提供路徑中的資源(-tree)。

要求

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

回應代碼：回應程式碼為：

• 200 — 確定 — 如果資料夾已成功刪除。
• 412 - PRECONDITION FAILED — 如果找不到或無法存取根集合。
• 500 — 內部伺服器錯誤 — 如果發生其他錯誤。

提示和限制

• HTTP API會更新中繼資料屬性 在 jcr 名稱空間。 不過，Experience Manager使用者介面會更新 dc 名稱空間。

• Assets HTTP API未傳回完整的中繼資料。 系統會以硬式編碼撰寫名稱空間，且只會傳回這些名稱空間。 如需完整的中繼資料，請參閱資產路徑 /jcr_content/metadata.json.

Business.Adobe.com 資源

Ecommerce Integrations Customer Communications Embedded Charts Theme Editor Customer Experience Management Dynamic Forms