Museum-Digital :: Handbuch

md:term

Informationen Auslesen bei bekannter ID

 Über die API von md:term können Informationen aus den kontrollierten Vokabularen von Museum-Digital ausgelesen werden. Die bei Museum-Digital selbst gebrauchten Vokabulare sind hierbei die für

Diese sind bisher verfügbar in Deutsch (md-de) und Ungarisch (md-hu). Die URL zum Abrufen der jeweiligen Datensätze setzt sich wie folgt zusammen:

Zusammensetzung der URLhttps://www.museum-digital.de/term/ + Version (md-de oder md-hu) + / + Vokabular (tag/persinst/...) + / + ID des Eintrags + / + Format (html/json/skos)

Das Format ist hierbei optional. Ist dieses nicht angegeben, wird eine Übersicht der Informationen in HTML zurückgegeben. Alternative Ausgabeformate sind JSON und SKOS.

In md:term suchen

Der Vokabularbrowser md:term bietet eine Suche nach Informationen aus den Vokabularen. Entspricht das über den Suchparameter search gesuchte Schlagwort, die gesuchte Person etc. genau dem Titel eines vorhandenen Eintrags, so wird über einen HTTP-header eine Weiterleitung auf die entsprechende Seite ausgegeben. Hierdurch ist die ID des gesuchten Eintrags findbar.

Sollte es keine direkte Entsprechung geben, wird eine Liste der Ergebnis-IDs und der den jeweiligen Einträgen entsprechenden Titel angezeigt. Die Ergebnisliste bei Ausgaben in JSON ist hierbei immer auf 20 Einträge beschränkt.

GET-Parameter

Parameter Pflicht? Default Akzeptierte Werte Beschreibung
search Ja     Suchbegriff
kind Nein   Vokabular|Version Das Vokabular und die Version in der gesucht werden soll.
Setzt sich aus Vokabular und Version, getrennt durch einen senkrechten Strich, zusammen.
output Nein html html, json Ausgabeformat der Objektinformationen

Beispiel

Frage: Welche Ergebnisse kennt eine Suche nach Hel im Schlagwortvokabular?

Beispielcurl "https://www.museum-digital.de/term/redir.php?search=Hel&kind=tag|md-de&output=json"

 

 

Zuletzt bearbeitet: 2017-07-29