Leverans-API:er delivery-apis

Alla godkända resurser som är tillgängliga i Experience Manager-resurskatalogen kan genomsökas och sedan levereras till integrerade underordnade program med en leverans-URL.

Ändringar som görs i godkända resurser i DAM, inklusive versionsuppdateringar och metadataändringar, återspeglas automatiskt i leverans-URL:erna. Med ett kort TTL-värde (Time-to-Live) på 10 minuter konfigurerat för mediedistribution via CDN blir uppdateringarna synliga i alla redigerings- och publiceringsgränssnitt på mindre än 10 minuter.

Följande bild visar tillgängliga URL:er för leverans:

Leverans-API:er

I följande tabell visas hur de olika tillgängliga leverans-API:erna används:

Leverans-API
Beskrivning
Webboptimerad binär representation av resursen i begärt utdataformat
Returnerar den webboptimerade binära återgivningen av resursen i det begärda utdataformatet baserat på det resurs-ID som skickades i begäran. Dessutom kan du definiera olika bildmodifierare, till exempel bredd, höjd, rotering, vändning, kvalitet, beskärning, format och smart beskärning. Se API-informationen för de format och bildmodifierare som stöds.
Adobe rekommenderar att du använder detta API för alla bildformattyper.
Webboptimerad binär representation av resursen
Bekvämt API som tillämpar standardvärden för en webboptimerad binär representation av resursen som returneras i svaret. Standardvärdena är JPEG/WEBP, quality => 65 och width => 1024.
Ursprungligt överfört binärt värde för resursen
Returnerar resursens ursprungligen överförda binärfiler. Adobe rekommenderar att du använder detta API för dokumentformat och SVG-bilder.
Förgenererad återgivning av resursen som är tillgänglig i AEM Assets-redigeringsmiljö
Returnerar resursåtergivningens bitström som är tillgänglig i AEM Assets redigeringsmiljö baserat på det resurs-ID och återgivningsnamn som skickats i begäran.
Resursmetadata
Returnerar egenskaperna som är associerade med en resurs, till exempel titel, beskrivning, CreateDate, ModifyDate och så vidare.
Spelarbehållare för videoresursen
Returnerar videoresursens spelarbehållare. Du kan bädda in spelaren i i ett iframe HTML-element och spela upp videon.
Uppspelningsmanifest i det valda utdataformatet
Returnerar uppspelningsmanifestfilen för den angivna videoresursen i det valda utdataformatet. Du måste skapa en anpassad spelare som kan hantera adaptiv strömning via HLS- eller DASH-protokoll för att kunna hämta uppspelningsmanifestfilen och spela upp videon.
IMPORTANT
Du kan testa valfri modifierare, som vanligtvis inte är tillgänglig via experimentella API:er. Exempel: </adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>
​>Klicka här om du vill veta mer om hur du använder experimentella API:er och den fullständiga listan med modifierare.

Dynamic Media med OpenAPI-funktioner har också stöd för videor med lång form. Videorna har stöd för upp till 50 GB och 2 timmar.

Information om tillgängliga Dynamic Media-erbjudanden och deras funktioner finns i Dynamic Media Prime och Ultimate.

NOTE
DM Prime-kunder kan använda grundläggande bildmodifierare som rotation, beskärning, vändning, höjd, bredd och kvalitet. Smart Imaging stöder inte AVIF för DM Prime-kunder.

Slutpunkter för leverans-API:er delivery-apis-endpoint

API-slutpunkterna varierar för varje leverans-API. API-slutpunkten för Web-optimized binary representation of the asset in the requested output format API är till exempel:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/{assetId}/as/{seoName}.{format}

Leveransdomänen har liknande struktur som Experience Manager författarmiljöns domän. Den enda skillnaden är att termen author ersätts med delivery.

pXXXX refererar till program-ID

eYYYY refererar till miljö-ID

Mer information finns i API-information.

Begärandemetod för leverans-API:er delivery-api-request-method

GET

Rubrik för leverans-API deliver-assets-api-header

Du måste ange följande information när du definierar en rubrik i huvudet för leverans-API

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

Om du vill anropa leverans-API:erna krävs en IMS-token i Authorization-informationen för att leverera en begränsad resurs. IMS-token hämtas från ett tekniskt konto. Se Hämta AEM as a Cloud Service-autentiseringsuppgifter för att skapa ett nytt tekniskt konto. Se Generera åtkomsttoken för att generera IMS-token och använda den korrekt i huvud för förfrågan-API:er för leverans.

Om du vill visa exempel på förfrågningar, svarsexempel och svarskoder läser du Leverans-API:er.

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