Kunstmuseum API: verschil tussen versies

Uit Kunstmuseum API
Naar navigatie springen Naar zoeken springen
Geen bewerkingssamenvatting
Geen bewerkingssamenvatting
Regel 1: Regel 1:
==Inleiding==
==Inleiding==
api.kunstmuseum.nl is een Wikibase-installatie die is opgezet om objecten voor de website https://delftsaardewerk.nl te kunnen leveren via de API.
api.kunstmuseum.nl is opgezet om objecten, tentoonstellingen en andere gebeurtenissen als Linked Open Data te verstrekken. Hiervoor is een [https://api.kunstmuseum.nl/query/#PREFIX%20wd%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fentity%2F%3E%0APREFIX%20wds%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fentity%2Fstatement%2F%3E%0APREFIX%20wdv%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fvalue%2F%3E%0APREFIX%20wdt%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fprop%2Fdirect%2F%3E%0APREFIX%20wikibase%3A%20%3Chttp%3A%2F%2Fwikiba.se%2Fontology%23%3E%0APREFIX%20p%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fprop%2F%3E%0APREFIX%20ps%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fprop%2Fstatement%2F%3E%0APREFIX%20pq%3A%20%3Chttps%3A%2F%2Fapi.kunstmuseum.nl%2Fprop%2Fqualifier%2F%3E%0APREFIX%20xsd%3A%20%3Chttp%3A%2F%2Fwww.w3.org%2F2001%2FXMLSchema%23%3E%0A%0ASELECT%20%3Fitem%20%3FitemLabel%20%0AWHERE%20%0A%7B%0A%20%20%23%3Fitem%20wdt%3AP4%20wd%3AQ9.%20%23is%20een%20mens%0A%20%20SERVICE%20wikibase%3Alabel%20%7B%20bd%3AserviceParam%20wikibase%3Alanguage%20%22%5BAUTO_LANGUAGE%5D%2Cnl%22.%20%7D%0A%7D 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 [[Project/Delftsaardewerk|Delftsaardewerk.nl]] vanuit verschillende musea te importeren en te leveren via de API. Daarna is het ook ingezet voor [[Project/van_Gogh_Worldwide|van Gogh Worldwide.]] Daarna volgde het project [[Project/Aziatisch keramiek|Aziatisch keramiek]].
== 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 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.


 
== Infrastructuur ==
Als triplestore wordt gebruik gemaakt van een Wikibase-installatie.


==API==
==API==

Versie van 20 jun 2022 11:04

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 momenteel 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.

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