MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子：https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
prop=revisions （rv）
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源：MediaWiki
- 许可协议：GPL-2.0-or-later
获取修订版本信息。
可用于以下几个方面：
- 通过设置标题或页面ID获取一批页面（最新修订）的数据。
- 通过使用带start、end或limit的标题或页面ID获取给定页面的多个修订。
- 通过revid设置一批修订的ID获取它们的数据。
- rvprop
要为每个修订获取的属性：
- ids
- 修订版本的ID。
- flags
- 修订标记（小编辑）。
- timestamp
- 修订的时间戳。
- user
- 进行修订的用户。如果用户已被版本删除，将返回userhidden属性。
- userid
- 修订创建者的用户ID。如果用户已被版本删除，将返回userhidden属性。
- size
- 修订的长度（字节）。
- slotsize
- 每次修订间隔的长度（字节）。
- sha1
- 修订版的SHA-1（base 16）。如果内容已被版本删除，将返回sha1hidden属性。
- slotsha1
- 每次修订间隔的SHA-1（base 16）。如果内容已被版本删除，将返回sha1hidden属性。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 用户对修订的评论。如果评论已被版本删除，将返回commenthidden属性。
- parsedcomment
- 用户对修订的解析注释。如果评论已被版本删除，将返回commenthidden属性。
- content
- 每次修订间隔的内容。如果内容已被版本删除，将返回texthidden属性。出于性能原因，如果使用此选项，rvlimit将强制为50。
- tags
- 修订标签。
- roles
- 列出修订版本中存在的内容槽位角色。
- parsetree
- 已弃用。请改用action=expandtemplates或action=parse。修订内容的XML解析树（需要内容模型
wikitext）。出于性能原因，如果使用此选项，rvlimit将强制为50。
- 值（以|或替代物分隔）：comment、content、contentmodel、flags、ids、parsedcomment、roles、sha1、size、slotsha1、slotsize、tags、timestamp、user、userid、parsetree
- 默认：ids|timestamp|flags|comment|user
- rvslots
当rvprops中包含与槽位相关的属性时，要返回哪个修订版本槽位的数据。如果省略，来自main槽位的数据将以向后兼容的格式返回。
- 值（以|或替代物分隔）：main
- 要指定所有值，请使用*。
- rvcontentformat-{slot}
用于输出内容的内容序列化格式。
- 这是一个模板参数。当做出请求时，参数名中的{slot}应替换为rvslots的值。
- 以下值中的一个：application/json、application/octet-stream、application/unknown、application/x-binary、text/css、text/javascript、text/plain、text/unknown、text/x-wiki、unknown/unknown
- rvlimit
限制返回多少修订。如果使用rvprop=content、rvprop=parsetree、rvdiffto或rvdifftotext，则上限为50。如果使用rvparse，则上限为1。
- 只能在单一页面模式中使用（模式#2）。
- 类型：整数或max
- 值必须介于1和500之间。
- 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分别用于上个、下个和当前修订。出于性能原因，如果使用此选项，rvlimit将强制为50。
- rvdifftotext
- 已弃用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖rvdiffto。如果rvsection被设置，只有那个段落将与此文本之间比较差异。出于性能原因，如果使用此选项，rvlimit将强制为50。
- rvdifftotextpst
- 已弃用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与rvdifftotext一起使用时有效。
- 类型：布尔型 (详情)
- rvcontentformat
- 已弃用。
序列化用于rvdifftotext的格式并预估内容输出。
- 以下值中的一个：application/json、application/octet-stream、application/unknown、application/x-binary、text/css、text/javascript、text/plain、text/unknown、text/x-wiki、unknown/unknown
- rvstartid
从这个修订版本时间戳开始列举。修订版本必须存在，但未必与该页面相关。
- 只能在单一页面模式中使用（模式#2）。
- 类型：整数
- rvendid
在这个修订版本时间戳停止列举。修订版本必须存在，但未必与该页面相关。
- 只能在单一页面模式中使用（模式#2）。
- 类型：整数
- rvstart
从哪个修订版本时间戳开始列举。
- 只能在单一页面模式中使用（模式#2）。
- 类型：时间戳（允许格式）
- rvend
列举直至此时间戳。
- 只能在单一页面模式中使用（模式#2）。
- 类型：时间戳（允许格式）
- rvdir
列举的方向：
- newer
- 最早的优先。注意：rvstart应早于rvend。
- older
- 最新的优先（默认）。注意：rvstart应晚于rvend。
- 只能在单一页面模式中使用（模式#2）。
- 以下值中的一个：newer、older
- 默认：older
- rvuser
只包含由用户做出的修订。
- 只能在单一页面模式中使用（模式#2）。
- 类型：通过 用户名、IP、临时用户、跨wiki用户名（例如“前缀>示例用户”）和用户ID(例如“#12345”) 中任意一种方式指定的用户
- rvexcludeuser
不包括由用户做出的修订。
- 只能在单一页面模式中使用（模式#2）。
- 类型：通过 用户名、IP、临时用户、跨wiki用户名（例如“前缀>示例用户”）和用户ID(例如“#12345”) 中任意一种方式指定的用户
- rvtag
只列出被此标签标记的修订。
- rvcontinue
当更多结果可用时，使用这个继续。可在 mediawiki.org 获取更多有关如何继续查询的详细信息。
- 获取带内容的数据，用于标题API和首页的最近修订。
- api.php?action=query&prop=revisions&titles=API|%E9%A6%96%E9%A1%B5&rvslots=*&rvprop=timestamp|user|comment|content [在沙盒中打开]
- 获取首页的最近5次修订。
- api.php?action=query&prop=revisions&titles=%E9%A6%96%E9%A1%B5&rvlimit=5&rvprop=timestamp|user|comment [在沙盒中打开]
- 获取首页的最早5次修订。
- api.php?action=query&prop=revisions&titles=%E9%A6%96%E9%A1%B5&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer [在沙盒中打开]
- 获取首页于2006年5月1日之后做出的前5次修订版本。
- api.php?action=query&prop=revisions&titles=%E9%A6%96%E9%A1%B5&rvlimit=5&rvprop=timestamp|user|comment&rvdir=newer&rvstart=2006-05-01T00:00:00Z [在沙盒中打开]
- 获取首页的前5次不是由匿名用户127.0.0.1做出的修订。
- api.php?action=query&prop=revisions&titles=%E9%A6%96%E9%A1%B5&rvlimit=5&rvprop=timestamp|user|comment&rvexcludeuser=127.0.0.1 [在沙盒中打开]
- 获取首页的前5次由用户MediaWiki default做出的修订。
- api.php?action=query&prop=revisions&titles=%E9%A6%96%E9%A1%B5&rvlimit=5&rvprop=timestamp|user|comment&rvuser=MediaWiki%20default [在沙盒中打开]