Bereitstellungs-APIs delivery-apis

AVAILABILITY
Das Handbuch zu Dynamic Media mit OpenAPI-Funktionen ist jetzt im PDF-Format verfügbar. Laden Sie das gesamte Handbuch herunter und verwenden Sie den KI-Assistenten von Adobe Acrobat, um Ihre Fragen zu beantworten.
[Handbuch zu Dynamic Media mit OpenAPI-Funktionen als PDF]{class="badge informative"}

Alle genehmigten Assets, die im Experience Manager-Asset-Repository verfügbar sind, können durchsucht werden und anschließend mithilfe einer Bereitstellungs-URL an integrierte nachgelagerte Anwendungen gesendet werden.

Alle Änderungen an genehmigten Assets in DAM, einschließlich Versionsaktualisierungen und Metadatenänderungen, werden automatisch in die Bereitstellungs-URLs übernommen. Mit einem niedrigen Time-to-Live(TTL)-Wert von 10 Minuten für die Bereitstellung von Assets per CDN werden Aktualisierungen in weniger als 10 Minuten in allen Authoring- und Publishing-Oberflächen sichtbar.

Die folgende Abbildung zeigt die verfügbaren Bereitstellungs-URLs:

Bereitstellungs-APIs

Die folgende Tabelle zeigt die Verwendung der verschiedenen verfügbaren Bereitstellungs-APIs:

Bereitstellungs-API
Beschreibung
Web-optimierte binäre Darstellung des Assets im angeforderten Ausgabeformat
Gibt die Web-optimierte binäre Darstellung des Assets im angeforderten Ausgabeformat basierend auf der in der Anfrage gesendeten Asset-ID zurück. Darüber hinaus können Sie verschiedene Bildmodifikatoren definieren, z. B. Breite, Höhe, Drehung, Spiegelung, Qualität, Zuschnitt, Format und intelligenter Zuschnitt. Informationen zu unterstützten Formaten und Bildmodifikatoren finden Sie unter API-Details.
Adobe empfiehlt die Verwendung dieser API für alle Bildformattypen.
Web-optimierte binäre Darstellung des Assets
Praktische API, die die Standardeinstellungen auf eine Web-optimierte binäre Darstellung des in der Antwort zurückgegebenen Assets anwendet. Die Standardeinstellungen sehen ein standardmäßiges JPEG/WEBP-Format, einen Qualitätswert von 65 und einen Breitenwert von 1024 vor.
Ursprünglich hochgeladene Binärdatei des Assets
Gibt die ursprünglich hochgeladenen Binärdateien für das Asset zurück. Adobe empfiehlt die Verwendung dieser API für Dokumentformattypen und SVG-Bilder.
Vorgenerierte Ausgabedarstellung des Assets, das in der AEM Assets-Authoring-Umgebung verfügbar ist
Gibt den in der AEM Assets-Authoring-Umgebung verfügbaren Bitstream der Asset-Ausgabedarstellung basierend auf der Asset-ID und dem Namen der Ausgabedarstellung zurück, die beide in der Anfrage gesendet wurden.
Asset-Metadaten
Gibt die mit einem Asset verknüpften Eigenschaften zurück, z. B. Titel, Beschreibung, Erstelldatum, Änderungsdatum usw.
Player-Container für das Video-Asset
Gibt den Player-Container für das Video-Asset zurück. Sie können den Player in ein iFrame-HTML-Element einbetten und das Video abspielen.
Wiedergabe-Manifeste im ausgewählten Ausgabeformat
Gibt die Wiedergabe-Manifestdatei für das angegebene Video-Asset im ausgewählten Ausgabeformat zurück. Sie müssen einen benutzerdefinierten Player erstellen, der adaptives Streaming über HLS- oder DASH-Protokolle ermöglicht, um die Wiedergabe-Manifestdatei abzurufen und das Video abzuspielen.
NOTE

Bereitstellungs-API-Endpunkte delivery-apis-endpoint

Die API-Endpunkte variieren je nach Bereitstellungs-API. Der API-Endpunkt für die API Web-optimized binary representation of the asset in the requested output format lautet beispielsweise:
https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/{assetId}/as/{seoName}.{format}

Die Bereitstellungs-Domain ähnelt der Struktur der Domain der Autorenumgebung von Experience Manager. Der einzige Unterschied ist das Ersetzen des Begriffs author durch delivery.

pXXXX bezeichnet die Programm-ID

eYYYY bezeichnet die Umgebungs-ID

Weitere Informationen finden Sie unter API-Details.

Anfragemethode für Bereitstellungs-APIs delivery-api-request-method

GET

Header für Bereitstellungs-APIs deliver-assets-api-header

Beim Definieren eines Headers müssen Sie die folgenden Details im Header der Bereitstellungs-APIs angeben:

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

Zum Aufrufen der Bereitstellungs-APIs ist ein IMS-Token in den Authorization-Details erforderlich, um ein eingeschränktes Asset bereitzustellen. Das IMS-Token wird aus einem technischen Konto abgerufen. Informationen zum Erstellen eines neuen technischen Kontos finden Sie unter Abrufen der Anmeldedaten für AEM as a Cloud Service. Informationen zum Generieren des IMS-Tokens und zu seiner entsprechenden Verwendung im Anfrage-Header der Bereitstellungs-APIs finden Sie unter Generieren des Zugriffs-Tokens.

Informationen zum Anzeigen von Anfragebeispielen, Antwortbeispielen und Antwort-Codes finden Sie unter Bereitstellungs-APIs.

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