Wikidata:REST API

Přehled

Wikibase REST API je rozhraní založené na umožňující uživatelům získat a upravovat položky a výroky na instancích Wikibase - včetně samozřejmě Wikidat. Více informací o REST v článku Representational State Transfer na Wikipedii.

Jak používat API

Můžete získat přístup k Wikibase API pro Wikidata pomocí základního URL: https://wikidata.org/w/rest.php/wikibase/v0

1. Nastavte autentizaci.
2. Pro konkrétní pokyny pro každé volání se obraťte na OpenAPI Swagger dokumentaci.

Můžete se také podívat na vývojářskou Wikibase dokumentaci.

REST API pro Wikibase zatím není zahrnuto v stabilním rozhraní Wikidat.

Funkčnost

Všechny volání najdete v našem novém REST API, včetně příkladů v naší OpenAPI Swagger dokumentaci

Neustále pracujeme na zlepšení a přidávání funkcí do API; často se podívejte, co jsme přidali od vaší poslední návštěvy. Pokud máte svůj názor na změnu funkcí, zvážte možnost přidání zpětné vazby na stránku pro diskuze zpětných vazeb.

Chybové zprávy

Ve Wikibase REST API se vrací informativní chybové zprávy, které jsou podrobně dokumentovány pro každé volání v sekci "Odpovědi" OpenAPI dokumentace.

Uživatelé API, kteří nastavili botí značku (bot flag) a obdrželi chybu 403 (rest-write-denied) pravděpodobně nemají právo uživatele pro vedení bota. Více informací je možné získat z tohoto Phabricator ticketu.

Frekvenční limity

Stejně jako každé veřejné API, má Wikibase REST API na Wikidata určité frekvenční limity pro zabránění nesprávného používání a zneužívání.

Vzhledem k tomu, že Wikibase REST API používá stejné základní třídy jako Action API, frekvenční limity se provádí podle stejných pravidel a pomocí stejného nastavení $wgRateLimits. Více informací najdete v dokumentu Frekvenční limity Action API.

Proč bych měl používat Wikibase REST API?

Naše nové REST API je přizpůsobené datovému modelu Wikibase a řeší řadu stávajících problémů, které se snáze řeší pomocí REST.

• Pro údaje o položkách používá REST API výroky místo tvrzení.
• Čisté, plošší struktura ve datech z odpovědí.
• Řada zlepšení způsobu prezentace dat výroků a metadat.
• Pro některé příklady problémů řešených pomocí REST se podívejte na REST API workboard na Phabricatoru.

REST API je v souladu s modernými průmyslovými standardy, na rozdíl od volání Wikibase v Action API. Vývojáři, kteří jsou obeznámeni s REST API, budou moci Wikibase REST API mnohem jednodušeji používat.

Verzování! Namísto toho, aby se Wikibase volalo skrz věčné v1 Action API, Wikibase REST API se mění pomocí verzovaných URL, takže funkce zůstává stabilní.

Podívejte se na naše srovnání staré a nové funkcionality, abyste zjistili, jaký je rozdíl mezi starými a novými API.

Knihovny

• Wikidatum je Ruby gem třetí strany, které je k dispozici pro interakci s Wikibase REST API.
• wikibase-parcher, minimální implementace Wikibase REST API v Pythonu.
• wikibase-rest-api-client, Wikibase REST API client on pypi generated from the OpenApi Spec

Viz také

• Wikidata:REST API feedback round
• Wikidata:Data access pro jiné způsoby přístupu k údajům Wikidat