Kunstmuseum API: verschil tussen versies
Geen bewerkingssamenvatting |
Geen bewerkingssamenvatting |
||
Regel 1: | Regel 1: | ||
==Inleiding== | ==Inleiding== | ||
api.kunstmuseum.nl | 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:
Achtergrond over de Wikibase API is hier te vinden: https://www.mediawiki.org/wiki/Wikibase/API
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#>
Testcollectie
Een eerste testcollectie is opgezet met van Gogh Worldwide