Wikidata:REST API/nl
Overzicht
De Wikibase REST API is een OpenAPI-gebaseerde interface waarmee gebruikers kunnen communiceren met, ophalen en bewerken van items en instructies op Wikibase-instanties - inclusief natuurlijk Wikidata. Voor meer informatie over REST, zie het Wikipedia-lemma over representational state transfer.
Hoe moet u de API gebruiken
U heeft toegang tot de Wikibase API op Wikidata met behulp van de basis-URL: https://wikidata.org/w/rest.php/wikibase/v0
- Stel de authenticatie in.
- Raadpleeg de OpenAPI Swagger-documentatie voor specifieke instructies voor elke aanroep.
U kunt ook een kijkje nemen in de Wikibase ontwikkelaarsdocumentatie.
De Wikibase REST API valt nog niet onder het Wikidata's Stabiele Interface beleid.
Functionaliteit
U vindt alle aanroepen in onze REST API, inclusief voorbeelden, in onze OpenAPI Swagger-documentatie.
We werken voortdurend aan het verbeteren en toevoegen van functionaliteit aan de API; Kom regelmatig terug om te zien wat we sinds uw laatste bezoek hebben toegevoegd. Om uw mening te geven over die veranderende functionaliteit, u kunt uw feedback geven op de overlegpagina.
Foutmeldingen
De Wikibase REST API genereert informatieve foutmeldingen, gedocumenteerd voor elke aanroep in detail in het gedeelte Responses' van de OpenAPI-documentatie.
API-gebruikers die de bot-vlag hebben ingesteld en een 403 (rest-write-denied) fout ontvangen, missen waarschijnlijk het bot-gebruikersrecht. Zie dit Phabricator ticket voor meer context.
Limieten
Zoals elke openbare API, heeft de Wikibase REST API op Wikidata bepaalde snelheidslimieten ingesteld om misbruik en verkeerd gebruik te voorkomen.
Omdat de Wikibase REST API dezelfde onderliggende klassen gebruikt als de Action API, gaan deze beperkingen volgens dezelfde regels en met dezelfde instelling, $wgRateLimits. Zie de Action API limieten documentatie voor meer informatie.
Waarom zou ik de Wikibase REST API gebruiken?
Onze nieuwe REST API is 'afgestemd op het Wikibase datamodel, en het lost een aantal bestaande problemen op.
- Voor item-gegevens gebruikt de REST API verklaringen in plaats van claims.
- Schonere, plattere structuur in responsgegevens.
- Een aantal verbeteringen in de manier waarop verklaringengegevens en metagegevens worden gepresenteerd.
- Voor enkele voorbeelden van problemen die door REST zijn opgelost, bekijk het REST API workboard op Phabricator.
De REST API voldoet aan 'moderne industriestandaarden, in tegenstelling tot de Wikibase-aanroepen in de Action API. Ontwikkelaars die bekend zijn met REST API's zullen de Wikibase REST API veel gemakkelijker te gebruiken vinden.
Versiebeheer! In plaats van de Wikibase-aanroepen in de forever-v1 Action API te stoppen, verandert de WB REST API met behulp van [1], zodat de functionaliteit stabiel blijft.
Bekijk onze vergelijking van oude en nieuwe functionaliteit om een idee te krijgen van het verschil tussen de oude en nieuwe API's.
Bibliotheken
- Wikidatum, een Ruby-juweeltje van derden, is beschikbaar voor interactie met de Wikibase REST API.
- wikibase-patcher, een minimale Wikibase REST API-implementatie in Python.
- wikibases-rest-api-client, wikibases REST API-client op pypi gegenereerd uit de OpenApi Spec
Zie ook
- Wikidata:REST API feedback round
- Wikidata:Data access voor andere manieren om toegang te krijgen tot de gegevens van Wikidata