Kunstmuseum API: verschil tussen versies

Uit Kunstmuseum API
Naar navigatie springen Naar zoeken springen
Geen bewerkingssamenvatting
Regel 6: Regel 6:


== Datastructuur ==
== Datastructuur ==
In de API hebben we momenteel [[Special:ListProperties|eigenschappen]] aangemaakt die alle tekstvelden zijn (weergavetekst) bij de import. In een latere fase willen we dat deze eigenschappen bij de import voorzien zijn van een externe identifier (bijvoobeeld RKD-artist) waarna we een vervaardiger aanmaken met entity referentie.
In de API hebben we verschillende [[Special:ListProperties|eigenschappen]]. Deze eigenschappen hebben een kwalifier waarin in een tekstveld de presentatietekst wordt opgeslagen. Vervolgens draaien er scripts die uit de presentatietekst zoveel mogelijk de eigenschappen bij de import voorzien zijn van een item.


== Infrastructuur ==
== Infrastructuur ==

Versie van 20 jun 2022 11:18

Inleiding

api.kunstmuseum.nl is opgezet om objecten, tentoonstellingen en andere gebeurtenissen als Linked Open Data te verstrekken. Hiervoor is een query service aanwezig waarbij de informatie via SPARQL bevraagd kan worden. Daarnaast kan de informatie ook via een REST-API uitgelezen worden.

Dataset

De data is momenteel fragmentarisch. De service is oorspronkelijk opgezet om de content voor de website Delftsaardewerk.nl vanuit verschillende musea te importeren en te leveren via de API. Daarna is het ook ingezet voor van Gogh Worldwide. Daarna volgde het project Aziatisch keramiek.

Datastructuur

In de API hebben we verschillende eigenschappen. Deze eigenschappen hebben een kwalifier waarin in een tekstveld de presentatietekst wordt opgeslagen. Vervolgens draaien er scripts die uit de presentatietekst zoveel mogelijk de eigenschappen bij de import voorzien zijn van een item.

Infrastructuur

Als triplestore wordt gebruik gemaakt van een Wikibase-installatie.

API

De API is benaderbaar via https://api.kunstmuseum.nl/api.php

Een voorbeeld om item Q1 op te vragen: https://api.kunstmuseum.nl/api.php?action=wbgetentities&ids=Q1&format=jsonfm

SPARQL-queries zijn mogelijk via https://api.kunstmuseum.nl/query/

Het SPARQL-endpoint is te vinden op https://api.kunstmuseum.nl/query/proxy/wdqs/bigdata/namespace/wdq/sparql

Er moeten voorlopig verplicht prefixen meegegeven worden:
PREFIX wd: <https://api.kunstmuseum.nl/entity/>
PREFIX wds: <https://api.kunstmuseum.nl/entity/statement/>
PREFIX wdv: <https://api.kunstmuseum.nl/value/>
PREFIX wdt: <https://api.kunstmuseum.nl/prop/direct/>
PREFIX wikibase: <http://wikiba.se/ontology#>
PREFIX p: <https://api.kunstmuseum.nl/prop/>
PREFIX xsd: <http://www.w3.org/2001/XMLSchema#>
Achtergrond over de Wikibase API is hier te vinden: https://www.mediawiki.org/wiki/Wikibase/API

Testcollectie

Een eerste testcollectie is opgezet met van Gogh Worldwide