AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.
Die Assets-HTTP-API ermöglicht CRUD-Vorgänge (Create-Read-Update-Delete, Erstellen/Lesen/Aktualisieren/Löschen) für digitale Assets, einschließlich Metadaten, Ausgabedarstellungen und Kommentaren sowie strukturierten Inhalten mit Experience Manager-Inhaltsfragmenten. Sie wird unter /api/assets
bereitgestellt und als REST-API implementiert.
So greifen Sie auf die API zu:
https://[hostname]:[port]/api.json
.https://[hostname]:[server]/api/assets.json
führt.Die API antwortet mit einer JSON-Datei für einige MIME-Typen und einem Antwort-Code für alle MIME-Typen. Die JSON-Antwort ist optional und kann zum Beispiel nicht für PDF-Dateien verfügbar sein. Verwenden Sie den Antwort-Code für weitere Analysen oder Aktionen.
Nach der Ausschaltzeit sind ein Asset und seine Ausgabedarstellungen weder über die Assets-Web-Oberfläche noch über die HTTP-API verfügbar. Die API gibt die Fehlermeldung 404 zurück, wenn die Einschaltzeit in der Zukunft oder die Ausschaltzeit in der Vergangenheit liegt.
Die HTTP-API aktualisiert die Metadateneigenschaften im jcr
-Namespace. Die Experience Manager-Benutzeroberfläche aktualisiert jedoch die Metadateneigenschaften im dc
-Namespace.
Die Assets-HTTP-API stellt zwei wichtige Elemente, Ordner und Assets bereit (für Standard-Assets).
Ordner verhalten sich wie Verzeichnisse in traditionellen Dateisystemen. Sie sind Container für andere Ordner oder Asserts. Ordner enthalten folgende Komponenten:
Entitäten: Zu den Entitäten eines Ordners zählen die untergeordneten Elemente, z. B. die Ordner und Assets.
Eigenschaften:
name
ist der Name des Ordners. Dies entspricht dem letzten Segment im URL-Pfad ohne die Erweiterung.title
Ist ein optionaler Titel des Ordners, der anstelle des Namens angezeigt werden kann.Einige Eigenschaften des Ordners oder Assets sind einem anderen Präfix zugeordnet. Das jcr
-Präfix von jcr:title
, jcr:description
und jcr:language
werden mit dem dc
-Präfix ersetzt. Daher enthalten im zurückgegebenen JSON dc:title
und dc:description
die Werte aus jcr:title
bzw. jcr:description
.
Links-Ordner stellen drei Links bereit:
self
: Link zu sich selbst.parent
: Link zum übergeordneten Ordner.thumbnail
: (Optionaler) Link zu einem Ordnerminiaturbild.In Experience Manager enthalten Assets die folgenden Elemente:
In Experience Manager enthält ein Ordner die folgenden Komponenten:
Die Assets-HTTP-API bietet die folgenden Funktionen:
Zur besseren Lesbarkeit der folgenden Beispiele wird die vollständige cURL-Notation weggelassen. Tatsächlich korreliert die Notation mit Resty, dem Skript-Wrapper für cURL
.
Voraussetzungen
https://[aem_server]:[port]/system/console/configMgr
zu.POST
, PUT
, DELETE
.Ruft eine Siren-Darstellung eines vorhandenen Ordners und seiner untergeordneten Entitäten ab (Unterordner oder Assets).
Anfrage: GET /api/assets/myFolder.json
Antwort-Codes: Die Antwort-Codes sind:
Antwort: Die Klasse der zurückgegebenen Entität ist ein Asset oder ein Ordner. Die Eigenschaften der enthaltenen Entitäten bilden eine Teilmenge der vollständigen Eigenschaften jeder Entität. Um eine vollständige Darstellung der Entität zu erreichen, sollten Kunden den Inhalt der URL abrufen, auf die der Link mit einem rel
von self
verweist.
Erstellt einen neuen Ordner sling
: OrderedFolder
im festgelegten Pfad. Wenn statt eines Knotennamens ein *
angegeben wird, verwendet das Servlet den Parameternamen als Knotennamen. Akzeptiert als Anfragedaten wird entweder eine Siren-Darstellung des neuen Ordners oder ein Satz von Name-Wert-Paaren, kodiert als application/www-form-urlencoded
oder multipart
/ form
- data
. Dies ist dann sinnvoll, wenn Sie einen Ordner direkt aus einem HTML-Formular erstellen. Zusätzlich können die Eigenschaften des Ordners als URL-Abfrageparameter angegeben werden.
Wenn der übergeordnete Knoten des angegebenen Pfades nicht vorhanden ist, schlägt der API-Aufruf mit einem Antwort-Code 500
fehl. Ein Aufruf gibt einen Antwort-Code 409
zurück, wenn der Ordner bereits vorhanden ist.
Parameter: name
ist der Ordnername.
Anfrage
POST /api/assets/myFolder -H"Content-Type: application/json" -d '{"class":"assetFolder","properties":{"title":"My Folder"}}'
POST /api/assets/* -F"name=myfolder" -F"title=My Folder"
Antwort-Codes: Die Antwort-Codes sind:
Platzieren Sie die bereitgestellte Datei im angegebenen Pfad, um ein Asset im DAM-Repository zu erstellen. Wenn statt eines Knotennamens ein *
angegeben wird, verwendet das Servlet den Parameter- oder Dateinamen als Knotennamen.
Parameter: Die Parameter sind name
für den Asset-Namen und file
für die Dateireferenz.
Anfrage
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"
Antwort-Codes: Die Antwort-Codes sind:
Aktualisiert eine Asset-Binärdatei (Ausgabedarstellung mit Originalnamen). Bei einer Aktualisierung wird der standardmäßige Asset-Verarbeitungs-Workflow ausgeführt, sofern er konfiguriert ist.
Anfrage: PUT /api/assets/myfolder/myAsset.png -H"Content-Type: image/png" --data-binary @myPicture.png
Antwort-Codes: Die Antwort-Codes sind:
Aktualisiert die Asset-Metadateneigenschaften. Wenn Sie eine Eigenschaft im dc:
-Namespace aktualisieren, aktualisiert die API dieselbe Eigenschaft im jcr
-Namespace. Die API synchronisiert die Eigenschaften unter den beiden Namespaces nicht.
Anfrage: PUT /api/assets/myfolder/myAsset.png -H"Content-Type: application/json" -d '{"class":"asset", "properties":{"jcr:title":"My Asset"}}'
Antwort-Codes: Die Antwort-Codes sind:
dc
- und dem jcr
-NamespaceDie API-Methode aktualisiert die Metadateneigenschaften im jcr
-Namespace. Die mithilfe der Touch-optimierten Benutzeroberfläche vorgenommenen Aktualisierungen ändern die Metadateneigenschaften im dc
Namespace. Zum Synchronisieren der Metadatenwerte zwischen dem dc
- und dem jcr
-Namespace können Sie einen Workflow erstellen und Experience Manager so konfigurieren, dass der Workflow bei der Asset-Bearbeitung ausgeführt wird. Verwenden Sie ein ECMA-Skript zum Synchronisieren der erforderlichen Metadateneigenschaften. Das folgende Beispielskript synchronisiert die Titelzeichenfolge zwischen dc:title
und 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();
}
}
Erstellt eine neue Asset-Ausgabedarstellung für ein Asset. Wenn der Name nicht als Anfrageparameter angegeben wurde, wird der Dateiname als Ausgabedarstellungsname verwendet.
Parameter: Die Parameter sind name
für den Namen der Ausgabedarstellung und file
als ein Dateiverweis.
Anfrage
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"
Antwort-Codes: Die Antwort-Codes sind:
Aktualisiert bzw. ersetzt eine Asset-Ausgabedarstellung durch die neuen Binärdaten.
Anfrage: PUT /api/assets/myfolder/myasset.png/renditions/myRendition.png -H"Content-Type: image/png" --data-binary @myRendition.png
Antwort-Codes: Die Antwort-Codes sind:
Erstellt einen neuen Asset-Kommentar.
Parameter: Die Parameter sind message
für den Nachrichtentext des Kommentars und annotationData
für die Anmerkungsdaten im JSON-Format.
Anfrage: POST /api/assets/myfolder/myasset.png/comments/* -F"message=Hello World." -F"annotationData={}"
Antwort-Codes: Die Antwort-Codes sind:
Kopiert einen Ordner oder ein Asset in dem angegebenen Pfad in ein neues Ziel.
Anfrage-Header: Die Parameter sind:
X-Destination
– ein neuer Ziel-URI im Bereich der API-Lösung, in den die Ressource kopiert werden soll.X-Depth
– entweder infinity
oder 0
. Mit 0
werden nur die Ressource und ihre Eigenschaften kopiert und nicht ihre untergeordneten Elemente.X-Overwrite
– Verwenden Sie F
, um ein Überschreiben eines Assets am vorhandenen Ziel zu verhindern.Anfrage: COPY /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-copy"
Antwort-Codes: Die Antwort-Codes sind:
Verschiebt einen Ordner oder ein Asset in dem angegebenen Pfad in ein neues Ziel.
Anfrage-Header: Die Parameter sind:
X-Destination
– ein neuer Ziel-URI im Bereich der API-Lösung, in den die Ressource kopiert werden soll.X-Depth
– entweder infinity
oder 0
. Mit 0
werden nur die Ressource und ihre Eigenschaften kopiert und nicht ihre untergeordneten Elemente.X-Overwrite
Verwenden Sie entweder T
, um das Löschen einer vorhandenen Ressource zu erzwingen, oder F
, um das Überschreiben einer vorhandenen Ressource zu verhindern.Anfrage: MOVE /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-moved"
Antwort-Codes: Die Antwort-Codes sind:
Löscht eine Ressource(nstruktur) im angegebenen Pfad.
Anfrage
DELETE /api/assets/myFolder
DELETE /api/assets/myFolder/myAsset.png
DELETE /api/assets/myFolder/myAsset.png/renditions/original
Antwort-Codes: Die Antwort-Codes sind: