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>

 

Inhaltsverzeichnis

Installation

● Installation Daminion Server
● Installation Daminion Standalon (Client)
● Systemanforderungen
● Aktivieren der Daminion Server Lizenz
● Aktivieren der Daminion Standalone Lizenz

Mediendateien Importieren

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

Arbeiten mit Tags

● Verwendung von Tags
● Tags erstellen, zuweisen und entfernen im Eigenschaften Panel
● Tags erstellen, zuweisen und entfernen im Katalog Tags Panel
● Gruppen-Tags erstellen mit dem Katalog Tags Panel
● Tag Vorgaben erstellen und zuweisen
● Ein benutzerdefiniertes Tag erstellen im Desktop-Client
● Ein benutzerdefiniertes Tag erstellen im Web-Client
● 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
● Farbmarkierungen zuweisen
● Sterne Bewertung
● Elemente markieren
● Tag-Synonyme erstellen
● Ein Lizenz-Ablaufdatum setzen
● Kartenansicht für GEO-Referenzierung
● Tag-Listen exportieren und importieren
● Gesichtserkennung

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
● Vorschauansicht beschleunigen

 Verwaltung

● Vergleichsansicht für mehrere Bilder
● Die Vollbildansicht
● Arbeiten mit dem Ordner-Panel
● Ordner oder Elemente neu verknüpfen
● Verwenden der Ablage im Desktop Client
● Verwenden der Ablage im Web-Client
● Wasserzeichen hinzufügen
● Dateien umbenennen
● Dateien mittels Vorlageneditor automatisch umbenennen
● Das Erstellungsdatum von Elementen zu einen anderen Zeitpunkt verschieben
● Das Erstellungsdatum einer Datei ändern
● Elemente aus Katalog entfernen
● Elemente untereinander verknüpfen
● Ein Element im Windows-Explorer öffnen
● Duplikate Kontrolle
● PDF-Vorschau im Web-Client
● Das Vorschaufenster
● Arbeiten mit Sammlungen
● Einem Element Nutzungsinformationen hinzufügen und einsehen
● Die Kommentarfunktion im Web-Client

Bilder suchen und finden

● Die Schnellsuche
● Die erweiterte Suche
● Suchen im Katalog Tags Panel im Desktop-Client
● Suchen im Katalog Tags Panel im Web-Client
● Tags filtern im Eigenschaften Panel
● Tags filtern im Katalog Tags Panel
● Bilder nach ihrer Dominanten Farbe suchen
● Tags zuweisen Modus im Katalog Tags Panel

Exportieren 

● Dateien aus einem Katalog exportieren
● Benutzerdefinierte Export-Voreinstellungen
● Filesharing Dienste einbinden
● Elemente zum Bearbeiten auschecken (Versionskontrolle)
● Elemente extern bearbeiten oder ansehen
● Elemente als E-Mail Anhang versenden
● Tags in CSV-Datei exportieren
● Einen Kontaktabzug als PDF-Datei erstellen
● Elemente in einen anderen Katalog verschieben
● Elemente Ausdrucken

Arbeiten mit Katalogen

● Funktionsweise von Katalogen
● Einen neuen Mehrbenutzer-Katalog erstellen
● Öffnen und anmelden am Mehrbenutzer-Katalog
● Einen neuen lokalen Katalog erstellen
● Arbeiten mit mehreren gleichzeitig geöffneten Katalogen
● Sicherung und Wiederherstellung von Katalogen
● Kataloge optimieren
● Kataloge im Web-Client
● Einen Mehrbenutzer-Katalog für bestimmte Benutzer sperren

Daminion einrichten

● Die Grundeinstellungen in Daminion
● Das Daminion Hauptfenster
● Anpassen der Arbeitsoberfläche
● Anpassen des Browswers
● Anpassen des Katalog Tag Panels
● Die anzuzeigenden Tag-Informationen im Eigenschaften Panel anpassen
● Der Single Tag Modus im Katalog Tags Panel
● Automatische Metadaten Synchronisation
● Das Server Administrations-Panel
● Metadaten Grundeinstellungen im Daminion Server
● Konfigurieren des Daminion Server Dienstes
● Die Benutzerverwaltung
● Zugriffssteuerung auf Ordner-Ebene im Web-Client
● Die Zugangssteuerung
● Active Directory Unterstützung
● Datensicherung der Daminion Server Daten
● Die Benutzer-Rollen konfigurieren
● Videovorschau im Web-Client aktivieren
● Die Warteschlange im Web-Client
● Den Web-Zugriff installieren

Tutorials

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

Nach oben