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属性。
- tags
- 修订标签。
- roles
- 列出修订版本中存在的内容槽位角色。
- parsetree
- 已弃用。请改用action=expandtemplates或action=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
- 要指定所有值,请使用*。
- 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
限制返回多少修订。
- 只能在单一页面模式中使用(模式#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分别用于上个、下个和当前修订。
- 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
当更多结果可用时,使用这个继续。可在 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 [在沙盒中打开]