MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
prop=revisions <pre>(rv) </pre>
- 此模組需要讀取權限。
- 此模块可作为发生器使用。
- 来源：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的格式并预估内容输出。
- 單值：text/x-wiki、text/javascript、application/json、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 [在沙盒中打开]