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