MediaWiki API 帮助

这是自动生成的MediaWiki API文档页面。

文档和例子:-{R|https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page}-

prop=revisions (rv)

main | query | revisions
  • 此模块需要读取权限。
  • 此模块可作为发生器使用。
  • 来源:MediaWiki
  • 许可协议:GPL-2.0-or-later

获取修订版本信息。

可用于以下几个方面:

  1. 通过设置标题或页面ID获取一批页面(最新修订)的数据。
  2. 通过使用带start、end或limit的标题或页面ID获取给定页面的多个修订。
  3. 通过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属性。
tags
修订标签。
roles
列出存在於修訂的內容間隔作用。
parsetree
已弃用。请改用action=expandtemplatesaction=parse。修订内容的XML解析树(需要内容模型wikitext)。
值(以|替代物分隔):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
要指定所有值,请使用*
rvlimit

限制返回多少修订。

只能在单一页面模式中使用(模式#2)。
类型:整数或max
值必须介于1和500之间。
rvexpandtemplates
已弃用。

请改用action=expandtemplates。展开修订内容中的模板(需要rvprop=content)。

类型:布尔型 (详情)
rvgeneratexml
已弃用。

请改用action=expandtemplatesaction=parse。生成用于修订内容的XML解析树(需要rvprop=content;被rvprop=parsetree所取代)。

类型:布尔型 (详情)
rvparse
已弃用。

请改用action=parse。解析修订内容(需要rvprop=content)。由于性能原因,如果此选项被使用,rvlimit会被强制为1。

类型:布尔型 (详情)
rvsection

只检索此标识符对应章节的内容。

rvdiffto
已弃用。

请改用action=compare。要比较修订差异的修订ID。使用prevnextcur分别用于上个、下个和当前修订。

rvdifftotext
已弃用。

请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖rvdiffto。如果rvsection被设置,只有那个段落将与此文本之间比较差异

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

当更多结果可用时,使用这个继续。