Wikimedia REST API/cs
Wikimedia REST API nabízí přístup k obsahu a metadatům Wikimedie ve strojově čitelných formátech. Zaměřuje se na případy použití s velkým objemem a úzce se integruje s globálně distribuovanou infrastrukturou mezipaměti Wikimedie. Výsledkem je, že uživatelé API těží ze snížených latencí a podpory pro velké objemy požadavků.
REST API spolu s jeho dokumentací je k dispozici pro všechny hlavní projekty Wikimedie na adrese /api/rest_v1/. Například pro anglickou Wikipedii je k dispozici https://en.wikipedia.org/api/rest_v1/.
I když funkce nabízené většinou projektů úzce odpovídají funkcím na anglické Wikipedii, existují některé pozoruhodné výjimky:
- wikimedia.org nabízí informace z různých projektů, jako jsou metriky zobrazení stránky.
- en.wiktionary.org nabízí experimentální [koncový bod definice https://en.wiktionary.org/api/rest_v1/#!/Page_content/get_page_definition_term], který vystavuje informace z Wikislovníku jako strukturovaná data. Podpora dalších jazyků je v diskuzi.
Verzování
REST API se řídí touto zásadou verzování API.
Smluvní podmínky
- Používáním REST API souhlasíte s obecnými Podmínkami použití a Zásadami ochrany osobních údajů Wikimedie.
- Abyste se vyhnuli dopadu na ostatní uživatele API, omezte své klienty na maximálně 200 požadavků na tuto API celkově. Mnoho vstupních bodů navíc specifikuje a prosazuje přísnější limity sazeb.
- Žádáme vás, abyste nastavili jedinečnou hlavičku
User-AgentneboApi-User-Agent, která nám umožní vás rychle kontaktovat. E-mailové adresy nebo adresy URL kontaktních stránek fungují dobře.
Další API
Informace o REST API obsaženém v MediaWiki 1.35 a novějších naleznete v MediaWiki Core REST API.
| API | Dostupnost | Základ URL | Příklad |
|---|---|---|---|
 Akce API MediaWiki |
je součástí MediaWiki
aktivováno na projektech Wikimedie |
/api.php | https://cs.wikipedia.org/w/api.php?action=query&prop=info&titles=Země |
| REST API MediaWiki |
je součástí MediaWiki 1.35+
aktivováno na projektech Wikimedie |
/rest.php | https://cs.wikipedia.org/w/rest.php/v1/page/Země |
 Wikimedie REST API |
není součástí MediaWiki
k dispozici pouze pro projekty Wikimedie |
/api/rest | https://cs.wikipedia.org/api/rest_v1/page/title/Země |
 Rozhraní API v komerčním měřítku pro projekty Wikimedie najdete na stránkách Wikimedia Enterprise | |||
Související odkazy
- RESTBase, která je zastaralá, technologie před REST API
- Blogový příspěvek oznamující vydání 1.0. Popisuje několik důležitých produkčních případů použití, popisuje, jak REST API zapadá do širší technické strategie Wikimedie, a poskytuje odkazy na některé detaily implementace.
- API je implementováno pomocí Node.js. Tento příspěvek na blogu popisuje naše zkušenosti s aktualizací REST API a dalších služeb na Node 6.
- Tým platformy MediaWiki, vlastníci produktů pro REST API.
- Core Platform Team/Initiatives/API Gateway (2020)