傳送API delivery-apis

AVAILABILITY
具有 OpenAPI 功能的 Dynamic Media 指南現已提供 PDF 格式。下載完整指南,並使用 Adobe Acrobat AI 助理來回答您的查詢問題。
[具有 OpenAPI 功能的 Dynamic Media 指南 PDF]{class="badge informative"}

可在Experience Manager資產存放庫中找到的所有已核准資產都可以進行搜尋,然後使用傳送URL傳送至整合式下游應用程式。

對 DAM 中已核准資產所做的任何變更 (包括版本更新和中繼資料修改),都會自動反映在傳遞 URL 中。由於透過CDN為資產傳送設定的短存留時間(TTL)值為10分鐘,因此在10分鐘內,所有編寫和發佈介面中都會顯示更新。

下圖說明可用的傳送URL:

傳遞API

下表說明各種可用傳送API的使用情況:

傳送API
描述
以要求的輸出格式呈現資產的網頁最佳化的二進位表示
根據請求中傳送的資產ID,傳回請求輸出格式之資產的Web最佳化二進位表示法。 此外,您可以定義各種影像修飾元,例如,寬度、高度、旋轉、翻轉、品質、裁切、格式和智慧型裁切。 如需支援的格式和影像修飾元,請參閱API詳細資料
Adobe建議對所有影像格式型別使用此API。
資產的Web最佳化二進位表示
將預設套用至回應中傳回之資產的Web最佳化二進位表示的便利API。 預設值包括標準JPEG/WEBP格式、品質=> 65和寬度=> 1024。
資產的原始已上傳二進位檔
傳回資產最初上傳的二進位檔案。 Adobe建議針對檔案格式型別和SVG影像使用此API。
預先產生的資產轉譯,可在AEM Assets製作環境中使用
根據請求中傳送的資產ID和轉譯名稱,傳回AEM Assets製作環境中可用的資產轉譯位元串流。
資產中繼資料
傳回與資產關聯的屬性,例如,標題、說明、CreateDate、ModifyDate等。
視訊資產的播放器容器
傳回視訊資產的播放器容器。 您可以將播放器內嵌至iframe HTML元素中,並播放影片。
播放資料清單為選取的輸出格式
以選取的輸出格式傳回指定視訊資產的播放資訊清單檔案。 您必須建置可透過HLS或DASH通訊協定自我調整資料流的自訂播放器,才能提取播放資訊清單檔案並播放視訊。

具備OpenAPI功能的Dynamic Media也支援長格式視訊。 影片最多可支援50GB和2小時。

如需有關可用的Dynamic Media產品專案及其功能的資訊,請參閱Dynamic Media Prime和Ultimate

傳送API端點 delivery-apis-endpoint

API端點因每個傳送API而異。 例如,Web-optimized binary representation of the asset in the requested output format API的API端點是:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/{assetId}/as/{seoName}.{format}

傳遞網域的結構類似於Experience Manager作者環境的網域。 唯一的差異是以delivery取代字詞author

pXXXX參考方案識別碼

eYYYY參考環境識別碼

如需詳細資訊,請參閱API詳細資料

傳送API要求方法 delivery-api-request-method

GET

傳送API標頭 deliver-assets-api-header

在傳送API標題中定義標題時,您必須提供下列詳細資料:

headers: {
      'If-None-Match': 'string',
      Authorization: 'Bearer <YOUR_JWT_HERE>'
    }

若要叫用傳遞API,Authorization詳細資料中需要IMS權杖才能傳遞受限制的資產。 IMS權杖是從技術帳戶中擷取。 請參閱擷取AEM as a Cloud Service認證以建立新的技術帳戶。 請參閱產生存取權杖以產生IMS權杖,並在傳遞API要求標頭中正確使用它。

若要檢視要求範例、回應範例和回應代碼,請參閱傳送API

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