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 [在沙盒中打开]