MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
prop=revisions （rv）
- 此模組需要讀取權限。
- 此模組可作為產生器使用。
- 來源：MediaWiki
- 協定：GPL-2.0-or-later
取得修訂的資訊。
可用于以下几个方面：
- 通过设置标题或页面ID获取一批页面（最新修订）的数据。
- 通过使用带start、end或limit的标题或页面ID获取给定页面的多个修订。
- 通过revid设置一批修订的ID获取它们的数据。
- rvprop
各修訂所要取得的屬性：
- ids
- 修訂 ID。
- flags
- 修訂標籤（小修改）。
- timestamp
- 修訂的時間戳記。
- user
- 做出修訂的使用者。
- userid
- 修訂創建者的使用者 ID
- size
- 修訂的長度（位元組）。
- slotsize
- 每次修订间隔的长度（字节）。
- sha1
- 修訂的 SHA-1（base 16）。
- slotsha1
- 每次修订间隔的SHA-1（base 16）。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 由用户对修订做出的摘要。
- parsedcomment
- 由用户对修订做出的被解析的摘要。
- content
- 每次修订间隔的内容。
- tags
- 修訂標籤。
- roles
- List content slot roles that exist in the revision.
- parsetree
- 已停用。 请改用action=expandtemplates或action=parse。修订内容的XML解析树（需要内容模型
wikitext）。
- 多值 (以 | 或 alternative 分隔)：ids、flags、timestamp、user、userid、size、slotsize、sha1、slotsha1、contentmodel、comment、parsedcomment、content、tags、roles、parsetree
- 預設值：ids|timestamp|flags|comment|user
- rvslots
Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- 多值 (以 | 或 alternative 分隔)：main
- 要指定所有值，請使用*。
- rvlimit
限制所回傳的修訂數量。
- 僅能在單一頁面使用（模式 #2）。
- 不允許超過 500 (機器人為 5,000)。
- 類型：整數或max
- rvexpandtemplates
- 已停用。
请改用action=expandtemplates。展开修订内容中的模板（需要rvprop=content）。
- 類型：布林值（詳細資訊）
- rvgeneratexml
- 已停用。
请改用action=expandtemplates或action=parse。生成用于修订内容的XML解析树（需要rvprop=content；被rvprop=parsetree所取代）。
- 類型：布林值（詳細資訊）
- rvparse
- 已停用。
请改用action=parse。解析修订内容（需要rvprop=content）。由于性能原因，如果此选项被使用，rvlimit会被强制为1。
- 類型：布林值（詳細資訊）
- rvsection
只检索此段落数的内容。
- rvdiffto
- 已停用。
请改用action=compare。要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- rvdifftotext
- 已停用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖rvdiffto。如果rvsection被设置，只有那个段落将与此文本之间比较差异
- rvdifftotextpst
- 已停用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与rvdifftotext一起使用时有效。
- 類型：布林值（詳細資訊）
- rvcontentformat
- 已停用。
序列化用于rvdifftotext的格式并预估内容输出。
- 單值：text/plain、text/x-wiki、text/javascript、application/json、text/css
- rvstartid
从这个修订版本时间戳开始列举。修订版本必须存在，但未必与该页面相关。
- 僅能在單一頁面使用（模式 #2）。
- 類型：整數
- rvendid
在这个修订版本时间戳停止列举。修订版本必须存在，但未必与该页面相关。
- 僅能在單一頁面使用（模式 #2）。
- 類型：整數
- rvstart
从哪个修订版本时间戳开始列举。
- 僅能在單一頁面使用（模式 #2）。
- 類型：時間戳記（允許格式）
- rvend
列舉至此的時間戳記。
- 僅能在單一頁面使用（模式 #2）。
- 類型：時間戳記（允許格式）
- rvdir
列舉的方向：
- newer
- 最舊的優先。注意：rvstart應在rvend之前。
- older
- 最新的優先（預設）。注意：rvstart應在rvend之後。
- 僅能在單一頁面使用（模式 #2）。
- 單值：newer、older
- 預設值：older
- rvuser
僅包含由使用者做出的修訂。
- 僅能在單一頁面使用（模式 #2）。
- 類型：使用者名稱
- rvexcludeuser
不包含由使用者做出的修訂。
- 僅能在單一頁面使用（模式 #2）。
- 類型：使用者名稱
- rvtag
僅列出以此標籤所標記的修訂。
- rvtoken
- 已停用。
要为每个修订版本获得的令牌。
- 多值 (以 | 或 alternative 分隔)：rollback
- rvcontinue
當有更多結果可用時，使用這個繼續。
- 取得用於標題 API 與 Main Page 最新修訂內容的資料。
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&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 裡並非由匿名使用者 127.0.0.1 所做出的最早前 5 筆修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [在沙盒中開啟]
- 取得 Main Page 裡由使用者 MediaWiki default 所做出的最早前 5 筆修訂。
- api.php?action=query&prop=revisions&titles=Main%20Page&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [在沙盒中開啟]