Pomoč za API MediaWiki
To je samodejno ustvarjena stran za API MediaWiki.
Dokumentacija in zgledi: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions (rv)
- Ta modul zahteva pravice branja.
- Ta modul se lahko uporablja kot generator.
- Vir: MediaWiki
- Licenca: GPL-2.0-or-later
Pridobitev podatkov o redakciji.
Lahko se uporablja na več načinov:
- Pridobitev podatkov o naboru strani (zadnja redakcija) z nastavitvijo naslovov ali ID-jev strani.
- Pridobitev redakcij za eno podano stran z uporabo naslovov ali ID-jev strani s časom začetka ali konca ali limite.
- Pridobitev podatkov o naboru redakcij z nastavitvijo njihovih ID-jev redakcij.
- rvprop
Katere lastnosti naj se pridobijo za vsako redakcijo:
- ids
- ID redakcije.
- flags
- Zastavice redakcije (male).
- timestamp
- Časovni žig redakcije.
- user
- Uporabnik, ki je ustvaril redakcijo. Če je uporabnik v izbrisani redakciji, bo vrnjena lastnost userhidden.
- userid
- Uporabniški ID ustvaritelja redakcije. Če je uporabnik v izbrisani redakciji, bo vrnjena lastnost userhidden.
- size
- Dolžina (v bajtih) redakcije.
- slotsize
- Dolžina (v bajtih) vsake reže redakcije.
- sha1
- SHA-1 (osnova 16) redakcije. Če je vsebina v izbrisani redakciji, bo vrnjena lastnost sha1hidden.
- slotsha1
- SHA-1 (osnova 16) vsake reže redakcije. Če je vsebina v izbrisani redakciji, bo vrnjena lastnost sha1hidden.
- contentmodel
- ID vsebinskega modela vsake reže redakcije.
- comment
- Komentar uporabnika za redakcijo. Če je komentar v izbrisani redakciji, bo vrnjena lastnost commenthidden.
- parsedcomment
- Razčlenjeni komentar uporabnika za redakcijo. Če je komentar v izbrisani redakciji, bo vrnjena lastnost commenthidden.
- content
- Vsebina vsake redakcijske reže. Če je bila redakcija vsebine izbrisana, bo vrnjena lastnost texthidden. Če je uporabljena ta možnost, se zaradi učinkovitosti pri 50 uveljavi vrednost rvlimit.
- tags
- Oznake za redakcijo.
- roles
- Navedba vlog vsebinskih rež, ki obstajajo v redakciji.
- parsetree
- Opuščeno. Namesto tega uporabi action=expandtemplates ali action=parse Drevo razčlenitve XML vsebine redakcije (zahteva vsebinski model
wikitext). Če je uporabljena ta možnost, se zaradi učinkovitosti pri 50 uporabi vrednost rvlimit.
- Vrednosti (ločene s | ali alternativa): comment, content, contentmodel, flags, ids, parsedcomment, roles, sha1, size, slotsha1, slotsize, tags, timestamp, user, userid, parsetree
- Privzeto: ids|timestamp|flags|comment|user
- rvslots
Za katere reže redakcij naj se vrnejo podatki, kadar so z režami povezane lastnosti vključene v rvprops. ČE je izpuščeno, bodo v vzvratno združljivem formatu vrnjeni podatki iz reže main.
- Vrednosti (ločene s | ali alternativa): main
- Za določitev vseh vrednosti uporabite *.
- rvcontentformat-{slot}
Format serializacije vsebine, ki se uporablja za izpis vsebine.
- To je parameter predloge. Pri oblikovanju zahtevka {slot} v imenu parametra je treba zamenjati z vrednostmi rvslots.
- Ena od naslednjih vrednosti: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- rvlimit
Omejite, koliko redakcij bo vrnjenih. Če je uporabljen rvprop=content, rvprop=parsetree, rvdiffto ali rvdifftotext, je omejitev 50. Če je uporabljeno rvparse, je omejitev 1.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Tip: celo število ali max
- Vrednost mora biti med 1 in 500.
- rvexpandtemplates
- Opuščeno.
Namesto tega uporabite action=expandtemplates. Razširite predloge v vsebino redakcij (zahteva rvprop=content).
- Tip: Boolov (podrobnosti)
- rvgeneratexml
- Opuščeno.
Namesto tega uporabite action=expandtemplates ali action=parse. Ustvarite drevo razčlenjevanja XML za vsebino redakcij (zahteva rvprop=content).
- Tip: Boolov (podrobnosti)
- rvparse
- Opuščeno.
Namesto tega uporabite action=parse. Razčleni vsebino redakcije (zahteva rvprop=content). Če je uporabljena ta možnost, se zaradi učinkovitosti pri 1 uveljavi vrednost rvlimit.
- Tip: Boolov (podrobnosti)
- rvsection
Pridobitev samo vsebine razdelka s tem identifikatorjem.
- rvdiffto
- Opuščeno.
Namesto tega uporabi action=compare. ID redakcije za razlikovanje vsake redakcije. Za predhodno, naslednjo in trenutn redakcijo uporabite prev, next in cur. Če je uporabljena ta možnost, se zaradi učinkovitosti pri 50 uveljavi vrednost rvlimit.
- rvdifftotext
- Opuščeno.
Namesto tega uporabi action=compare. Besedilo za razlikovanje posameznih redakcij. Razlikuje le omejeno število redakcij. Preglasi rvdiffto. Če je nastavljeno rvsection, se bo glede na to besedilo razlikoval samo ta razdelek. Če je uporabljena ta možnost, se zaradi učinkovitosti pri 50 uveljavi vrednost rvlimit.
- rvdifftotextpst
- Opuščeno.
Namesto tega uporabite action=compare. Pred razlikovanjem izvedite predshranjevalno transformacijo besedila. Veljavno samo, če se uporablja z rvdifftotext.
- Tip: Boolov (podrobnosti)
- rvcontentformat
- Opuščeno.
Serializacijski format, ki se uporablja za rvdifftotext in pričakovano za izhod vsebine.
- Ena od naslednjih vrednosti: application/json, application/octet-stream, application/unknown, application/x-binary, text/css, text/javascript, text/plain, text/unknown, text/x-wiki, unknown/unknown
- rvstartid
Začetek naštevanja od časovnega žiga redakcije s tem ID-jem. Redakcija mora obstajati, vendar ni nujno, da pripada tej strani.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Vtipkajte: celo število
- rvendid
Konec naštevanja pri časovnem žigu redakcije s tem ID-jem. Redakcija mora obstajati, vendar ni nujno, da pripada tej strani.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Vtipkajte: celo število
- rvstart
Pri katerem časovnem žigu redakcije naj se začne oštevilčevanje.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Tip: časovni žig (dovoljeni formati)
- rvend
Oštevilčevanje do tega časovnega žiga.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Tip: časovni žig (dovoljeni formati)
- rvdir
V kateri smeri naj poteka oštevilčevanje:
- newer
- Najprej je navedeno najstarejše. Opomba: rvstart se mora začeti pred rvend.
- older
- Najprej najnovejše (privzeto). Opomba: rvstart mora biti poznejše kot rvend.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Ena od naslednjih vrednosti: newer, older
- Privzeto: older
- rvuser
Vključitev samo redakcij, ki jih je ustvaril uporabnik.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Vrsta: uporabnik, ki ustreza čemur koli od uporabniško ime, IP, Začasni uporabnik, ime interwikija (npr. »predpona>ImePrimera«) in ID uporabnika (npr. »#12345«)
- rvexcludeuser
Izključi redakcije, ki jih je ustvaril uporabnik.
- Lahko se uporablja samo z eno samo stranjo (način #2).
- Vrsta: uporabnik, ki ustreza čemur koli od uporabniško ime, IP, Začasni uporabnik, ime interwikija (npr. »predpona>ImePrimera«) in ID uporabnika (npr. »#12345«)
- rvtag
Navedba samo redakcij, ki so označene s to oznako.
- rvcontinue
Ko bo na voljo več rezultatov, uporabite to za nadaljevanje. Podrobnejše informacije o nadaljevanju poizvedb lahko najdete na mediawiki.org.
- Pridobitev podatkov z vsebino za zadnjo redakcijo naslovov API in Glavna stran.
- api.php?action=query&prop=revisions&titles=API|Glavna%20stran&rvslots=*&rvprop=timestamp|user|comment|content [odpri v peskovniku]
- Pridobitev zadnjih 5 redakcij za Glavna stran.
- api.php?action=query&prop=revisions&titles=Glavna%20stran&rvlimit=5&rvprop=timestamp|user|comment [odpri v peskovniku]
- Pridobitev prvih 5 redakcij za Glavna stran.
- api.php?action=query&prop=revisions&titles=Glavna%20stran&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [odpri v peskovniku]
- Pridobitev prvih 5 redakcij Glavna stran, narejenih po 1. maju 2006.
- api.php?action=query&prop=revisions&titles=Glavna%20stran&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [odpri v peskovniku]
- Pridobitev prvih 5 redakcij Glavna stran, ki jih ni naredil anonimni uporabnik 127.0.0.1.
- api.php?action=query&prop=revisions&titles=Glavna%20stran&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [odpri v peskovniku]
- Pridobitev prvih 5 redakcij Glavna stran, ki jih je ustvaril uporabnik MediaWiki default.
- api.php?action=query&prop=revisions&titles=Glavna%20stran&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [odpri v peskovniku]