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
prop=revisions (rv)
- Tento modul vyžaduje oprávnění ke čtení.
- Tento modul lze využívat jako generátor.
- Zdroj: MediaWiki
- Licence: GPL-2.0-or-later
Získať informácie o revíziách.
Možno použiť niekoľkými spôsobmi:
- Získať dáta o množine stránok (posledná revízia) zadaním titles alebo pageids.
- Získať revízie jednej danej stránky použitím titles alebo pageids so start, end alebo limit.
- Získať dáta o množine revízií zadaním ich ID pomocou revids.
- rvprop
Ktoré vlastnosti získať pre každú revíziu:
- ids
- ID revízie.
- flags
- Príznaky revízie (malá).
- timestamp
- Časová pečiatka revízie.
- user
- Používateľ, ktorý vykonal revíziu. Ak bol používateľ skrytý pomocou vymazania revízií, vráti sa vlastnosť userhidden.
- userid
- ID používateľa, ktorý vytvoril revíziu. Ak bol používateľ skrytý pomocou vymazania revízií, vráti sa vlastnosť userhidden.
- size
- Dĺžka (v bajtoch) revízie.
- slotsize
- Dĺžka (v bajtoch) každého slotu revízie.
- sha1
- SHA-1 (v sústave so základom 16) revízie. Ak bol obsah skrytý pomocou vymazania revízií, vráti sa vlastnosť sha1hidden.
- slotsha1
- SHA-1 (v sústave so základom 16) každého slotu revízie. Ak bol obsah skrytý pomocou vymazania revízií, vráti sa vlastnosť sha1hidden.
- contentmodel
- ID modelu obsahu každého slotu revízie.
- comment
- Komentár používateľa k revízii. Ak bol komentár skrytý pomocou vymazania revízií, vráti sa vlastnosť commenthidden.
- parsedcomment
- Parsovaný komentár používateľa k revízii. Ak bol komentár skrytý pomocou vymazania revízií, vráti sa vlastnosť commenthidden.
- content
- Obsah každého slotu revízie. Ak bol obsah skrytý pomocou vymazania revízií, vráti sa vlastnosť texthidden. Z výkonnostných dôvodov sa pri použití tejto voľby rvlimit vynúti na 50.
- tags
- Značky revízie.
- roles
- Vypísať roly obsahových slotov, ktoré existujú v revízii.
- parsetree
- Zastaralý. Namiesto toho použite action=expandtemplates alebo action=parse. XML strom parsovania obsahu revízie (vyžaduje model obsahu
wikitext). Z výkonnostných dôvodov sa pri použití tejto voľby rvlimit vynúti na 50.
- Hodnoty (oddělené | nebo alternativou.): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- Predvolené: ids|timestamp|flags|comment|user
- rvslots
Ktoré sloty revízie sa majú vrátiť, keď sú vo rvprops zahrnuté vlastnosti súvisiace so slotmi. Ak je vynechané, dáta zo slotu main sa vrátia v spätne kompatibilnom formáte.
- Hodnoty (oddělené | nebo alternativou.): main
- Na zadanie všetkých hodnôt použite *.
- rvcontentformat-{slot}
Serializačný formát obsahu použitý pre výstup obsahu.
- Toto je šablónový parameter. Pri vytváraní požiadavky {slot} v názve parametra by sa malo nahradiť hodnotami rvslots.
- Jedna z následujících hodnot: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- rvlimit
Obmedziť počet vrátených revízií. Ak sa použije rvprop=content, rvprop=parsetree, rvdiffto alebo rvdifftotext, limit je 50. Ak sa použije rvparse, limit je 1.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: celé číslo alebo max
- Hodnota musí byť medzi 1 a 500.
- rvexpandtemplates
- Zastaralý.
Namiesto toho použite action=expandtemplates. Expandovať šablóny v obsahu revízie (vyžaduje rvprop=content).
- Typ: logická hodnota (boolean) (podrobnosti)
- rvgeneratexml
- Zastaralý.
Namiesto toho použite action=expandtemplates alebo action=parse. Vygenerovať XML strom parsovania obsahu revízie (vyžaduje rvprop=content).
- Typ: logická hodnota (boolean) (podrobnosti)
- rvparse
- Zastaralý.
Namiesto toho použite action=parse. Parsovať obsah revízie (vyžaduje rvprop=content). Z výkonnostných dôvodov sa pri použití tejto voľby rvlimit vynúti na 1.
- Typ: logická hodnota (boolean) (podrobnosti)
- rvsection
Získať iba obsah sekcie s týmto identifikátorom.
- rvdiffto
- Zastaralý.
Namiesto toho použite action=compare. ID revízie, s ktorou sa má porovnať každá revízia. Použite prev, next a cur pre predchádzajúcu, nasledujúcu a aktuálnu revíziu. Z výkonnostných dôvodov sa pri použití tejto voľby rvlimit vynúti na 50.
- rvdifftotext
- Zastaralý.
Namiesto toho použite action=compare. Text, s ktorým sa má porovnať každá revízia. Porovnáva len obmedzený počet revízií. Má prednosť pred rvdiffto. Ak je nastavené rvsection, s týmto textom sa porovná iba daná sekcia. Z výkonnostných dôvodov sa pri použití tejto voľby rvlimit vynúti na 50.
- rvdifftotextpst
- Zastaralý.
Namiesto toho použite action=compare. Vykonať transformáciu pred uložením na texte pred jeho porovnaním. Platné iba pri použití s rvdifftotext.
- Typ: logická hodnota (boolean) (podrobnosti)
- rvcontentformat
- Zastaralý.
Serializačný formát použitý pre rvdifftotext a očakávaný pre výstup obsahu.
- Jedna z následujících hodnot: application/json, application/octet-stream, application/unknown, application/vue+xml, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- rvstartid
Začať vymenúvanie od časovej pečiatky revízie s týmto ID. Revízia musí existovať, ale nemusí patriť tejto stránke.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: celé číslo
- rvendid
Zastaviť vymenúvanie pri časovej pečiatke revízie s týmto ID. Revízia musí existovať, ale nemusí patriť tejto stránke.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: celé číslo
- rvstart
Od ktorej časovej pečiatky revízie začať vymenúvanie.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: časová pečiatka (povolené formáty)
- rvend
Vymenúvať po túto časovú pečiatku.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: časová pečiatka (povolené formáty)
- rvdir
V ktorom smere vymenúvať:
- newer
- Vypísať najstaršie ako prvé. Poznámka: rvstart musí byť pred rvend.
- older
- Vypísať najnovšie ako prvé (predvolené). Poznámka: rvstart musí byť neskôr ako rvend.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Jedna z následujících hodnot: newer, older
- Predvolené: older
- rvuser
Zahrnúť iba revízie vykonané používateľom.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: uživatel, uvedený jako cokoli z: uživatelské jméno, IP, Dočasný uživatel, interwiki jméno (např. „prefix>Příklad“) a ID uživatele (např. „#12345“)
- rvexcludeuser
Vylúčiť revízie vykonané používateľom.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: uživatel, uvedený jako cokoli z: uživatelské jméno, IP, Dočasný uživatel, interwiki jméno (např. „prefix>Příklad“) a ID uživatele (např. „#12345“)
- rvtag
Vypísať iba revízie označené touto značkou.
- rvcontinue
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.
- Získať dáta s obsahom pre poslednú revíziu názvov API a Hlavní strana.
- api.php?action=query&prop=revisions&titles=API|Hlavn%C3%AD%20strana&rvslots=*&rvprop=timestamp|user|comment|content [otevřít v pískovišti]
- Získať posledných 5 revízií stránky Hlavní strana.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%AD%20strana&rvlimit=5&rvprop=timestamp|user|comment [otevřít v pískovišti]
- Získať prvých 5 revízií stránky Hlavní strana.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%AD%20strana&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [otevřít v pískovišti]
- Získať prvých 5 revízií stránky Hlavní strana vykonaných po 2006-05-01.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%AD%20strana&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [otevřít v pískovišti]
- Získať prvých 5 revízií stránky Hlavní strana, ktoré neboli vykonané anonymným používateľom 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%AD%20strana&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [otevřít v pískovišti]
- Získať prvých 5 revízií stránky Hlavní strana, ktoré vykonal používateľ MediaWiki default.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%AD%20strana&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [otevřít v pískovišti]