...
| Info |
|---|
Mit der hier beschriebenen Exportfunktion können Bilder durch Dritte via Restful API gesucht werden (Ergebnisliste mit Metadaten und Preview-Link) und Bilder in verschiedenen Auflösungen von PRINT NGEN in das Drittsystem exportiert werden. |
Inhaltsverzeichnis
| Expand | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Funktionalitäten der DAM-API
Mit der hier beschriebenen Exportfunktion können Bilder durch Dritte via Restful API abgefragt werden und in verschiedenen Auflösungen von PRINT NGEN in das Drittsystem exportiert werden.
...
https://testweb.impuls.peiq.cloud/apis/damapi.html
Austauschformat und Übertragung der Daten
Metadaten der Bild-Daten, die übertragen werden können
Pixeldaten
IPTC-Daten (geänderte Metadaten optional)
Bildunterschrift (optional)
Ort/Stadt (optional)
Kategorien (optional)
Empfohlene Verwendung der DAM API
Suche nach bestimmten Bildern
GET /images/search
Von einem Drittsystem aus können per DAM API Bildersuchen (mit bestimmten Suchbedingungen z.B. bestimmten Kategorien) im PEIQ DAM abgesetzt werden. Im Anschluss können die gefundenen Bilder bei Bedarf in der gewünschten Auflösung über die DAM API abgeholt werden.
Abrufen der neuesten Bilder
GET /images/latest
Ein Drittsystem kann die neuesten Bilder per DAM API abrufen. Diese Bilder können im Anschluss in der gewünschten Auflösung über die DAM API abgeholt werden.
Abrufen der Originalbilder
GET /images/{id}/{resolution}
Wurden z.B. über den EPaper-Export die beschnittenen Bilder (Hard-Crop) exportiert und die IDs der zugehörigen Originalbilder (unbeschnitten) sind bekannt, können die Originalbilder per DAM API in der gewünschten Auflösung abgeholt werden.
Abrufen der Bild-Metainformationen
GET /images/{id}
Sind die IDs der Bilder bekannt, kann ein Drittsystem kann folgende Bild-Metainformationen über die DAM API abrufen, um die Bilder unterscheiden und einordnen zu können:
Beschreibung | DAM-API Feld | NGen Eigenschaft |
ArchivID | archive_id | DBildArchivID |
Caption | caption | Text/ |
ErstelltAm | creation_timestamp | CED |
ErstelltVon | creation_user | CEB |
Bilddateiname | filename | BildDateiName |
Honorarkürzel | honorar_id | DBildHonEmpfaenger |
Bildursprung | origin | BildUrsprung |
OriginalID | original_id | COID |
CID | id | CID |
Autorname | by_line | IptcAN |
Ressort | category | IptcRes |
Ort | location | IptcStadt |
Objektrecht/Copyright | credit | IptcOR |
Land | country | IptcLand |
Aufnahmedatum | date_time_created | IptcED |
Objektname | object_name | IptcON |
Dienst | service_identifier | IptcDie |
Quelle | source | IptcQue |
Kommentar | special_instructions | IptcKom |
Titel/Überschrift | title | IptcUeb |
Priorität | urgency | IptcPri |
Status | status | Status |
BU | underline | Text/BU |
Bildquelle innerhalb der BU | image_source | Text/BU/Bildquelle |
Schlagwörter | keywords
| SchlagwortXml |
GeändertAm | modification_timestamp | CGD |
GeändertVon | modification_user | CGB |
Verwendungshinweis für zurückgezogene Bilder | usage_instructions | DBildVerwendungsHinweis |
Bildbreite in Pixel | width | BildPixelX |
Bildhöhe in Pixel | height | BildPixelY |
SHA1-Wert | sha1 | SHA1 |
Bildausschnitt (wird als relatives Rechteck in 1/10000 Einheiten ausgegeben) | area
| BildAusschnitt |
Anlegen von neuen Originalbildern
POST /images
Ein Drittsystem kann Bilder über die DAM API nach PRINT NGEN importieren. Die Bilder laufen als Originalbilder ohne Mindestverschlagwortung ein.
Maßgebliche DB-Tabellen
DBild
Verwandte Seiten
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|
| Include Page | ||||
|---|---|---|---|---|
|
Optionale, weitergehende Infos (auf Anfrage)
/wiki/spaces/CORE/pages/915931174
Historie
| Change History |
|---|