Pomocník API MediaWiki
Toto je automaticky generovaná dokumentačná stránka MediaWiki Action API.
prop=revisions (rv)
- Tento modul vyžaduje práva na čítanie.
- Tento modul možno použiť ako generátor.
- Zdroj: MediaWiki
- Licencia: 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
- Zastarané. 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 (oddeľte pomocou | alebo alternatívy): 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 (oddeľte pomocou | alebo alternatívy): 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 nasledujúcich hodnôt: 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
- Zastarané.
Namiesto toho použite action=expandtemplates. Expandovať šablóny v obsahu revízie (vyžaduje rvprop=content).
- Typ: logická hodnota (boolean) (podrobnosti)
- rvgeneratexml
- Zastarané.
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
- Zastarané.
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
- Zastarané.
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
- Zastarané.
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
- Zastarané.
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
- Zastarané.
Serializačný formát použitý pre rvdifftotext a očakávaný pre výstup obsahu.
- Jedna z nasledujúcich hodnôt: 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 nasledujúcich hodnôt: 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: používateľ, podľa ľubovoľného z používateľské meno, IP, Dočasný používateľ, interwiki meno (napr. „predpona>PríkladMena“) a ID používateľa (napr. „#12345“)
- rvexcludeuser
Vylúčiť revízie vykonané používateľom.
- Možno použiť iba s jednou stránkou (režim č. 2).
- Typ: používateľ, podľa ľubovoľného z používateľské meno, IP, Dočasný používateľ, interwiki meno (napr. „predpona>PríkladMena“) a ID používateľa (napr. „#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á stránka.
- api.php?action=query&prop=revisions&titles=API|Hlavn%C3%A1%20str%C3%A1nka&rvslots=*&rvprop=timestamp|user|comment|content [otvoriť na pieskovisku]
- Získať posledných 5 revízií stránky Hlavná stránka.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%A1%20str%C3%A1nka&rvlimit=5&rvprop=timestamp|user|comment [otvoriť na pieskovisku]
- Získať prvých 5 revízií stránky Hlavná stránka.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%A1%20str%C3%A1nka&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [otvoriť na pieskovisku]
- Získať prvých 5 revízií stránky Hlavná stránka vykonaných po 2006-05-01.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%A1%20str%C3%A1nka&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [otvoriť na pieskovisku]
- Získať prvých 5 revízií stránky Hlavná stránka, ktoré neboli vykonané anonymným používateľom 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%A1%20str%C3%A1nka&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [otvoriť na pieskovisku]
- Získať prvých 5 revízií stránky Hlavná stránka, ktoré vykonal používateľ MediaWiki default.
- api.php?action=query&prop=revisions&titles=Hlavn%C3%A1%20str%C3%A1nka&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [otvoriť na pieskovisku]