API:Query/cs

Modul  vám umožňuje získat informace o wiki a datech v ní uložených, jako je wikitext konkrétní stránky, odkazy a kategorie sady stránek nebo token, který potřebujete ke.



Dokumentace API


Moduly dotazů
Modul dotazu má tři typy podmodulů (nazývaných také dotazovací moduly):


 * o wiki a přihlášeném uživateli.
 * stránek, včetně revizí stránek a obsahu.
 * stránek, které odpovídají určitým kritériím.

Příklady


Příklad 1: Určení stránek
Na rozdíl od modulů meta a dotazů na seznam fungují všechny moduly dotazů na vlastnosti na sadě stránek, které lze zadat jedním z následujících způsobů:


 * Podle jména pomocí parametru, např..
 * Podle ID stránky pomocí parametru, např..
 * Podle ID revize pomocí parametru, např.  . Většina dotazovacích modulů převede ID revize na odpovídající ID stránky. Pouze  ve skutečnosti používá samotné ID revize.
 * Pomocí generátoru.



Odpověď


Příklad 2: Normalizace názvu
Normalizace nadpisů převede nadpisy stránek do jejich kanonické podoby.

To znamená použití velkého prvního znaku, nahrazení podtržítek mezerami a změnu jmenného prostoru na lokalizovaný tvar definovaný pro danou wiki.



Odpověď


Příklad 3: Chybějící a neplatné názvy
Názvy, které neexistují nebo jsou neplatné, budou mít v odpovědi nastaven atribut  nebo.

Ve výstupních formátech, které podporují klávesy číselných polí, budou mít chybějící a neplatné názvy záporné ID stránky.

V některých případech může uživatel zobrazit název, ale nemůže k němu přistupovat rozhraní API, jako jsou stránky, které zrcadlí obsah z jiné wiki. Tyto tituly budou mít v odpovědi nastavený atribut.



Odpověď


Příklad 4: Pokračující dotazy
Když nejsou v odpovědi na dotaz vrácena všechna data, bude zde atribut, který značí, že existuje více dat.



Odpověď
Chcete-li získat další data, přidejte jejich hodnoty k původnímu požadavku:



Odpověď


Příklad 5: Dokončení dávky
Rozhraní API vrací prvek, který označuje, že byla vrácena všechna data pro aktuální dávku položek.

V odpovědi na ukázkový dotaz níže byl zahrnut, což znamená, že byla vrácena všechna data pro každý ze tří obrázků.

Příští pokračování začne vracet data pro další sadu 3 snímků.



Odpověď


Příklad 6: Generátory
Pokud chcete získat data o sadě stránek, použijte generátory.

Chcete-li například získat data o stránkách v určité kategorii, místo dotazování  a následného dotazování znovu s   nastaveným na všechny vrácené stránky, zkombinujte dvě volání API do jednoho pomocí.

Při použití modulu seznamu jako generátoru nemusíte specifikovat stránky.

U modulu vlastností byste však měli specifikovat stránky, na kterých bude generátor pracovat.

Chcete-li například načíst všechny stránky, na které odkazuje hlavní stránka, použijte.

Parametry předávané generátoru musí mít předponu. Například při použití  použijte místo.

Ukázkový dotaz níže získá odkazy a kategorie pro první tři stránky v hlavním jmenném prostoru začínající "Ba".



Continuing queries
Queries will often have more results available than are just shown in the original query. (Often this is because a List query's result limit has been reached.) In these cases, queries can be continued. More detailed information on continuing queries can be at API:Continue.



Možná varování
<span id="Parameter_history">

Historie parametrů

 * v1.34: Představeno
 * v1.24: Představeno  (poznámka: raw continuation bylo výchozí chování až do verze 1.26)
 * v1.21: Představeno

<span id="Additional_notes">

Další poznámky

 * Zadání titulů prostřednictvím  nebo   je omezeno na 50 titulů na dotaz nebo 500 pro ty s právem.
 * Použijte více modulů dotazů dohromady, abyste získali to, co potřebujete, v jednom požadavku, např..
 * Generators always pass page titles to the query module. Unlike lists (which may include additional data by default), generators should not output any information themselves, unless when explicitly requested via the generator module's query parameters.

<span id="Resolving_redirects">

Řešení přesměrování
Přesměrování lze vyřešit automaticky, takže místo daného názvu je vrácen cíl přesměrování. Jsou-li k dispozici, budou vždy obsahovat atributy  a   a mohou obsahovat atribut   pro přesměrování, které ukazují na konkrétní sekce.

Může dojít k normalizaci i přesměrování. V případě více přesměrování budou všechna přesměrování vyřešena a v případě kruhového přesměrování nemusí být stránka v sekci 'stránky' (viz také níže). Rozlišení přesměrování nelze použít v kombinaci s parametrem  nebo s generátorem generujícím revidy. Když to uděláte, vytvoří se varování a nevyřeší se přesměrování pro zadané revize.

Níže uvedené příklady ukazují, jak funguje parametr.