DokumentationAEMBenutzerhandbuch

[AEM Assets]{class="badge positive" title="Gilt für AEM Assets)."}

Bereitstellungs-APIs delivery-apis

Letzte Aktualisierung: 10. März 2026
  • Gilt für:
  • Experience Manager as a Cloud Service

Erstellt für:

  • User

Alle genehmigten Assets, die im Experience Manager-Asset-Repository verfügbar sind, können durchsucht 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
Convenience-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, Erstellungsdatum, Ä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.
IMPORTANT
Sie können jeden Modifikator testen, der nicht allgemein über experimentelle APIs verfügbar ist. Zum Beispiel: Klicken Sie hier, um mehr über die Verwendung der experimentellen APIs zu erfahren und die vollständige Liste der Modifikatoren anzuzeigen.

Dynamic Media mit OpenAPI-Funktionen unterstützt auch langformatige Videos. Es werden Videos mit bis zu 50 GB und einer Länge von bis zu 2 Stunden unterstützt.

Informationen zu den verfügbaren Dynamic Media-Angeboten und deren Funktionen finden Sie unter Dynamic Media Prime und Ultimate.

NOTE
Kundinnen und Kunden von DM Prime können grundlegende Bildmodifikatoren verwenden, einschließlich Drehen, Zuschneiden, Spiegeln, Höhe, Breite und Qualität. Die intelligente Bildbearbeitung unterstützt AVIF für Kundinnen und Kunden von DM Prime nicht.

Bereitstellungs-API-Endpunkte delivery-apis-endpoint

Die API-Endpunkte variieren je nach Bereitstellungs-API. Der API-Endpunkt für Web-optimized binary representation of the asset in the requested output format API lautet beispielsweise:

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.

Siehe auch

recommendation-more-help
experience-manager-cloud-service-help-main-toc