REST-Service/Web API
Sie können öffentliche Datenbank-Inhalte (einschließlich deren Vorkommen im Text der »Teutschen Academie«, Bezügen zu anderen Datenbank-Objekten sowie Referenzen auf externe Datenquellen) über eine REST-Schnittstelle abrufen.
Benutzung und URL-Schema
Die URLs haben generell diese Struktur:http://ta.sandrart.net/services/rest/person/1
Dabei ist der hier verwendete Wert person ein Beispiel für die Objekt-Domain und 1 ein Beispiel für die Objekt-ID. Die Objekt-Domain kann eine der folgenden vier Zeichenketten sein:
artworkpersonplacebibliograpy
Um beispielsweise die Daten für die Kunstwerke mit den IDs 2026 bzw. 329 abzurufen, rufen Sie bitte
folgende URL auf:
http://ta.sandrart.net/services/rest/artwork/2026
bzw.
http://ta.sandrart.net/services/rest/artwork/329
Analog dazu erhielten Sie die Personen-Einträge für Hans von Aachen (Personen-ID 2162) und Leon Battista Alberti (Personen-ID 114) über folgende URLs:
http://ta.sandrart.net/services/rest/person/2162
bzw.
http://ta.sandrart.net/services/rest/person/114
Abfragen anhand von externen Identifiern
Um automatisiert Objekt-IDs von Sandrart.net herauszufinden, können Identifier (Inventarnummern, PURLs o.ä.) externer Referenzen verwendet werden, die in unseren
Daten vorhanden sind. Das URL-Schema hierfür ist:
http://ta.sandrart.net/services/rest/ref/QUELLE?id=ID
Die Referenzquellen entnehmen Sie bitte folgender Liste:
| Identifier für Referenzquelle | Name der Referenzquelle |
|---|---|
Arachne |
Arachne |
BritishMuseum |
British Museum |
Census |
Census |
GeoNames |
GeoNames |
GKD |
Gemeinsame Körperschaftsdatei (GKD) |
GoogleBooks |
Google Books |
KHM |
Kunsthistorisches Museum Wien |
NationalGallery |
National Gallery London |
PND |
Personennamendatei (PND) |
Rijksmuseum |
Rijksmuseum Amsterdam |
SWD |
Schlagwortnormdatei (SWD) |
TGN |
Getty Thesaurus of Geographic Names (TGN) |
ULAN |
Getty Union List of Artist Names (ULAN) |
VD16 |
VD16 |
VD17 |
VD17 |
VIAF |
Virtual Internet Authority File (VIAF) |
VKK |
Virtuelles Kupferstichkabinett |
Je nach Referenzquelle ist eine unterschiedliche Art von Identifier zu übergeben: im Fall des VIAF ist es natürlich die VIAF-Personen-ID, im Fall des Virtuellen Kupferstichkabinetts etwa eine PURL oder bei der Datenbank »Census« die numerische »CensusID«.
Beispiel 1: Personenrecherche anhand der PND-ID. Wenn Sie bereits über die PND-ID der gesuchten Person verfügen
(z.B. 118643525), können Sie über den Aufruf von http://ta.sandrart.net/services/rest/ref/PND?id=118643525 den ggf. vorhandenen Personen-Eintrag in Sandrart.net in Erfahrung bringen.
Beispiel 2: Kunstwerkrecherche via PURL des Virtuellen Kupferstichkabinetts. Um herauszufinden, ob innerhalb von Sandrart.net Daten zu dem Kunstwerk mit der PURL http://kk.haum-bs.de/?id=j-falck-ab3-0008 vorliegen, würden Sie diese URL verwenden:
http://ta.sandrart.net/services/rest/ref/VKK?id=http://kk.haum-bs.de/?id=j-falck-ab3-0008
In diesem Beispiel werden Sie als Ergebnis erhalten, dass das Kunstwerk-Objekt, das bei Sandrart.net die ID 273 besitzt, dem durch die genannte PURL identifizierten Werk entspricht. Sie können diese Kunstwerk-ID nun verwenden, um nach dem zuvor beschriebenen Schema die Daten des Kunstwerkes sowie ggf. Erwähnungen in der »Teutschen Academie«
abzufragen.
HTTP-Status-Codes:
- 200: Ressource existiert, Daten werden ausgegeben
- 400: Im Fall fehlerhafter oder ungenügender Request-Daten
- 404: Domain oder Ressource existiert nicht
JSON
Standardmäßig werden die Daten als XML mit Mime-Type text/xml ausgeliefert; alternativ können Sie jedoch auch JSON erhalten. Zu diesem Zweck hängen Sie bitte ?json=1 an die URL an. Content-Type-Negotiation auf Basis des HTTP-Accept-Headers findet nicht statt. Der Mime-Type der Response ist im Fall von JSON application/json.
Caching
Da die Arbeiten an dieser Edition abgeschlossen sind, können die empfangenen Daten problemlos auch über längere Zeiträume gecached werden.
Serverseitig werden keine Caching-bezogenen Mechanismen (namentlich ETags und If-Modified-Since) unterstützt.
Lizenz
Die über die hier beschriebene API zugänglich gemachten Inhalte werden unter einer Creative Commons-“BY-NC-SA”-Lizenz veröffentlicht. Genauere Informationen hierzu finden Sie unter http://creativecommons.org/licenses/by-nc-sa/3.0/.