Page Comparison

Funktionalitäten der Images-Endpunkte der DAM API

• Anlegen von Bildern

• Suche nach Bildern

• Abrufen von Wertelisten für die Bildsuche

• Abrufen der neusten Bilder

• Abrufen der Bilddateien

• Abrufen der Bild-Metainformationen

• Ändern der Bild-Metainformationen

...

Bei der Übertragung des Bildes wird die Dateigröße überprüft. Die maximal zulässige Größe einer hochzuladenden Datei ist 104857600 beträgt 104.857.600 Bytes (100 MB). 

Optional kann im in der URL des Request mit dem Parameter “filename” ein Dateiname mitgegeben werden, der in die PRINT NGEN Eigenschaft BildDateiName “BildDateiName” übernommen wird. Ist beim Dateinamen die Fileextension File-Extension enthalten, wird diese herausgefiltert. Beispiel: {baseUrl}/images?filename=test123.jpg 

Bevorzugt ein Drittsystem die Übertragung per sFTP gegenüber der Übertragung per API, können Bilder alternativ auch über die Schnittstelle [0-22] INBOUND Bilder (Archiv) übertragen werden.

Sollen zudem zu den in der Bilddatei enthaltenen IPTC-Daten auch zusätzliche Metadaten per Metadaten-XML mitgegeben werden bzw. Updates der Bilder bzw. Metadaten erfolgen, können Bilder auch über die Schnittstelle [0-10-4] INBOUND Bilder mit Metadaten-XML übertragen werden.

...

• projectId:

  • Bei projectId="create" wird nur eine Suche unter den CREATE-Bildern abgesetzt.

  • Bei projectId="original" wird unter allen Originalbildern (Status in NGen PRINT NEGN = Original“Original”) gesucht.

  • Bei projectId="dam" wird unter allen Original- und Archivbildern (Status in NGen PRINT NGEN = Original “Original” oder Archiviert“Archiviert”) gesucht.

  • Die Angabe der projectId ist obligatorisch.

• limit: Anzahl der Bilder, die gesucht werden sollen

• search: Volltextsuche

• categories: Ressort (IptcRes)

• services: Dienst (IptcDie)

• credit: Objektrecht (IptcOR)

• sentFrom: Erstellt ab

• sentTo: Erstellt bis

• offset oder offsetindex: Gibt an, wie viele Bilder in der Ergebnisliste am Anfang übersprungen werden sollen

...

Beim Endpunkt GET /images/search liefern die Ergebnisfelder folgende Inhalte:

• id: CID

• title: Titel/Überschirft (IptcUeb)

• caption: Caption (Text/|TagName!=BU| Text/BU)

• category: Ressort (IptcRes)

• credit: Objektrecht (IptcOR)

• location: Ort (IptcStadt)

• width: Bildbreite (BildPixelX)

• height: Bildhöhe (BildPixelY)

• object: Objekt (DBildObjekt)

• edition: Ausgabe (DBildAusgabe)

...

Ein Drittsystem kann eine Liste der Werte für die Suchparameter Ressort (categories“categories”) und Dienst (services“services”) für die anschließende Bildsuche abrufen. Die zurückgegebenen Werte sind nur eine Auswahl der möglichen Suchwerte. Es kann auch mit anderen Werten als den aus der Liste gesucht werden.

Der Endpunkt images/values/categories gibt die Werte der PRINT NGEN Werteliste WL“WL_DBild_IptcRes IptcRes” zurück. Der Endpunkt images/values/services gibt die Werte der Werteliste WL“WL_DBild_IptcDie IptcDie” zurück.

Abrufen der neuesten Bilder

...

• projectId

• limit

• offset: Beim ersten Aufruf wird der Offset nicht angegeben. Dann kommt beim Ergebnis ein Offset zurück, der beim nächsten Aufruf wieder mitgegeben wird, um den nächsten Block aufzusetzen. Der Offset besteht aus der Kombination aus CED und CID eines Startbildes (z. B. "20211117-11:52:58/1-16114101").

• offsetindex: Dieser enthält die Zahl der Bilder, die in der Ergebnisliste am Anfang übersprungen werden. Übergibt man also offsetindex“offsetindex=100 100” so werden die ersten 1-100 Bilder nicht mit ausgeliefert, sondern erst ab dem 101. Bild.

Abrufen der Originalbilder

...

Sind die IDs der Bilder bekannt, kann ein Drittsystem folgende Bild-Metainformationen über die DAM API abrufen, um diese auch im Drittsystem z. B. für Bildersuchen zur Verfügung zu haben:

Beispiel: {baseUrl}/images/1-16116144

Ändern von Metadaten bestehender PRINT NGEN

...

Bilder

PUT /images/{id}

Ein Drittsystem kann Metadaten bestehender PRINT NGEN - Bilder ändern. In PRINT NGEN ändern sich damit nicht die Binärdaten der Bilddatei, sondern lediglich die am Bild gespeicherten Eigenschaften.

...

^{Nur für PEIQ-Mitarbeiter:}

/wiki/spaces/CORE/pages/915931174