MediaWiki API 幫助
這是自動(dòng)生成的MediaWiki API文檔頁(yè)面。
文檔和例子:https://www.mediawiki.org/wiki/API:Main_page/zh
prop=revisions (rv)
- 此模塊需要讀取權(quán)限。
- 此模塊可作為發(fā)生器使用。
- 來(lái)源:MediaWiki
- 許可協(xié)議:GPL-2.0+
獲取修訂版本信息。
可用于以下幾個(gè)方面:
- 通過(guò)設(shè)置標(biāo)題或頁(yè)面ID獲取一批頁(yè)面(最新修訂)的數(shù)據(jù)。
- 通過(guò)使用帶start、end或limit的標(biāo)題或頁(yè)面ID獲取給定頁(yè)面的多個(gè)修訂。
- 通過(guò)revid設(shè)置一批修訂的ID獲取它們的數(shù)據(jù)。
- rvprop
要為每個(gè)修訂獲取的屬性:
- ids
- 修訂ID。
- flags
- 修訂標(biāo)記(小編輯)。
- timestamp
- 修訂的時(shí)間戳。
- user
- 做出修訂的用戶(hù)。
- userid
- 修訂創(chuàng)建者的用戶(hù)ID。
- size
- 修訂的長(zhǎng)度(字節(jié))。
- sha1
- 修訂的SHA-1(base 16)。
- contentmodel
- 修訂的內(nèi)容模型ID。
- comment
- 由用戶(hù)對(duì)修訂做出的摘要。
- parsedcomment
- 由用戶(hù)對(duì)修訂做出的被解析的摘要。
- content
- 修訂文本。
- tags
- 修訂標(biāo)簽。
- parsetree
- 修訂內(nèi)容的XML解析樹(shù)(需要內(nèi)容模型
wikitext)。
- 值(以|分隔):ids、flags、timestamp、user、userid、size、sha1、contentmodel、comment、parsedcomment、content、tags、parsetree
- 默認(rèn):ids|timestamp|flags|comment|user
- rvlimit
限制返回多少修訂。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 不允許超過(guò)500個(gè)(對(duì)于機(jī)器人則是5,000個(gè))。
- 類(lèi)型:整數(shù)或max
- rvexpandtemplates
展開(kāi)修訂內(nèi)容中的模板(需要rvprop=content)。
- 類(lèi)型:布爾值(詳細(xì)信息)
- rvgeneratexml
- 不推薦使用。
生成用于修訂內(nèi)容的XML解析樹(shù)(需要rvprop=content;被rvprop=parsetree所取代)。
- 類(lèi)型:布爾值(詳細(xì)信息)
- rvparse
解析修訂內(nèi)容(需要rvprop=content)。由于性能原因,如果此選項(xiàng)被使用,rvlimit會(huì)被強(qiáng)制為1。
- 類(lèi)型:布爾值(詳細(xì)信息)
- rvsection
只檢索此段落數(shù)的內(nèi)容。
- rvdiffto
要比較修訂差異的修訂ID。使用prev、next和cur分別用于上個(gè)、下個(gè)和當(dāng)前修訂。
- rvdifftotext
要比較修訂差異的文本。只有修訂的有限數(shù)字內(nèi)的差異。覆蓋rvdiffto。如果rvsection被設(shè)置,只有那個(gè)段落將與此文本之間比較差異
- rvdifftotextpst
在編輯文本前對(duì)其執(zhí)行預(yù)保存轉(zhuǎn)換。只當(dāng)與rvdifftotext一起使用時(shí)有效。
- 類(lèi)型:布爾值(詳細(xì)信息)
- rvcontentformat
序列化用于rvdifftotext的格式并預(yù)估內(nèi)容輸出。
- 以下值中的一個(gè):application/json、text/x-wiki、text/javascript、text/css、text/plain
- rvstartid
從哪個(gè)修訂版本ID開(kāi)始列舉。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:整數(shù)
- rvendid
在此修訂版本ID停止修訂列舉。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:整數(shù)
- rvstart
從哪個(gè)修訂版本時(shí)間戳開(kāi)始列舉。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:時(shí)間戳(允許格式)
- rvend
列舉直至此時(shí)間戳。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:時(shí)間戳(允許格式)
- rvdir
列舉的方向:
- newer
- 最早的優(yōu)先。注意:rvstart應(yīng)早于rvend。
- older
- 最新的優(yōu)先(默認(rèn))。注意:rvstart應(yīng)晚于rvend。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 以下值中的一個(gè):newer、older
- 默認(rèn):older
- rvuser
只包含由用戶(hù)做出的修訂。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:用戶(hù)名
- rvexcludeuser
不包括由用戶(hù)做出的修訂。
- 可能只能與單一頁(yè)面使用(模式#2)。
- 類(lèi)型:用戶(hù)名
- rvtag
只列出被此標(biāo)簽標(biāo)記的修訂。
- rvtoken
- 不推薦使用。
要為每個(gè)修訂版本獲得的令牌。
- 值(以|分隔):rollback
- rvcontinue
當(dāng)更多結(jié)果可用時(shí),使用這個(gè)繼續(xù)。
- 獲取帶內(nèi)容的數(shù)據(jù),用于標(biāo)題API和Main Page的最近修訂。
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvprop=timestamp|user|comment|content [在沙盒中打開(kāi)]
- 獲取Main Page的最近5次修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment [在沙盒中打開(kāi)]
- 獲取Main Page的前5次修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [在沙盒中打開(kāi)]
- 獲取Main Page于2006年05月01日之后做出的前5次修訂版本。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [在沙盒中打開(kāi)]
- 獲取Main Page的前5次不是由匿名用戶(hù)127.0.0.1做出的修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [在沙盒中打開(kāi)]
- 獲取Main Page的前5次由用戶(hù)MediaWiki default做出的修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [在沙盒中打開(kāi)]