DAMINION ONLINE-HILFE

Rest API Schnittstelle

 

 

Daminion Server Rest API (0.9 Beta)

Mit der REST-API Schnittstelle können Sie externe Anwendungen mittels HTTP-Methoden in den Daminion Server integrieren.
Damit können Sie Teilinformationen auslesen und Listen von z.B. Medienobjekten, Objekt-Eigenschaften oder von Tags erstellen lassen.

 

 

Base Url

Base url that you need to use in all queries is: http://hostname:8090/api/

Where 8090 is a port that can be changed from the Daminion Server Administration Panel (File > Preferences > API)

 

GET /tags/savedSearches

Gets list of the saved searches

Url Structure:

/api/tags/savedSearches

Example of Usage:

http://localhost:8090/api/tags/savedSearches

Response:

<tagValues count="N">
<tagValue id="%value1%" name="%name1%"/>
<tagValue id="%value2%" name="%name2%"/>

<tagValue id="%valueN%" name="%nameN%"/>
</tagValues>


GET mediaitems/?savedSearchesId=

List media items imported into Daminion Server catalog according to a specified Saved Search.

Url Structure:

/api/mediaitems/?savedSearchesId=%savedSearchId%&offset=%offset%&limit=%limit%&[tags=%tags%]

Mandatory Query Parameters:

  • savedSearchId: saved search id (see GET /api/tags/savedSearches)
  • offset: 0-based starting index for the list of results.
  • limit: maximum number of results to return.

Optional Query Parameters: 

tags: what tags should be included into the response. Possible values are: none, all. Default is all.

Example of Usage:

http://localhost:8090/api/mediaitems?savedSearchesId=1&offset=0&limit=25

Response:

<mediaItems count="N">
<mediaItem id="%id%"
uri="http://%host%:%port%/api/mediaitems/%id%">
<tagValues>
<tagValue key="%tagGuid%" name="%tagName%">%value%</tagValue>
<tagValue key="%tagGuid2%" name="%tagName2%">%value2%</tagValue>

<tagValue key="%tagGuidN%" name="%tagNameN%">%valueN%</tagValue>
</tagValues>

</mediaItem>…
</mediaItems >

 

GET mediaitems/mediaItemId=

Lists tag values of a specified media item.

Url Structure:

/api/mediaitems/%mediaItemId%

Mandatory Query Parameters:

mediaItemId: media item id

Example of Usage:

http://localhost:8090/api/mediaitems/mediaItemId=%itemId%

Response:

<mediaItem id="%id%" uri="http://%host%:%port%/api/mediaitems/%id%">
<tagValues>
<tagValue key="%tagGuid%" name="%tagName%">%value%</tagValue>
<tagValue key="%tagGuid2%" name="%tagName2%">%value2%</tagValue>

<tagValue key="%tagGuidN%" name="%tagNameN%">%valueN%</tagValue>
</tagValues>
</mediaItem>

 


GET mediaitems/%itemId%/thumbnail?=

Gets thumbnail of a specified media item

Url Structure:

/api/mediaitems/%itemId%/thumbnail?size=%thumbnailSize%

Mandatory Query Parameters:

itemId:media item id

Optional Query Parameters:

size:size of the output thumbnail. Possible values are: small, medium, large. Default is medium.

Example of Usage:

http://localhost:8090/api/mediaitems/75/thumbnail?size=large

Response:

Returns “image/jpeg” thumbnail.

 

GET /mediaitems/%itemId%/preview

Gets preview of a specified media item

Url Structure:

/api/mediaitems/%itemId%/preview

Mandatory Query Parameters:

itemId: media item id

Example of Usage:

http://localhost:8090/api/mediaitems/75/preview

Response:

Returns “image/jpeg” preview


GET /tags

Gets list of the tag specifications.

Url Structure:

/api/tags

Example of Usage:

http://localhost:8090/api/tags

Response:

<tags count="N">
<tag key="%tagGuid1%" name="%tagName1%"/>
<tag key="%tagGuid2%" name="%tagName2%"/>

<tag key="%tagGuidN%" name="%tagNameN%"/>
</tags>

 

KAPITELÜBERSICHT

 

Daminion Installieren
 
Installation Daminion Standalone (Client) 
 
Registrierung Ihrer Daminion Standalone Lizenz

 Installation Daminion Server 
 
Registrierung Ihrer Daminion Server Lizenz  

 

 

Arbeiten mit Daminion

Importieren

 Dateien importieren
 Import-Einstellungen sperren
 Neu importierte Tags bestätigen
 Dateien von CSV Datei importieren
 Dateiformate oder Ordner vom Import ausschließen (Importfilter)
 Ein unbekanntes Dateiformat importieren (Importfilter)
 Ordnerinhalt automatisch aktualisieren
 Automatische Ordnerüberwachung
 Ordnerinhalt manuell aktualisieren
 Lokale Kataloge importieren
 Kamera-RAW Dateien beim Import in DNG umwandeln
 Adobe Lightroom Daten nach Daminion importieren
 Canto Cumulus Daten nach Daminion importieren


 Arbeiten mit Tags

 Verwendung von Tags
 Tags erstellen, zuweisen und entfernen im Eigenschaften Panel 
 
Tags erstellen, zuweisen und löschen im Katalog Tags Panel 
 
Gruppen-Tag erstellen mit dem Katalog Tags Panel   
 
Tag Vorgaben erstellen und zuweisen 
 
Benutzerdefiniertes Tag erstellen
 Tag-Bearbeitung für andere Nutzer sperren
 Tags in Datei schreiben und auslesen
 Tags von einem Element auf andere übertragen
 Zugriff auf zuletzt zugewiesene Tags
 Farbmarkierung zuweisen
 Farbmarkierungsnamen ändern
 Sterne Bewertung zuweisen
 Elemente markieren 
 
Tag-Synonyme erstellen 
 
Ein Lizenz-Ablaufdatum setzen 
 
Kartenansicht für die GEO-Referenzierung 
 
Tag-Listen exportieren und importieren
 

Arbeiten mit Miniaturvorschaubildern

 Arten der Miniaturvorschaubilder und deren Bedeutung
 Miniaturvorschaubilder gruppieren
 Miniaturvorschaubilder drehen
 Anpassen der Informationen zu den Miniaturvorschaubildern 
 
Benutzerdefinierte Miniaturvorschaubilder hinzufügen
 Miniaturvorschaubilder für EPS- und Adobe Illustrator-Dateien erstellen
 Miniaturvorschaubilder für AutoCAD-Dateien erstellen
 Anzeigefarbe für Miniaturvorschaubilder mit transparenten Bereichen ändern 
 
Vorschauansichten beschleunigen

Verwaltung

 Bilder Vergleichsansicht 
 
Vollbildansicht
 Arbeiten mit dem Ordner Panel 
 
Ordner oder Element neu verknüpfen 
 
Verwenden der Ablage 
 
Wasserzeichen hinzufügen 
 
Dateien umbenennen
 Dateien mittels Vorlagen stapelweise umbenennen
 Erstellungsdatum von Elementen verschieben 
 
Erstellungsdatum von Elementen ändern
 Elemente aus Katalog entfernen
 Elemente untereinander verknüpfen  
 
Elemente im Windows-Explorer anzeigen
 Duplikate Kontrolle
 Vorschau-Fenster
 Arbeiten mit Sammlungen
 Nutzungsinformationen hinzufügen und einsehen


Suchen

 Schnelle Suche
 Erweiterte Suche 
 
Suchen mit dem Katalog Tags-Panel 
 
Tags zuweisen Modus im Katalog Tags-Panel 
 
Tags filtern im Katalog Tags-Panel 
 
Tags filtern im Eigenschaften-Panel
 Bilder im Internet finden


Exportieren

 Dateien exportieren
 Benutzerdefinierte Export Voreinstellungen 
 
Filesharing-Dienst einbinden (Dropbox)
 Elemente zum Bearbeiten auschecken (Versionskontrolle) 
 
Elemente extern bearbeiten oder ansehen
 E-Mail Versand
 Tags in CSV-Datei exportieren
 Kontaktabzug als PDF erstellen
 Elemente in einen anderen Katalog verschieben
 Drucken


Arbeiten mit Katalogen

 Funktionsweise von Katalogen 
 
Einen neuen Mehrbenutzer-Katalog erstellen
 Einen Mehrbenutzer-Katalog sperren oder freigeben
 Öffnen und Anmelden am Mehrbenutzer-Katalog
 Einen neuen lokalen Katalog erstellen
 Arbeiten mit mehreren gleichzeitig geöffneten Katalogen 
 
Sicherung und Wiederherstellung von Katalogen
 Katalog optimieren
 Der Web-Client


Daminion einrichten

 Daminion Grundeinstellungen
 Übersicht über das Daminion Hauptfenster 
 
Anpassen der Arbeitsoberfläche 
 
Konfigurieren des Browsers 
 
Anpassen des Katalog Tag-Panels
 Tag-Informationen anpassen im Eigenschaften-Panel 
 
Single Tag Modus im Katalog Tags Panel 
 
Automatische Synchronisation

 
(Server)

 
Daminion Server Administrations-Panel 
 
Daminion Server Metadaten Einstellungen
 Konfigurieren des Daminion Server Dienstes 
 
Benutzerverwaltung (User anlegen und Rechte vergeben) 
 
Zugangssteuerung
 Dateireplikation
 Windows NT (Active Directory) Authentifizierung
 Datensicherung der Daminion Server Daten 
 
Remote Zugang über das internet herstellen
 Web-Zugriff installieren
 Daminion Web-Client Unterstützung 

 

Weitere Informationen

 Das geeignete Speicherschema auswählen 
 
Datenspeicherung innerhalb der Mediendateien 
 
Systemanforderungen und technische Infos
 Liste der unterstützten Dateiformate 
 
Rest API Schnittstelle  
 
Tastaturkürzel