IN BEARBEITUNG
Transportverfahren | Übertragung per Restful API (https) |
|---|---|
Objekt | Bilder, PRINT NGEN-ID und Hash-Wert als eindeutige Merkmale |
Trigger | Request durch Drittsystem |
Typische Drittsysteme | Typische Anbindungen sind Drittsysteme zur Content-Erstellung für Online |
Beispieldaten | siehe unten |
Mit der hier beschriebenen Exportfunktion können Bilder durch Dritte via Restful API gesucht (Ergebnisliste mit Metadaten und Preview-Link) und Bilder in verschiedenen Auflösungen von PRINT NGEN in das Drittsystem exportiert werden.
Inhaltsverzeichnis
Funktionalitäten der DAM-API
Mit der hier beschriebenen Exportfunktion können Bilder durch Dritte via Restful API abgefragt und in verschiedenen Auflösungen von PRINT NGEN in das Drittsystem exportiert werden.
Typische Anbindung sind Drittsysteme zur Content-Erstellung für Online.
Der aktuelle Funktionsumfang kann über Swagger UI eingesehen 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 E-Paper-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 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
Optionale, weitergehende Infos (auf Anfrage)
/wiki/spaces/CORE/pages/915931174
Historie
| Version | Date | Comment |
|---|---|---|
| Current Version (v. 19) | 2022-06-15 12:59 | Former user |
| v. 32 | 2023-05-09 09:21 | Johanna Cüsters |
| v. 31 | 2023-05-09 09:10 | Johanna Cüsters |
| v. 30 | 2023-04-05 08:10 | Daniela Nguyen |
| v. 29 | 2023-04-03 14:37 | Daniela Nguyen |
| v. 28 | 2022-11-25 10:20 | Daniela Nguyen |
| v. 27 | 2022-08-22 09:39 | Alexander Steichele |
| v. 26 | 2022-08-05 12:26 | Former user |
| v. 25 | 2022-08-04 06:31 | Violetta Stegen |
| v. 24 | 2022-07-27 10:54 | Violetta Stegen |
| v. 23 | 2022-07-20 09:25 | Violetta Stegen |
| v. 22 | 2022-06-21 08:31 | Daniela Nguyen |
| v. 21 | 2022-06-21 06:16 | Violetta Stegen |
| v. 20 | 2022-06-17 14:27 | Daniela Nguyen |
| v. 19 | 2022-06-15 12:59 | Former user |
| v. 18 | 2022-06-10 14:01 | Daniela Nguyen |
| v. 17 | 2022-06-10 14:00 | Daniela Nguyen |
| v. 16 | 2022-05-17 09:49 | Daniela Nguyen |
| v. 15 | 2022-04-20 11:42 | Former user |
| v. 14 | 2022-02-21 10:55 | Violetta Stegen |
| v. 13 | 2022-02-21 10:54 | Violetta Stegen |
| v. 12 | 2022-02-15 09:35 | Violetta Stegen |
| v. 11 | 2022-02-15 09:30 | Violetta Stegen |
| v. 10 | 2022-02-14 12:53 | Violetta Stegen |
| v. 9 | 2022-02-11 14:45 | Manh Long Nguyen |
| v. 8 | 2022-02-03 10:46 | Violetta Stegen |
| v. 7 | 2022-02-02 12:25 | Violetta Stegen |
| v. 6 | 2022-02-02 10:06 | Violetta Stegen |
| v. 5 | 2022-02-01 11:12 | Violetta Stegen |
| v. 4 | 2022-01-31 12:24 | Violetta Stegen |
| v. 3 | 2022-01-31 12:08 | Violetta Stegen |
| v. 2 | 2022-01-31 12:07 | Violetta Stegen |
| v. 1 | 2021-11-03 14:25 | Katharina Marxreiter |