PEIQ Knowledge Base
[0-21] DAM API - Agency Reports
- Daniela Nguyen
- Melanie Lutz
Transportverfahren | Übertragung per Restful API (https) |
|---|---|
Objekt | Agenturmeldungen, Agenturtexte, Datenbanktabelle “DAgnText” |
Trigger | Request durch Drittsystem |
Typische Drittsysteme | Typische Anbindungen sind Drittsysteme zur Content-Erstellung für Online |
Beispieldaten | siehe unten |
Hier ist der Endpunkt zum Abholen von Agenturmeldungen über die DAM API beschrieben.
Der aktuelle Funktionsumfang kann über folgenden Link eingesehen werden: https://mt-master-create.peiq.cloud/damapi/damapi.html
Funktionalitäten
Abrufen von Agenturmeldungen
Inhaltsverzeichnis
Abrufen bestimmter Agenturmeldungen
GET /agencyreports/{id}
Ist die CID einer bestimmten Agenturmeldung bekannt, können über diesen DAM API Endpunkt Inhalt und Metadaten der Agenturmeldung abgefragt werden. Enthält eine Agenturmeldung Bilder, werden die CIDs der Bilder im Feld “images_ids“ ausgegeben.
Über den DAM API Endpunkt “GET /images/{id}/{resolution}” kann die Bilddatei abgerufen werden. Dazu mehr unter: https://peiq.atlassian.net/wiki/spaces/PPSD/pages/1661665359/0-21+DAM+API+-+Images#Abrufen-der-Originalbilder
Beispiel: {baseUrl}/damapi/v1/agencyreports/1-16058888
Folgende Informationen werden beim GET-Request zurückgegeben:
Beschreibung | DAM API Feld | PRINT NGEN Eigenschaft |
Ressort | category | IptcRes |
Inhalt der Agenturmeldung in XML-Struktur | content | Text |
In NGEN erstellt am | creation_timestamp | CED |
In NGEN erstellt von | creation_user | CEB |
Objektrecht/Copyright | credit | IptcOR |
Von der Agentur gesendet am | date_time_sent | IptcGD |
IDs der Bilder | images_ids | AgenturBilder |
Info | info | IptcInfo |
Stichworte | keywords | IptcSti |
Ort | location | IptcStadt |
In PRINT NGEN geändert am | modification_timestamp | CGD |
In PRINT NGEN geändert von | modification_user | CGB |
Nummer | number | IptcEN |
Revisionsnummer | revision | IptcRev |
Dienst | service_identifier | IptcDie |
Status | status | Status |
Titel der Agenturmeldung | title | IptcUeb |
Priorität | urgency | IptcPri |
Usecase
Eine Agenturmeldung kann per Drag & Drop von CREATE in das Drittsystem für die Content-Erstellung übertragen werden. Beim Drop der Agenturmeldung ins Drittsystem kommt die CID der Agenturmeldung aus PRINT NGEN mit.
"{\"peiqResources\":[{\"type\":\"article\",\"objId\":\"DAgnText/1-16058888\"}]}"Mit der CID aus der Drop-Information kann das Drittsystem nun Inhalt und Metadaten der Agenturmeldung über den DAM API-Endpunkt “GET /agencyreports/{id}” abrufen.
{baseUrl}/damapi/v1/agencyreports/1-16058888Enthält die Agenturmeldung Bilder, können diese über den DAM API Endpunkt “GET /images/{id}/{resolution}” abgerufen werden.
Der Inhalt der Agenturmeldung und die angehängten Bilder können nun in die Artikelerfassungsmaske des Drittsystems eingefügt werden.
Mehr dazu unter: https://peiq.atlassian.net/wiki/x/OACHbg
Verwandte Seiten
Nur für PEIQ-Mitarbeiter: