Nápověda k MediaWiki API
Toto je automaticky generovaná dokumentační stránka k MediaWiki API.
Dokumentace a příklady: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=query
(main | query)
- Tento modul vyžaduje oprávnění ke čtení.
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
Získavať dáta z MediaWiki a o MediaWiki.
Všetky úpravy dát musia najprv použiť dotaz na získanie tokenu, aby sa zabránilo zneužitiu zo škodlivých stránok.
Parametry:
K dispozícii sú aj ďalšie všeobecné parametre.
- prop
Ktoré vlastnosti získať pre dotazované stránky.
- categories
- Zobrazit všechny kategorie, do kterých je stránka zařazena.
- categoryinfo
- Vráti informácie o daných kategóriách.
- contributors
- Zobrazit seznam přihlášených a počet nepřihlášených přispěvatelů stránky.
- deletedrevisions
- Získať informácie o vymazaných revíziách.
- duplicatefiles
- Vypísať všetky súbory, ktoré sú duplikátmi daných súborov na základe hodnôt hashov.
- extlinks
- Vráti všetky externé URL (nie interwiki) z daných stránok.
- fileusage
- Nájsť všetky stránky, ktoré používajú dané súbory.
- imageinfo
- Vráti informácie o súbore a históriu nahrávania.
- images
- Vráti všetky súbory obsiahnuté na daných stránkach.
- info
- Získať základné informácie o stránke.
- iwlinks
- Vráti všetky interwiki odkazy z daných stránok.
- langlinks
- Zobrazit všechny mezijazykové odkazy z daných stránek.
- links
- Vráti všetky odkazy z daných stránok.
- linkshere
- Nájsť všetky stránky, ktoré odkazujú na dané stránky.
- pageprops
- Získať rôzne vlastnosti stránok definované v obsahu stránky.
- redirects
- Vráti všetky presmerovania na dané stránky.
- revisions
- Získať informácie o revíziách.
- stashimageinfo
- Vráti informácie o súboroch v dočasnom úložisku (stash).
- templates
- Vráti všetky stránky transkludované na daných stránkach.
- transcludedin
- Nájsť všetky stránky, ktoré transkludujú dané stránky.
- Hodnoty (oddělené | nebo alternativou.): categories, categoryinfo, contributors, deletedrevisions, duplicatefiles, extlinks, fileusage, imageinfo, images, info, iwlinks, langlinks, links, linkshere, pageprops, redirects, revisions, stashimageinfo, templates, transcludedin
- list
Ktoré zoznamy získať.
- allcategories
- Vymenovať všetky kategórie.
- alldeletedrevisions
- Seznam všech smazaných revizí od konkrétního uživatele nebo v konkrétním jmenném prostoru.
- allfileusages
- Zobrazit seznam všech použití souboru, včetně neexistujících.
- allimages
- Postupne vymenovať všetky obrázky.
- alllinks
- Vymenovať všetky odkazy, ktoré smerujú do daného menného priestoru.
- allpages
- Postupne vymenovať všetky stránky v danom mennom priestore.
- allredirects
- Seznam všech přesměrování pro jmenný prostor.
- allrevisions
- Vypísať všetky revízie.
- alltransclusions
- Vypísať všetky transklúzie (stránky vložené pomocou {{x}}) vrátane neexistujúcich.
- allusers
- Vymenovať všetkých registrovaných používateľov.
- backlinks
- Najít všechny stránky, které odkazují na danou stránku.
- blocks
- Vypísať všetkých zablokovaných používateľov a IP adresy.
- categorymembers
- Seznam všech stránek v dané kategorii.
- codexicons
- Získať ikony Codex
- embeddedin
- Nájsť všetky stránky, ktoré vkladajú (transkludujú) daný názov.
- exturlusage
- Vymenovať stránky, ktoré obsahujú danú URL.
- filearchive
- Postupne vymenovať všetky vymazané súbory.
- imageusage
- Nájsť všetky stránky, ktoré používajú daný názov obrázka.
- iwbacklinks
- Nájsť všetky stránky, ktoré odkazujú na daný interwiki odkaz.
- langbacklinks
- Nájsť všetky stránky, ktoré odkazujú na daný jazykový odkaz.
- logevents
- Získať udalosti zo záznamov.
- mystashedfiles
- Získať zoznam súborov v úložisku nahrávania (upload stash) aktuálneho používateľa.
- pagepropnames
- Vypísať všetky názvy vlastností stránok používané na wiki.
- pageswithprop
- Vypísať všetky stránky používajúce danú vlastnosť stránky.
- prefixsearch
- Vykonať vyhľadávanie názvov stránok podľa predpony.
- protectedtitles
- Vypísať všetky názvy chránené pred vytvorením.
- querypage
- Získať zoznam poskytovaný špeciálnou stránkou založenou na QueryPage.
- random
- Získať množinu náhodných stránok.
- recentchanges
- Vymenovať posledné zmeny.
- search
- Vykonať fulltextové vyhľadávanie.
- tags
- Vypísať značky zmien.
- trackingcategories
- Vymenovať všetky existujúce sledovacie kategórie definované na Special:TrackingCategories. Sledovacia kategória existuje, ak obsahuje stránky alebo ak existuje jej stránka kategórie.
- usercontribs
- Získať všetky úpravy používateľa.
- users
- Získať informácie o zozname používateľov.
- watchlist
- Získať posledné zmeny stránok v zozname sledovaných aktuálneho používateľa.
- watchlistraw
- Získat všechny stránky, které jsou aktuálním uživatelem sledovány.
- deletedrevs
- Zastaralý. list=deletedrevs je zastarané. Namiesto toho použite prop=deletedrevisions alebo list=alldeletedrevisions.Vypísať vymazané revízie.
- Hodnoty (oddělené | nebo alternativou.): allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, allusers, backlinks, blocks, categorymembers, codexicons, embeddedin, exturlusage, filearchive, imageusage, iwbacklinks, langbacklinks, logevents, mystashedfiles, pagepropnames, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, search, tags, trackingcategories, usercontribs, users, watchlist, watchlistraw, deletedrevs
- meta
Ktoré metadáta získať.
- allmessages
- Vrátiť správy z tohto webu.
- authmanagerinfo
- Získať informácie o aktuálnom stave autentifikácie.
- filerepoinfo
- Vrátiť meta informácie o úložiskách obrázkov nakonfigurovaných na wiki.
- languageinfo
- Vrátiť informácie o dostupných jazykoch.
- siteinfo
- Vrátiť všeobecné informácie o webe.
- tokens
- Získa tokeny pre akcie upravujúce dáta.
- userinfo
- Získať informácie o aktuálnom používateľovi.
- Hodnoty (oddělené | nebo alternativou.): allmessages, authmanagerinfo, filerepoinfo, languageinfo, siteinfo, tokens, userinfo
- indexpageids
Zahrnúť dodatočnú sekciu pageids so zoznamom všetkých vrátených ID stránok.
- Typ: logická hodnota (boolean) (podrobnosti)
- export
Exportovať aktuálne revízie všetkých zadaných alebo vygenerovaných stránok.
- Typ: logická hodnota (boolean) (podrobnosti)
- exportnowrap
Vrátiť exportné XML bez zabalenia do XML výsledku (rovnaký formát ako Special:Export). Možno použiť iba s query+export.
- Typ: logická hodnota (boolean) (podrobnosti)
- exportschema
Pri exportovaní cieliť na danú verziu formátu XML dumpu. Možno použiť iba s query+export.
- Jedna z následujících hodnot: 0.10, 0.11
- Predvolené: 0.11
- iwurl
Či získať plnú URL, ak je názov interwiki odkazom.
- Typ: logická hodnota (boolean) (podrobnosti)
- continue
Keď je dostupných viac výsledkov, použite toto na pokračovanie. Podrobnejšie informácie o tom, ako pokračovať v dotazoch, nájdete na mediawiki.org.
- rawcontinue
Vrátiť surové dáta query-continue na pokračovanie.
- Typ: logická hodnota (boolean) (podrobnosti)
- titles
Zoznam názvov stránok, s ktorými sa má pracovať.
- Hodnoty oddělujte pomocí | nebo alternativou.
- Maximálny počet hodnôt je 50 (500 pre klientov s povolenými vyššími limitmi).
- pageids
Zoznam ID stránok, s ktorými sa má pracovať.
- Typ: zoznam celých čísel
- Hodnoty oddělujte pomocí | nebo alternativou.
- Maximálny počet hodnôt je 50 (500 pre klientov s povolenými vyššími limitmi).
- revids
Zoznam ID revízií, s ktorými sa má pracovať. Upozorňujeme, že takmer všetky dotazovacie moduly konvertujú ID revízií na zodpovedajúce ID stránky a pracujú namiesto toho s najnovšou revíziou. Iba prop=revisions používa vo svojej odpovedi presné revízie.
- Typ: zoznam celých čísel
- Hodnoty oddělujte pomocí | nebo alternativou.
- Maximálny počet hodnôt je 50 (500 pre klientov s povolenými vyššími limitmi).
- generator
Získať zoznam stránok, s ktorými sa má pracovať, vykonaním zadaného dotazovacieho modulu.
Poznámka: Názvy parametrov generátora musia mať predponu „g“, pozri príklady.
- allcategories
- Vymenovať všetky kategórie.
- alldeletedrevisions
- Seznam všech smazaných revizí od konkrétního uživatele nebo v konkrétním jmenném prostoru.
- allfileusages
- Zobrazit seznam všech použití souboru, včetně neexistujících.
- allimages
- Postupne vymenovať všetky obrázky.
- alllinks
- Vymenovať všetky odkazy, ktoré smerujú do daného menného priestoru.
- allpages
- Postupne vymenovať všetky stránky v danom mennom priestore.
- allredirects
- Seznam všech přesměrování pro jmenný prostor.
- allrevisions
- Vypísať všetky revízie.
- alltransclusions
- Vypísať všetky transklúzie (stránky vložené pomocou {{x}}) vrátane neexistujúcich.
- backlinks
- Najít všechny stránky, které odkazují na danou stránku.
- categories
- Zobrazit všechny kategorie, do kterých je stránka zařazena.
- categorymembers
- Seznam všech stránek v dané kategorii.
- deletedrevisions
- Získať informácie o vymazaných revíziách.
- duplicatefiles
- Vypísať všetky súbory, ktoré sú duplikátmi daných súborov na základe hodnôt hashov.
- embeddedin
- Nájsť všetky stránky, ktoré vkladajú (transkludujú) daný názov.
- exturlusage
- Vymenovať stránky, ktoré obsahujú danú URL.
- fileusage
- Nájsť všetky stránky, ktoré používajú dané súbory.
- images
- Vráti všetky súbory obsiahnuté na daných stránkach.
- imageusage
- Nájsť všetky stránky, ktoré používajú daný názov obrázka.
- iwbacklinks
- Nájsť všetky stránky, ktoré odkazujú na daný interwiki odkaz.
- langbacklinks
- Nájsť všetky stránky, ktoré odkazujú na daný jazykový odkaz.
- links
- Vráti všetky odkazy z daných stránok.
- linkshere
- Nájsť všetky stránky, ktoré odkazujú na dané stránky.
- pageswithprop
- Vypísať všetky stránky používajúce danú vlastnosť stránky.
- prefixsearch
- Vykonať vyhľadávanie názvov stránok podľa predpony.
- protectedtitles
- Vypísať všetky názvy chránené pred vytvorením.
- querypage
- Získať zoznam poskytovaný špeciálnou stránkou založenou na QueryPage.
- random
- Získať množinu náhodných stránok.
- recentchanges
- Vymenovať posledné zmeny.
- redirects
- Vráti všetky presmerovania na dané stránky.
- revisions
- Získať informácie o revíziách.
- search
- Vykonať fulltextové vyhľadávanie.
- templates
- Vráti všetky stránky transkludované na daných stránkach.
- trackingcategories
- Vymenovať všetky existujúce sledovacie kategórie definované na Special:TrackingCategories. Sledovacia kategória existuje, ak obsahuje stránky alebo ak existuje jej stránka kategórie.
- transcludedin
- Nájsť všetky stránky, ktoré transkludujú dané stránky.
- watchlist
- Získať posledné zmeny stránok v zozname sledovaných aktuálneho používateľa.
- watchlistraw
- Získat všechny stránky, které jsou aktuálním uživatelem sledovány.
- Jedna z následujících hodnot: allcategories, alldeletedrevisions, allfileusages, allimages, alllinks, allpages, allredirects, allrevisions, alltransclusions, backlinks, categories, categorymembers, deletedrevisions, duplicatefiles, embeddedin, exturlusage, fileusage, images, imageusage, iwbacklinks, langbacklinks, links, linkshere, pageswithprop, prefixsearch, protectedtitles, querypage, random, recentchanges, redirects, revisions, search, templates, trackingcategories, transcludedin, watchlist, watchlistraw
- redirects
Automaticky vyriešiť presmerovania v query+titles, query+pageids a query+revids a na stránkach vrátených query+generator.
- Typ: logická hodnota (boolean) (podrobnosti)
- converttitles
V prípade potreby konvertovať názvy na iné varianty. Funguje len vtedy, ak jazyk obsahu wiki podporuje konverziu variantov. Jazyky, ktoré podporujú konverziu variantov, zahŕňajú ban, crh, en, gan, iu, ku, mni, sh, shi, sr, tg, tly, uz, wuu, zgh a zh.
- Typ: logická hodnota (boolean) (podrobnosti)
Příklady:
- Získať informácie o webe a revízie stránky Hlavní strana.
- api.php?action=query&prop=revisions&meta=siteinfo&titles=Hlavn%C3%AD%20strana&rvprop=user|comment&continue= [otevřít v pískovišti]
- Získať revízie stránok začínajúcich na API/.
- api.php?action=query&generator=allpages&gapprefix=API/&prop=revisions&continue= [otevřít v pískovišti]