MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:https://www.mediawiki.org/wiki/API:Main_page/zh
主模块
- 来源:MediaWiki
- 许可协议:GPL-2.0+
状态信息:本页所展示的所有特性都应正常工作,但是API仍在开发当中,将会随时变化。请订阅mediawiki-api-announce 邮件列表以便获得更新通知。
错误请求:当API收到错误请求时,HTTP header将会返回一个包含"MediaWiki-API-Error"的值,随后header的值与error code将会送回并设置为相同的值。详细信息请参阅API: 错误与警告。
- action
要执行的操作。
- 以下值中的一个:block、checktoken、clearhasmsg、compare、createaccount、delete、edit、emailuser、expandtemplates、feedcontributions、feedrecentchanges、feedwatchlist、filerevert、help、imagerotate、import、login、logout、managetags、move、opensearch、options、paraminfo、parse、patrol、protect、purge、query、revisiondelete、rollback、rsd、setnotificationtimestamp、stashedit、tag、tokens、unblock、undelete、upload、userrights、watch
- 默认:help
- format
输出的格式。
- 以下值中的一个:dbg、dbgfm、json、jsonfm、none、php、phpfm、rawfm、txt、txtfm、xml、xmlfm、yaml、yamlfm
- 默认:jsonfm
- maxlag
最大延迟可被用于MediaWiki安装于数据库复制集中。要保存导致更多网站复制延迟的操作,此参数可使客户端等待直到复制延迟少于指定值时。万一发生过多延迟,错误代码maxlag会返回消息,例如等待$host中:延迟$lag秒。
参见Manual: Maxlag parameter以获取更多信息。- 类型:整数
- smaxage
设置
s-maxage
HTTP缓存控制头至这些秒。错误不会缓存。- 类型:整数
- 默认:0
- maxage
设置
max-age
HTTP缓存控制头至这些秒。错误不会缓存。- 类型:整数
- 默认:0
- assert
如果设置为user就验证用户是否登录,或如果设置为bot就验证是否有机器人用户权限。
- 以下值中的一个:user、bot
- requestid
任何在此提供的值将包含在响应中。可能可以用以区别请求。
- servedby
包含保存结果请求的主机名。
- 类型:布尔值(详细信息)
- curtimestamp
在结果中包括当前时间戳。
- 类型:布尔值(详细信息)
- origin
当通过跨域名AJAX请求(CORS)访问API时,设置此作为起始域名。这必须包括在任何pre-flight请求中,并因此必须是请求的URI的一部分(而不是POST正文)。这必须匹配
Origin
中的一个起点:从头到底,因此它已经设置为像https://zh.wikipedia.org或https://meta.wikimedia.org的东西。如果此参数不匹配Origin
页顶,就返回403错误响应。如果此参数匹配Origin
页顶并且起点被白名单,将设置一个Access-Control-Allow-Origin
开头。- uselang
用于消息翻译的语言。代码列表可从action=query&meta=siteinfo通过siprop=languages获取,或指定user以使用当前用户的语言设置,或指定content以使用此wiki的内容语言。
- 默认:user
- 主模块帮助。
- api.php?action=help
- 一个页面中的所有帮助。
- api.php?action=help&recursivesubmodules=1
action=block
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
封禁一位用户。
- user
您要封禁的用户、IP地址或IP地址段。
- 这个参数是必须的。
- expiry
到期时间。可以是相对时间(例如5 months或2 weeks)或绝对时间(例如2014-09-18T12:34:56Z)。如果设置为infinite、indefinite或never,封禁将无限期。
- 默认:never
- reason
封禁的原因。
- 默认:(空)
- anononly
只封禁匿名用户(也就是说禁止此 IP 地址的匿名编辑)。
- 类型:布尔值(详细信息)
- nocreate
防止创建帐户。
- 类型:布尔值(详细信息)
- autoblock
自动封禁最近使用的IP地址,以及以后他们尝试登陆使用的IP地址。
- 类型:布尔值(详细信息)
- noemail
阻止用户通过wiki发送电子邮件。(需要
blockemail
权限)。- 类型:布尔值(详细信息)
- hidename
从封禁日志中隐藏用户名。(需要
hideuser
权限)。- 类型:布尔值(详细信息)
- allowusertalk
允许用户编辑自己的讨论页(取决于$wgBlockAllowsUTEdit)。
- 类型:布尔值(详细信息)
- reblock
如果该用户已被封禁,则覆盖已有的封禁。
- 类型:布尔值(详细信息)
- watchuser
监视用户或该 IP 的用户页和讨论页。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 封禁IP地址192.0.2.5三天,原因First strike。
- api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC
- 无限期封禁用户Vandal,原因Vandalism,并阻止新账户创建和电子邮件发送。
- api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC
action=checktoken
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从action=query&meta=tokens检查令牌有效性。
- type
已开始测试的令牌类型。
- 这个参数是必须的。
- 以下值中的一个:csrf、patrol、rollback、userrights、watch
- token
要测试的令牌。
- 这个参数是必须的。
- maxtokenage
令牌的最大允许年龄,以秒计。
- 类型:整数
- 测试csrf令牌的有效性。
- api.php?action=checktoken&type=csrf&token=123ABC
action=clearhasmsg
- 此模块需要读取权限。
- 此模块需要写入权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
清除当前用户的hasmsg
标记。
- 清除当前用户的
hasmsg
标记。 - api.php?action=clearhasmsg
action=compare
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取2个页面之间的差别。
用于“from”和“to”的修订版本号、页面标题或页面 ID 必须获得通过。
- fromtitle
要比较的第一个标题。
- fromid
要比较的第一个页面 ID。
- 类型:整数
- fromrev
要比较的第一个修订版本。
- 类型:整数
- totitle
要比较的第二个标题。
- toid
要比较的第二个页面 ID。
- 类型:整数
- torev
要比较的第二个修订版本。
- 类型:整数
- 在版本1和2中创建差异。
- api.php?action=compare&fromrev=1&torev=2
action=createaccount
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
创建一个新用户账户。
- name
用户名。
- 这个参数是必须的。
- 类型:用户名
- password
密码(如果设置mailpassword则忽略)。
- domain
外部身份验证域 (可选)。
- token
在第一个请求中获得的帐户创建标记。
用户的电子邮件地址(可选)。
- realname
用户的真实姓名(可选)。
- mailpassword
如果设置为任何值,将向用户发送一个随机密码。
- 类型:布尔值(详细信息)
- reason
将要放在日志中的,关于创建帐户的可选原因。
- language
要为用户设置为默认值的语言代码(可选,默认为内容语言)。
- captchaword
Answer to the CAPTCHA
- captchaid
CAPTCHA ID from previous request
- 创建用户testuser和密码test123。
- api.php?action=createaccount&name=testuser&password=test123
- 创建用户testmailuser并电邮发送一个随机生成的密码。
- api.php?action=createaccount&name=testmailuser&mailpassword=true&reason=MyReason
action=delete
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
删除一个页面。
- title
你所希望删除的页面的标题。不能与pageid一起使用。
- pageid
要删除的页面的页面 ID。不能与title一起使用。
- 类型:整数
- reason
删除原因。如果未设置,将使用一个自动生成的原因。
- watch
- 不推荐使用。
将该页面加入当前用户的监视列表。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- unwatch
- 不推荐使用。
将该页面从当前用户的监视列表删除。
- 类型:布尔值(详细信息)
- oldimage
由action=query&prop=imageinfo&iiprop=archivename提供的要删除的旧图片名称。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 删除Main Page。
- api.php?action=delete&title=Main%20Page&token=123ABC
- 删除Main Page,原因Preparing for move。
- api.php?action=delete&title=Main%20Page&token=123ABC&reason=Preparing%20for%20move
action=edit
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
创建和编辑页面。
- title
您希望编辑的页面标题。不能与pageid一起使用。
- pageid
要编辑的页面的页面 ID。不能与title一起使用。
- 类型:整数
- section
段落数。0用于首段,new用于新的段落。
- sectiontitle
新小节的标题。
- text
页面内容。
- summary
编辑摘要。当section=new且未设置sectiontitle时,还包括小节标题。
- tags
更改标签以应用修订。
- 值(以|分隔):
- minor
小编辑。
- 类型:布尔值(详细信息)
- notminor
不是小编辑。
- 类型:布尔值(详细信息)
- bot
标记此编辑为机器人编辑。
- 类型:布尔值(详细信息)
- basetimestamp
基础修订的时间戳,用于检测编辑冲突。也许可以通过action=query&prop=revisions&rvprop=timestamp得到。
- 类型:时间戳(允许格式)
- starttimestamp
编辑过程开始的时间戳,用于检测编辑冲突。当开始编辑过程时(例如当加载要编辑的页面时)使用curtimestamp可能取得一个适当的值。
- 类型:时间戳(允许格式)
- recreate
覆盖有关该页面在此期间已被删除的任何错误。
- 类型:布尔值(详细信息)
- createonly
不要编辑页面,如果已经存在。
- 类型:布尔值(详细信息)
- nocreate
如果该页面不存在,则抛出一个错误。
- 类型:布尔值(详细信息)
- watch
- 不推荐使用。
将页面加入当前用户的监视列表。
- 类型:布尔值(详细信息)
- unwatch
- 不推荐使用。
将页面从当前用户的监视列表中移除。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- md5
text参数或prependtext和appendtext级联参数的MD5哈希值。如果设置,除非哈希值正确否则编辑无法完成。
- prependtext
将该文本添加到该页面的开始。覆盖text。
- appendtext
将该文本添加到该页面的结尾。覆盖text。
采用section=new来添加一个新的章节,而不是这个参数。
- undo
撤销此次修订。覆盖text、prependtext和appendtext。
- 类型:整数
- undoafter
撤销从undo至此的所有修订。如果不设置就撤销一次修订。
- 类型:整数
- redirect
自动解决重定向。
- 类型:布尔值(详细信息)
- contentformat
用于输入文本的内容串行化格式。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- contentmodel
新内容的内容模型。
- 以下值中的一个:wikitext、javascript、json、css、text
- token
从action=query&meta=tokens取回的“csrf”令牌
令牌应总是发送为最后参数,或至少在text参数之后。
- 这个参数是必须的。
- captchaword
Answer to the CAPTCHA
- captchaid
CAPTCHA ID from previous request
- 编辑一个页面。
- api.php?action=edit&title=Test&summary=test%20summary&text=article%20content&basetimestamp=2007-08-24T12:34:54Z&token=123ABC
- 页面中预置__NOTOC__。
- api.php?action=edit&title=Test&summary=NOTOC&minor=&prependtext=__NOTOC__%0A&basetimestamp=2007-08-24T12:34:54Z&token=123ABC
- 通过13585撤销修订版本13579并自动填写编辑摘要。
- api.php?action=edit&title=Test&undo=13585&undoafter=13579&basetimestamp=2007-08-24T12:34:54Z&token=123ABC
action=emailuser
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
电子邮件联系一位用户。
- target
电子邮件的目标用户。
- 这个参数是必须的。
- subject
主题页眉。
- text
邮件正文。
- 这个参数是必须的。
- ccme
给我发送一份该邮件的副本。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 向用户WikiSysop发送邮件,带文字Content。
- api.php?action=emailuser&target=WikiSysop&text=Content&token=123ABC
action=expandtemplates
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
展开维基文本中的所有模板。
- title
页面标题。
- 默认:API
- text
要转换的wiki文本。
- 这个参数是必须的。
- revid
修订版本ID,用于{{REVISIONID}}和类似变体。
- 类型:整数
- prop
要获取的那条信息。
注意如果没有选定值,结果将包含wiki文本,但将以弃用的格式显示。
- wikitext
- 扩充的wiki文本。
- categories
- Any categories present in the input that are not represented in the wikitext output.
- properties
- 由wiki文本中扩充的魔术字定义的页面属性。
- volatile
- 无论输出是否常常变动,均不应被在页面中其他任何位置重用。
- ttl
- 结果缓存应无效化后的最长时间。
- modules
- 任何解析器函数请求添加至输出的ResourceLoader模块。无论jsconfigvars还是encodedjsconfigvars都必须与modules共同被请求。
- jsconfigvars
- 针对页面提供JavaScript配置变量。
- encodedjsconfigvars
- 针对页面提供JavaScript配置变量为一个JSON字符串。
- parsetree
- 输入的XML分析树。
- 值(以|分隔):wikitext、categories、properties、volatile、ttl、modules、jsconfigvars、encodedjsconfigvars、parsetree
- includecomments
输出时是否包含HTML摘要。
- 类型:布尔值(详细信息)
- generatexml
- 不推荐使用。
生成XML解析树(取代自prop=parsetree)。
- 类型:布尔值(详细信息)
- 展开wiki文本{{Project:Sandbox}}。
- api.php?action=expandtemplates&text={{Project:Sandbox}}
action=feedcontributions
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回用户贡献纲要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- user
获取哪些用户的贡献。
- 这个参数是必须的。
- 类型:用户名
- namespace
过滤哪些命名空间的贡献。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- year
起始年份(及更早)。
- 类型:整数
- month
起始月份(及更早)。
- 类型:整数
- tagfilter
过滤有这些标签的贡献者。
- 值(以|分隔):
- 默认:(空)
- deletedonly
仅显示已删除的贡献。
- 类型:布尔值(详细信息)
- toponly
仅仅显示那些作为最新修订的编辑。
- 类型:布尔值(详细信息)
- newonly
仅仅显示那些作为页面创建的编辑。
- 类型:布尔值(详细信息)
- showsizediff
显示修订版本之间的大小差别。
- 类型:布尔值(详细信息)
- 返回用户Example的贡献。
- api.php?action=feedcontributions&user=Example
action=feedrecentchanges
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回最新变更纲要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- namespace
用于限制结果的命名空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- invert
除所选定者外的所有命名空间。
- 类型:布尔值(详细信息)
- associated
包括相关的命名空间(讨论页或主要)。
- 类型:布尔值(详细信息)
- days
用于限制结果的天数。
- 值必须不少于1。
- 类型:整数
- 默认:7
- limit
所要返回结果的最大数目。
- 值必须介于1和50之间。
- 类型:整数
- 默认:50
- from
显示自那时以来的更改。
- 类型:时间戳(允许格式)
- hideminor
隐藏小更改。
- 类型:布尔值(详细信息)
- hidebots
隐藏机器人所做的更改。
- 类型:布尔值(详细信息)
- hideanons
隐藏匿名用户做出的更改。
- 类型:布尔值(详细信息)
- hideliu
隐藏注册用户做出的更改。
- 类型:布尔值(详细信息)
- hidepatrolled
隐藏已巡查更改。
- 类型:布尔值(详细信息)
- hidemyself
隐藏当前用户做出的更改。
- 类型:布尔值(详细信息)
- tagfilter
按标签过滤。
- target
仅仅显示从该页面链出的那些页面的变更。
- showlinkedto
仅仅显示链入到该页面的那些页面的变更。
- 类型:布尔值(详细信息)
- 显示最近更改。
- api.php?action=feedrecentchanges
- 显示最近30天的更改。
- api.php?action=feedrecentchanges&days=30
action=feedwatchlist
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回监视列表纲要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- hours
列出从现在起数小时内修改的页面。
- 值必须介于1和72之间。
- 类型:整数
- 默认:24
- linktosections
如果可能的话,直接链接到已变更的小节。
- 类型:布尔值(详细信息)
- allrev
Include multiple revisions of the same page within given timeframe.
- 类型:布尔值(详细信息)
- wlowner
Used along with token to access a different user's watchlist.
- 类型:用户名
- wltoken
允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。
- wlshow
Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set show=minor|!anon.
- 值(以|分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、unread、!unread
- wltype
要显示的更改类型:
- edit
- 定期页面编辑。
- external
- 外部更改。
- new
- 页面创建。
- log
- 日志记录。
- 值(以|分隔):edit、external、new、log
- 默认:edit|new|log
- wlexcludeuser
不要列出此用户的更改。
- 类型:用户名
- 显示监视列表订阅。
- api.php?action=feedwatchlist
- 显示过去6小时内受监视页面的所有更改。
- api.php?action=feedwatchlist&allrev=&hours=6
action=filerevert
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
回退一个文件至某一旧版本。
- filename
目标文件名,不包含前缀“File:”。
- 这个参数是必须的。
- comment
上传评论。
- 默认:(空)
- archivename
恢复到修订版存档名称。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 回退Wiki.png至2011-03-05T15:27:40Z的版本。
- api.php?action=filerevert&filename=Wiki.png&comment=Revert&archivename=20110305152740!Wiki.png&token=123ABC
action=help
- 来源:MediaWiki
- 许可协议:GPL-2.0+
显示指定模块的帮助。
- 主模块帮助。
- api.php?action=help
- 一个页面中的所有帮助。
- api.php?action=help&recursivesubmodules=1
- 帮助模块本身的帮助。
- api.php?action=help&modules=help
- 两个查询子模块的帮助。
- api.php?action=help&modules=query+info|query+categorymembers
action=imagerotate
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
旋转一幅或多幅图像。
- rotation
顺时针旋转图像的度数。
- 这个参数是必须的。
- 以下值中的一个:90、180、270
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括gan、iu、kk、ku、shi、sr、tg、uz、zh。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 90度旋转File:Example.png。
- api.php?action=imagerotate&titles=File:Example.jpg&rotation=90&token=123ABC
- 将Category:Flip之中的所有图像旋转180度。
- api.php?action=imagerotate&generator=categorymembers&gcmtitle=Category:Flip&gcmtype=file&rotation=180&token=123ABC
action=import
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从另一个wiki或从一个XML文件导入页面。
注意当发送一个用于xml参数的文件时,HTTP POST必须作为一次文件上传完成(也就是使用multipart/form-data)。
- summary
导入摘要。
- xml
上传的XML文件。
- 必须被公布为使用multipart/form-data的一次文件上传。
- interwikisource
用于跨wiki导入:导入的来源wiki。
- 以下值中的一个:
- interwikipage
用于跨wiki导入:导入的页面。
- fullhistory
用于跨wiki导入:完整导入历史,而不只是最新版本。
- 类型:布尔值(详细信息)
- templates
用于跨wiki导入:连带导入所有包含的模板。
- 类型:布尔值(详细信息)
- namespace
导入至此名字空间。不能与rootpage一起使用。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- rootpage
作为此页面的子页面导入。不能与namespace一起使用。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=login (lg)
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
登录并获得身份验证Cookie。
在成功登录的情况下,所需的Cookie将包含在HTTP响应头中。在登录失败的情况下,进一步的尝试可能会被自动密码猜解攻击的限制所遏制。
- lgname
用户名。
- lgpassword
密码。
- lgdomain
域名(可选)。
- lgtoken
在首个请求中获得的登录令牌。
action=logout
- 来源:MediaWiki
- 许可协议:GPL-2.0+
退出并清除会话数据。
- 退出当前用户。
- api.php?action=logout
action=managetags
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
执行有关更改标签的管理任务。
- operation
要执行哪个操作:
- create
- 创建一个新的更改标签供手动使用。
- delete
- 从数据库中移除一个更改标签,包括移除已使用在所有修订版本、最近更改记录和日志记录上的该标签。
- activate
- 激活一个更改标签,允许用户手动应用它。
- deactivate
- 停用一个更改标签,阻止用户手动应用它。
- 这个参数是必须的。
- 以下值中的一个:create、delete、activate、deactivate
- tag
要创建、删除、激活或取消激活的标签。要创建标签,标签必须不存在。要删除标签,标签必须存在。要激活标签,标签必须存在,且不被任何扩展使用。要取消激活标签,标签必须当前处于激活状态,且被手动定义。
- 这个参数是必须的。
- reason
一个创建、删除、激活或停用标签时的原因,可选。
- ignorewarnings
是否忽略操作期间发生的任何警告。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 创建一个名为spam的标签,原因For use in edit patrolling
- api.php?action=managetags&operation=create&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC
- 删除vandlaism标签,原因Misspelt
- api.php?action=managetags&operation=delete&tag=vandlaism&reason=Misspelt&token=123ABC
- 激活一个名为spam的标签,原因For use in edit patrolling
- api.php?action=managetags&operation=activate&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC
- 停用一个名为spam的标签,原因No longer required
- api.php?action=managetags&operation=deactivate&tag=spam&reason=No+longer+required&token=123ABC
action=move
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
移动一个页面。
- from
要重命名的页面标题。不能与fromid一起使用。
- fromid
您希望移动的页面ID。不能与from一起使用。
- 类型:整数
- to
页面重命名的目标标题。
- 这个参数是必须的。
- reason
重命名的原因。
- 默认:(空)
- movetalk
重命名讨论页,如果存在。
- 类型:布尔值(详细信息)
- movesubpages
重命名子页面,如果可以。
- 类型:布尔值(详细信息)
- noredirect
不要创建重定向。
- 类型:布尔值(详细信息)
- watch
- 不推荐使用。
将页面和重定向加入至当前用户的监视列表中。
- 类型:布尔值(详细信息)
- unwatch
- 不推荐使用。
从当前用户的监视列表中移除页面及重定向。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- ignorewarnings
忽略任何警告。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 移动Badtitle到Goodtitle,不保留重定向。
- api.php?action=move&from=Badtitle&to=Goodtitle&token=123ABC&reason=Misspelled%20title&movetalk=&noredirect=
action=opensearch
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
使用OpenSearch协议搜索本wiki。
- search
搜索字符串。
- limit
要返回的结果最大数。
- 不允许超过100个(对于机器人则是100个)。
- 类型:整数或max
- 默认:10
- namespace
搜索的名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- suggest
如果$wgEnableOpenSearchSuggest设置为false则不做任何事情。
- 类型:布尔值(详细信息)
- redirects
如何处理重定向:
- return
- 返回重定向本身。
- resolve
- 返回目标页面。可能返回少于limit个结果。
由于历史原因,format=json默认为"return",其他格式默认为"resolve"。
- 以下值中的一个:return、resolve
- format
输出格式。
- 以下值中的一个:json、jsonfm、xml、xmlfm
- 默认:json
- warningsaserror
如果警告通过format=json提升,返回一个API错误而不是忽略它们。
- 类型:布尔值(详细信息)
- 查找以Te开头的页面。
- api.php?action=opensearch&search=Te
action=options
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
更改当前用户的偏好设置。
只有注册在核心或者已安装扩展中的选项,或者具有userjs-
键值前缀(旨在被用户脚本使用)的选项可被设置。
- reset
重置偏好设置到网站默认设置。
- 类型:布尔值(详细信息)
- resetkinds
当reset选项被设置时,要重置的选项类型列表。
- 值(以|分隔):registered、registered-multiselect、registered-checkmatrix、userjs、special、unused、all
- 默认:all
- change
更改列表,以name=value格式化(例如skin=vector)。值不能包含管道字符。如果没提供值(甚至没有等号),例如optionname|otheroption|...,选项将重置为默认值。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- optionname
应设置为由optionvalue提供值的选项名称。
- optionvalue
用于由optionname指定的选项的值,可以包含管道字符。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 重置所有用户设置。
- api.php?action=options&reset=&token=123ABC
- 更改skin和hideminor设置。
- api.php?action=options&change=skin=vector|hideminor=1&token=123ABC
- 重置所有设置,然后设置skin和nickname。
- api.php?action=options&reset=&change=skin=monobook&optionname=nickname&optionvalue=[[User:Beau|Beau]]%20([[User_talk:Beau|talk]])&token=123ABC
action=paraminfo
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获得关于API模块的信息。
- modules
模块名称(action和format参数值,或main)的列表。可通过+指定子模块。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- helpformat
帮助字符串的格式。
- 以下值中的一个:html、wikitext、raw、none
- 默认:none
- querymodules
- 不推荐使用。
查询模块名称(prop、meta或list参数值)的列表。使用modules=query+foo而不是querymodules=foo。
- 值(以|分隔):allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allmessages、allpages、allredirects、alltransclusions、allusers、backlinks、blocks、categories、categoryinfo、categorymembers、contributors、deletedrevisions、deletedrevs、duplicatefiles、embeddedin、extlinks、exturlusage、filearchive、filerepoinfo、fileusage、imageinfo、images、imageusage、info、iwbacklinks、iwlinks、langbacklinks、langlinks、links、linkshere、logevents、pagepropnames、pageprops、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、siteinfo、stashimageinfo、tags、templates、tokens、transcludedin、usercontribs、userinfo、users、watchlist、watchlistraw
- 值的最高数字是50(对于机器人则是500)。
- mainmodule
- 不推荐使用。
获取有关主要(最高级)模块的信息。也可使用modules=main。
- pagesetmodule
- 不推荐使用。
获取有关页面设置模块(提供titles=和朋友)的信息。
- formatmodules
- 不推荐使用。
格式模块名称(format参数的值)的列表。也可使用modules。
- 值(以|分隔):dbg、dbgfm、json、jsonfm、none、php、phpfm、rawfm、txt、txtfm、xml、xmlfm、yaml、yamlfm
action=parse
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
解析内容并返回解析器输出。
参见action=query的各种prop-module以从页面的当前版本获得信息。
这里有几种方法可以指定解析的文本:
- 指定一个页面或修订,使用page、pageid或oldid。
- 明确指定内容,使用text、title和contentmodel。
- 只指定一段摘要解析。prop应提供一个空值。
- title
文本属于的页面标题。如果省略,contentmodel就必须被指定,且API将作为标题使用。
- text
要解析的文本。使用title或contentmodel以控制内容模型。
- summary
所要解析的摘要。
- page
解析此页的内容。不能与text和title一起使用。
- pageid
解析此页的内容。覆盖page。
- 类型:整数
- redirects
如果page或pageid被设置为一个重定向,则解析它。
- 类型:布尔值(详细信息)
- oldid
解析该修订版本的内容。覆盖page和pageid。
- 类型:整数
- prop
要获取的信息束:
- text
- 提供wiki文本中的被解析文本。
- langlinks
- 在被解析的wiki文本中提供语言链接。
- categories
- 在被解析的wiki文本中提供分类。
- categorieshtml
- 提供HTML版本分类。
- links
- 在被解析的wiki文本中提供内部链接。
- templates
- 在被解析的wiki文本中提供模板。
- images
- 在被解析的wiki文本中提供图片。
- externallinks
- 在被解析的wiki文本中提供外部链接。
- sections
- 在被解析的wiki文本中提供段落。
- revid
- 添加被解析页面的修订ID。
- displaytitle
- 为被解析的wiki文本添加标题。
- headitems
- 提供项目以插入至页面的
<head>
。 - headhtml
- 提供页面的被解析
<head>
。 - modules
- 提供在页面中使用的ResourceLoader模块。无论jsconfigvars还是encodedjsconfigvars都必须与modules共同被请求。
- jsconfigvars
- 针对页面提供JavaScript配置变量。
- encodedjsconfigvars
- 针对页面提供JavaScript配置变量为一个JSON字符串。
- indicators
- 提供页面上使用的页面状态指示器的HTML。
- iwlinks
- 在被解析的wiki文本中提供跨wiki链接。
- wikitext
- 提供被解析的原始wiki文本。
- properties
- 提供多种定义在被解析的wiki文本中的属性。
- limitreportdata
- 以结构化的方式提供限制报告。如果disablelimitreport被设定则不提供数据。
- limitreporthtml
- 提供限制报告的HTML版本。当disablelimitreport被设置时不会提供数据。
- parsetree
- 修订内容的XML解析树(需要内容模型
wikitext
)
- 值(以|分隔):text、langlinks、categories、categorieshtml、links、templates、images、externallinks、sections、revid、displaytitle、headitems、headhtml、modules、jsconfigvars、encodedjsconfigvars、indicators、iwlinks、wikitext、properties、limitreportdata、limitreporthtml、parsetree
- 默认:text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties
- pst
在解析输入前,对输入做一次保存前变换处理。仅当使用文本时有效。
- 类型:布尔值(详细信息)
- onlypst
Do a pre-save transform (PST) on the input, but don't parse it. Returns the same wikitext, after a PST has been applied. Only valid when used with text.
- 类型:布尔值(详细信息)
- effectivelanglinks
包含由扩展提供的语言链接(用于与prop=langlinks一起使用)。
- 类型:布尔值(详细信息)
- section
只检索此段数的内容,或只当new生成新的段落时检索。
new段落只当指定text时受尊重。
- sectiontitle
当section为new时新段落标题。
不像页面编辑,当省略或为空时将不会备选为summary。
- disablepp
- 不推荐使用。
请改用disablelimitreport。
- 类型:布尔值(详细信息)
- disablelimitreport
从解析器输出中省略限制报告(“NewPP limit report”)。
- 类型:布尔值(详细信息)
- disableeditsection
从解析器输出中省略编辑段落链接。
- 类型:布尔值(详细信息)
- disabletidy
不要在解析器输出中运行HTML清理(例如tidy)。
- 类型:布尔值(详细信息)
- generatexml
- 不推荐使用。
生成XML解析树(需要内容模型
wikitext
;被prop=parsetree所取代)。- 类型:布尔值(详细信息)
- preview
在预览模式下解析。
- 类型:布尔值(详细信息)
- sectionpreview
在小节预览模式下解析 (同时要启用预览模式)。
- 类型:布尔值(详细信息)
- disabletoc
在输出中省略目录。
- 类型:布尔值(详细信息)
- contentformat
用于输入文本的内容序列化格式。只当与text一起使用时有效。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- contentmodel
Content model of the input text. If omitted, title must be specified, and default will be the model of the specified title. Only valid when used with text.
- 以下值中的一个:wikitext、javascript、json、css、text
action=patrol
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
巡查页面或修订版本。
- rcid
所要巡查的最近变更 ID。
- 类型:整数
- revid
要巡查的修订版本ID。
- 类型:整数
- token
从action=query&meta=tokens取回的“patrol”令牌
- 这个参数是必须的。
action=protect
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
更改页面的保护等级。
- title
要(解除)保护的页面标题。不能与pageid一起使用。
- pageid
要(解除)保护的页面ID。不能与title一起使用。
- 类型:整数
- protections
保护等级列表,格式:action=level(例如edit=sysop)。
注意:未列出的操作将移除限制。
- 这个参数是必须的。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- expiry
到期时间戳。如果只有一个时间戳被设置,它将被用于所有保护。使用infinite、indefinite、infinity或never用于永不过期的保护。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- 默认:infinite
- reason
(解除)保护的原因。
- 默认:(空)
- cascade
启用连锁保护(也就是保护包含于此页面的页面)。如果所有提供的保护等级不支持连锁,就将其忽略。
- 类型:布尔值(详细信息)
- watch
- 不推荐使用。
如果设置,就加入已开始(解除)保护的页面至当前用户的监视列表。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 保护一个页面。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=sysop|move=sysop&cascade=&expiry=20070901163000|never
- 通过设置限制为all解除保护一个页面。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=all|move=all&reason=Lifting%20restrictions
- 通过设置没有限制解除保护一个页面。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=&reason=Lifting%20restrictions
action=purge
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
为指定标题刷新缓存。
如果用户尚未登录的话,就需要POST请求。
- forcelinkupdate
更新链接表。
- 类型:布尔值(详细信息)
- forcerecursivelinkupdate
更新链接表中,并更新任何使用此页作为模板的页面的链接表。
- 类型:布尔值(详细信息)
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括gan、iu、kk、ku、shi、sr、tg、uz、zh。
- 类型:布尔值(详细信息)
- 刷新Main Page和API页面。
- api.php?action=purge&titles=Main_Page|API
- 刷新主名字空间的前10个页面。
- api.php?action=purge&generator=allpages&gapnamespace=0&gaplimit=10
action=query
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取来自和有关MediaWiki的数据。
所有数据修改将首先要使用查询以获得令牌以阻止来自恶意网站的滥用破坏。
- prop
要为已查询页面获取的属性。
- 值(以|分隔):categories、categoryinfo、contributors、deletedrevisions、duplicatefiles、extlinks、fileusage、imageinfo、images、info、iwlinks、langlinks、links、linkshere、pageprops、redirects、revisions、stashimageinfo、templates、transcludedin
- list
要获取的列表。
- 值(以|分隔):allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、allusers、backlinks、blocks、categorymembers、deletedrevs、embeddedin、exturlusage、filearchive、imageusage、iwbacklinks、langbacklinks、logevents、pagepropnames、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、search、tags、usercontribs、users、watchlist、watchlistraw
- meta
要获取的元数据。
- 值(以|分隔):allmessages、filerepoinfo、siteinfo、tokens、userinfo
- indexpageids
包含一个额外的pageid段落,列举所有返回的页面ID。
- 类型:布尔值(详细信息)
- export
导出所有指定或生成页面的当前修订。
- 类型:布尔值(详细信息)
- exportnowrap
返回导出XML,不需要将其包裹在一个XML结果中(与Special:Export格式相同)。只能与export一起使用。
- 类型:布尔值(详细信息)
- iwurl
如果标题是一个跨wiki链接的话,是否获取完整URL。
- 类型:布尔值(详细信息)
- continue
当更多结果可用时,使用这个继续。
- rawcontinue
为继续返回原始query-continue数据。
- 类型:布尔值(详细信息)
- titles
要工作的标题列表。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括gan、iu、kk、ku、shi、sr、tg、uz、zh。
- 类型:布尔值(详细信息)
prop=categories (cl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
页面属于的所有分类列表。
- clprop
要为每个分类获取的额外属性:
- sortkey
- 为每个分类添加关键词(十六进制字符串)和关键词前缀(人类可读部分)。
- timestamp
- 添加分类添加时的时间戳。
- hidden
- 标记由
__HIDDENCAT__
隐藏的分类。
- 值(以|分隔):sortkey、timestamp、hidden
- clshow
显示何种分类。
- 值(以|分隔):hidden、!hidden
- cllimit
返回多少分类。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- clcontinue
当更多结果可用时,使用这个继续。
- clcategories
Only list these categories. Useful for checking whether a certain page is in a certain category.
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- cldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 获取属于Albert Einstein的分类列表。
- api.php?action=query&prop=categories&titles=Albert%20Einstein
- 获得有关用于Albert Einstein的分类的信息。
- api.php?action=query&generator=categories&titles=Albert%20Einstein&prop=info
prop=categoryinfo (ci)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回有关给定分类的信息。
- cicontinue
当更多结果可用时,使用这个继续。
- 获取有关Category:Foo和Category:Bar的信息。
- api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar
prop=contributors (pc)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取对一个页面的登录贡献者列表和匿名贡献数。
- pcgroup
Only include users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.
- 值(以|分隔):bot、sysop、bureaucrat
- pcexcludegroup
Exclude users in the given groups. Does not include implicit or auto-promoted groups like *, user, or autoconfirmed.
- 值(以|分隔):bot、sysop、bureaucrat
- pcrights
Only include users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.
- 值(以|分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi、skipcaptcha、interwiki
- 值的最高数字是50(对于机器人则是500)。
- pcexcluderights
Exclude users having the given rights. Does not include rights granted by implicit or auto-promoted groups like *, user, or autoconfirmed.
- 值(以|分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi、skipcaptcha、interwiki
- 值的最高数字是50(对于机器人则是500)。
- pclimit
返回的贡献数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- pccontinue
当更多结果可用时,使用这个继续。
- 显示Main Page的贡献。
- api.php?action=query&prop=contributors&titles=Main_Page
prop=deletedrevisions (drv)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获得删除修订版本信息。
可在很多途径中使用:
- 获得一组页面的已删除修订,通过设置标题或页面ID。以标题和时间戳排序。
- 通过设置它们的ID与修订ID获得关于一组已删除修订。以修订ID排序。
- drvprop
要为每个修订获取的属性:
- 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
- drvlimit
限制返回多少修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- drvexpandtemplates
展开修订内容中的模板(需要drvprop=content)。
- 类型:布尔值(详细信息)
- drvgeneratexml
- 不推荐使用。
生成用于修订内容的XML解析树(需要drvprop=content;被drvprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- drvparse
解析修订内容(需要drvprop=content)。由于性能原因,如果此选项被使用,drvlimit会被强制为1。
- 类型:布尔值(详细信息)
- drvsection
只检索此段落数的内容。
- drvdiffto
要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- drvdifftotext
要比较修订差异的文本。只有修订的有限数字内的差异。覆盖drvdiffto。如果drvsection被设置,只有那个段落将与此文本之间比较差异
- drvcontentformat
序列化用于drvdifftotext的格式并预估内容输出。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- drvstart
The timestamp to start enumerating from. Ignored when processing a list of revision IDs.
- 类型:时间戳(允许格式)
- drvend
The timestamp to stop enumerating at. Ignored when processing a list of revision IDs.
- 类型:时间戳(允许格式)
- drvdir
列举的方向:
- newer
- 最早的优先。注意:drvstart应早于drvend。
- older
- 最新的优先(默认)。注意:drvstart应晚于drvend。
- 以下值中的一个:newer、older
- 默认:older
- drvtag
只列出被此标签标记的修订。
- drvuser
只列出此用户做出的修订。
- 类型:用户名
- drvexcludeuser
不要列出此用户做出的修订。
- 类型:用户名
- drvcontinue
当更多结果可用时,使用这个继续。
- 列出页面Main Page和Talk:Main Page的已删除修订,包含内容。
- api.php?action=query&prop=deletedrevisions&titles=Main%20Page|Talk:Main%20Page&drvprop=user|comment|content
- 列出已删除修订123456的信息。
- api.php?action=query&prop=deletedrevisions&revids=123456
prop=duplicatefiles (df)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
List all files that are duplicates of the given files based on hash values.
- dflimit
返回多少重复文件。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- dfcontinue
当更多结果可用时,使用这个继续。
- dfdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- dflocalonly
只看本地存储库的文件。
- 类型:布尔值(详细信息)
prop=extlinks (el)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从指定页面返回所有外部URL(非跨wiki链接)。
- ellimit
返回多少链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- eloffset
当更多结果可用时,使用这个继续。
- 类型:整数
- elprotocol
URL协议。如果为空并且elquery被设置,协议为http。将此和elquery都留空以列举所有外部链接。
- 以下值中的一个:可以为空,或bitcoin、ftp、ftps、geo、git、gopher、http、https、irc、ircs、magnet、mailto、mms、news、nntp、redis、sftp、sip、sips、sms、ssh、svn、tel、telnet、urn、worldwind、xmpp
- 默认:(空)
- elquery
不使用协议搜索字符串。对于检查某一页面是否包含某一外部URL很有用。
- elexpandurl
扩展协议相对URL与规范协议。
- 类型:布尔值(详细信息)
- 获取Main Page的外部链接列表。
- api.php?action=query&prop=extlinks&titles=Main%20Page
prop=fileusage (fu)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有使用指定文件的页面。
- fuprop
要获取的属性:
- pageid
- 每个页面的页面ID。
- title
- 每个页面的标题。
- redirect
- 标记作为重定向的页面。
- 值(以|分隔):pageid、title、redirect
- 默认:pageid|title|redirect
- funamespace
只包括这些名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- fushow
只显示符合以下标准的项:
- redirect
- 只显示重定向。
- !redirect
- 只显示非重定向。
- 值(以|分隔):redirect、!redirect
- fulimit
返回多少。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- fucontinue
当更多结果可用时,使用这个继续。
prop=imageinfo (ii)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回文件信息和上传历史。
- iiprop
要获取的文件信息:
- timestamp
- 添加时间戳至上传的版本。
- user
- 添加上传了每个文件版本的用户。
- userid
- 添加上传了每个文件版本的用户ID。
- comment
- 此版本的摘要。
- parsedcomment
- 解析版本上的注释。
- canonicaltitle
- 添加文件的规范标题。
- url
- 为文件及其描述页面提供URL。
- size
- 添加文件大小(字节)及其高度、宽度和页面数(如果可以)。
- dimensions
- 用于大小的别名。
- sha1
- 为文件加入SHA-1哈希值。
- mime
- 添加文件的MIME类型。
- thumbmime
- 添加图片缩略图的MIME类型(需要url和参数iiurlwidth)。
- mediatype
- 添加文件媒体类型。
- metadata
- 列出这个版本的文件的EXIF元数据。
- commonmetadata
- 为文件的修订版本列出文件格式相关元数据。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。
- archivename
- 添加用于非最新修订的存档修订的文件名。
- bitdepth
- 添加修订的字节深度。
- uploadwarning
- 由Special:Upload所使用,以获取关于现有文件的信息。不适用于MediaWiki核心以外代码。
- 值(以|分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、mediatype、metadata、commonmetadata、extmetadata、archivename、bitdepth、uploadwarning
- 默认:timestamp|user
- iilimit
每个文件返回多少文件修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:1
- iistart
开始列举的时间戳。
- 类型:时间戳(允许格式)
- iiend
列举的结束时间戳。
- 类型:时间戳(允许格式)
- iiurlwidth
如果iiprop=url被设定,将返回至缩放到此宽度的一张图片的URL。 由于性能原因,如果此消息被使用,将不会返回超过50张被缩放的图片。
- 类型:整数
- 默认:-1
- iiurlheight
与iiurlwidth类似。
- 类型:整数
- 默认:-1
- iimetadataversion
要使用的元数据版本。如果latest被指定,则使用最新版本。默认为1以便向下兼容。
- 默认:1
- iiextmetadatalanguage
要取得extmetadata的语言。This affects both which translation to fetch, if multiple are available, as well as how things like numbers and various values are formatted.
- 默认:zh-hans
- iiextmetadatamultilang
如果用于extmetadata属性的翻译可用,则全部取得。
- 类型:布尔值(详细信息)
- iiextmetadatafilter
如果指定且非空,则只为iiprop=extmetadata返回这些键。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- iiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。iiurlwidth必须被使用,并与iiurlparam一致。
- 默认:(空)
- iicontinue
当更多结果可用时,使用这个继续。
- iilocalonly
只看本地存储库的文件。
- 类型:布尔值(详细信息)
prop=images (im)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回指定页面上包含的所有文件。
- imlimit
返回多少文件。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- imcontinue
当更多结果可用时,使用这个继续。
- imimages
Only list these files. Useful for checking whether a certain page has a certain file.
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- imdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
prop=info (in)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取基本页面信息。
- inprop
要获取的额外属性:
- protection
- 列出每个页面的保护等级。
- talkid
- 每个非讨论页面的讨论页的页面ID。
- watched
- 列出每个页面的被监视状态。
- watchers
- 监视人员数,如果允许。
- notificationtimestamp
- 每个页面的监视列表通知时间戳。
- subjectid
- 每个讨论页的母页面的页面ID。
- url
- 为每个页面提供一个完整URL、一个编辑URL和规范URL。
- readable
- 用户是否可以阅读此页面。
- preload
- 提供由EditFormPreloadText返回的文本。
- displaytitle
- 在页面标题实际显示的地方提供方式。
- 值(以|分隔):protection、talkid、watched、watchers、notificationtimestamp、subjectid、url、readable、preload、displaytitle
- intestactions
测试当前用户是否可以在页面上执行某种操作。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- intoken
- 不推荐使用。
- 值(以|分隔):edit、delete、protect、move、block、unblock、email、import、watch
- incontinue
当更多结果可用时,使用这个继续。
- 获取有关页面Main Page的信息。
- api.php?action=query&prop=info&titles=Main%20Page
- 获取Main Page相关的常规和保护信息。
- api.php?action=query&prop=info&inprop=protection&titles=Main%20Page
prop=iwlinks (iw)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从指定页面返回所有跨wiki链接。
- iwprop
要为每个跨语言链接获取的额外属性:
- url
- 添加完整URL。
- 值(以|分隔):url
- iwprefix
只返回此前缀的跨wiki链接。
- iwtitle
用于搜索的跨wiki链接。必须与iwprefix一起使用。
- iwdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- iwlimit
返回多少跨wiki链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- iwcontinue
当更多结果可用时,使用这个继续。
- iwurl
- 不推荐使用。
是否获取完整URL(不能与iwprop一起使用)。
- 类型:布尔值(详细信息)
- 从页面Main Page获得跨wiki链接。
- api.php?action=query&prop=iwlinks&titles=Main%20Page
prop=langlinks (ll)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从指定页面返回所有跨语言链接。
- llprop
要为每个跨语言链接获取的额外属性:
- url
- 添加完整URL。
- langname
- 添加本地化语言名(尽可能)。使用llinlanguagecode以控制语言。
- autonym
- 添加本地语言名。
- 值(以|分隔):url、langname、autonym
- lllang
只返回带此语言代码的语言链接。
- lltitle
要搜索的链接。必须与lllang一起使用。
- lldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- llinlanguagecode
本地化语言名称的语言代码。
- 默认:zh-hans
- lllimit
返回多少语言链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- llcontinue
当更多结果可用时,使用这个继续。
- llurl
- 不推荐使用。
是否获取完整URL(不能与llprop一起使用)。
- 类型:布尔值(详细信息)
- 从页面Main Page获取跨语言链接。
- api.php?action=query&prop=langlinks&titles=Main%20Page&redirects=
prop=links (pl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从指定页面返回所有链接。
- plnamespace
只显示这些名字空间的链接。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- pllimit
返回多少链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- plcontinue
当更多结果可用时,使用这个继续。
- pltitles
Only list links to these titles. Useful for checking whether a certain page links to a certain title.
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 从页面Main Page获取链接。
- api.php?action=query&prop=links&titles=Main%20Page
- 获取有关在页面Main Page中连接的页面的信息。
- api.php?action=query&generator=links&titles=Main%20Page&prop=info
- 获取在用户和模板名字空间中来自页面Main Page的链接。
- api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10
prop=linkshere (lh)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有链接至指定页面的页面。
- lhprop
要获取的属性:
- pageid
- 每个页面的页面ID。
- title
- 每个页面的标题。
- redirect
- 如果页面是一个重定向就标记。
- 值(以|分隔):pageid、title、redirect
- 默认:pageid|title|redirect
- lhnamespace
只包括这些名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- lhshow
只显示符合以下标准的项:
- redirect
- 只显示重定向。
- !redirect
- 只显示非重定向。
- 值(以|分隔):redirect、!redirect
- lhlimit
返回多少。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- lhcontinue
当更多结果可用时,使用这个继续。
prop=pageprops (pp)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取页面内容中定义的各种属性。
- ppcontinue
当更多结果可用时,使用这个继续。
- ppprop
只列出这些组。在检查某一页面是否使用某一个页面属性时有用。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- 获取用于页面Main Page和MediaWiki的属性。
- api.php?action=query&prop=pageprops&titles=Main%20Page|MediaWiki
prop=redirects (rd)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回至指定页面的所有重定向。
- rdprop
要获取的属性:
- pageid
- 每个重定向的页面ID。
- title
- 每个重定向的标题。
- fragment
- 每个重定向的碎片,如果有。
- 值(以|分隔):pageid、title、fragment
- 默认:pageid|title
- rdnamespace
只包含这些名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- rdshow
Show only items that meet these criteria:
- fragment
- Only show redirects with a fragment.
- !fragment
- Only show redirects without a fragment.
- 值(以|分隔):fragment、!fragment
- rdlimit
返回多少重定向。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- rdcontinue
当更多结果可用时,使用这个继续。
prop=revisions (rv)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Get revision information.
May be used in several ways:
- Get data about a set of pages (last revision), by setting titles or pageids.
- Get revisions for one given page, by using titles or pageids with start, end, or limit.
- Get data about a set of revisions by setting their IDs with revids.
- 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被设置,只有那个段落将与此文本之间比较差异
- rvcontentformat
序列化用于rvdifftotext的格式并预估内容输出。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- rvstartid
From which revision ID to start enumeration.
- 可能只能与单一页面使用(模式#2)。
- 类型:整数
- rvendid
Stop revision enumeration on this revision ID.
- 可能只能与单一页面使用(模式#2)。
- 类型:整数
- rvstart
From which revision timestamp to start enumeration.
- 可能只能与单一页面使用(模式#2)。
- 类型:时间戳(允许格式)
- rvend
列举直至此时间戳。
- 可能只能与单一页面使用(模式#2)。
- 类型:时间戳(允许格式)
- rvdir
列举的方向:
- newer
- 最早的优先。注意:rvstart应早于rvend。
- older
- 最新的优先(默认)。注意:rvstart应晚于rvend。
- 可能只能与单一页面使用(模式#2)。
- 以下值中的一个:newer、older
- 默认:older
- rvuser
Only include revisions made by user.
- 可能只能与单一页面使用(模式#2)。
- 类型:用户名
- rvexcludeuser
Exclude revisions made by user.
- 可能只能与单一页面使用(模式#2)。
- 类型:用户名
- rvtag
Only list revisions tagged with this tag.
- rvtoken
- 不推荐使用。
Which tokens to obtain for each revision.
- 值(以|分隔):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
prop=stashimageinfo (sii)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回用于藏匿文件的文件信息。
- siifilekey
Key that identifies a previous upload that was stashed temporarily.
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- siisessionkey
- 不推荐使用。
siifilekey的别名,用于向后兼容。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- siiprop
要获取的文件信息:
- timestamp
- 添加时间戳至上传的版本。
- canonicaltitle
- 添加文件的规范标题。
- url
- 为文件及其描述页面提供URL。
- size
- 添加文件大小(字节)及其高度、宽度和页面数(如果可以)。
- dimensions
- 用于大小的别名。
- sha1
- 为文件加入SHA-1哈希值。
- mime
- 添加文件的MIME类型。
- thumbmime
- 添加图片缩略图的MIME类型(需要url和参数siiurlwidth)。
- metadata
- 列出这个版本的文件的EXIF元数据。
- commonmetadata
- 为文件的修订版本列出文件格式相关元数据。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。
- bitdepth
- 添加修订的字节深度。
- 值(以|分隔):timestamp、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、metadata、commonmetadata、extmetadata、bitdepth
- 默认:timestamp|url
- siiurlwidth
如果siiprop=url被设定,将返回至缩放到此宽度的一张图片的URL。 由于性能原因,如果此消息被使用,将不会返回超过50张被缩放的图片。
- 类型:整数
- 默认:-1
- siiurlheight
与siiurlwidth类似。
- 类型:整数
- 默认:-1
- siiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。siiurlwidth必须被使用,并与siiurlparam一致。
- 默认:(空)
- 返回藏匿文件的信息。
- api.php?action=query&prop=stashimageinfo&siifilekey=124sd34rsdf567
- Returns thumbnails for two stashed files.
- api.php?action=query&prop=stashimageinfo&siifilekey=b34edoe3|bceffd4&siiurlwidth=120&siiprop=url
prop=templates (tl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回指定页面上所有被嵌入的页面。
- tlnamespace
只显示此名字空间的模板。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- tllimit
返回的模板数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- tlcontinue
当更多结果可用时,使用这个继续。
- tltemplates
只列出这些模板。对于检查某一页面使用某一模板很有用。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- tldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 获取在页面Main Page使用的模板。
- api.php?action=query&prop=templates&titles=Main%20Page
- 获取有关Main Page中使用的模板页面的信息。
- api.php?action=query&generator=templates&titles=Main%20Page&prop=info
- 获取在用户和模板名字空间中,嵌入在Main Page页面的页面。
- api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10
prop=transcludedin (ti)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Find all pages that transclude the given pages.
- tiprop
要获取的属性:
- pageid
- 每个页面的页面ID。
- title
- 每个页面的标题。
- redirect
- 标记作为重定向的页面。
- 值(以|分隔):pageid、title、redirect
- 默认:pageid|title|redirect
- tinamespace
至包含这些名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- tishow
只显示符合以下标准的项:
- redirect
- 只显示重定向。
- !redirect
- 只显示非重定向。
- 值(以|分隔):redirect、!redirect
- tilimit
返回多少。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ticontinue
当更多结果可用时,使用这个继续。
- 获取嵌入Main Page的页面列表。
- api.php?action=query&prop=transcludedin&titles=Main%20Page
- 获取有关嵌入Main Page的页面的信息。
- api.php?action=query&generator=transcludedin&titles=Main%20Page&prop=info
list=allcategories (ac)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列举所有分类。
- acfrom
要作为枚举起始点的类别。
- accontinue
当更多结果可用时,使用这个继续。
- acto
要作为枚举终止点的类别。
- acprefix
搜索所有以此值开头的分类标题。
- acdir
排序方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- acmin
只返回至少带这么多成员的分类。
- 类型:整数
- acmax
只返回最多带这么多成员的分类。
- 类型:整数
- aclimit
要返回多少个类别。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- acprop
要获取的属性:
- size
- 在分类中添加页面数。
- hidden
- 标记由
__HIDDENCAT__
隐藏的分类。
- 值(以|分隔):size、hidden
- 默认:(空)
- 列出分类及其含有多少页面的信息。
- api.php?action=query&list=allcategories&acprop=size
- 为以List的分类检索有关分类页面本身的信息。
- api.php?action=query&generator=allcategories&gacprefix=List&prop=info
list=alldeletedrevisions (adr)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列举由一位用户或在一个名字空间中所有已删除的修订。
- adrprop
要为每个修订获取的属性:
- 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
- adrlimit
限制返回多少修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- adrexpandtemplates
展开修订内容中的模板(需要adrprop=content)。
- 类型:布尔值(详细信息)
- adrgeneratexml
- 不推荐使用。
生成用于修订内容的XML解析树(需要adrprop=content;被adrprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- adrparse
解析修订内容(需要adrprop=content)。由于性能原因,如果此选项被使用,adrlimit会被强制为1。
- 类型:布尔值(详细信息)
- adrsection
只检索此段落数的内容。
- adrdiffto
要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- adrdifftotext
要比较修订差异的文本。只有修订的有限数字内的差异。覆盖adrdiffto。如果adrsection被设置,只有那个段落将与此文本之间比较差异
- adrcontentformat
序列化用于adrdifftotext的格式并预估内容输出。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- adruser
只列出此用户做出的修订。
- 类型:用户名
- adrnamespace
只列出此名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- adrstart
枚举的起始时间戳。
- 只可以与adruser一起使用。
- 类型:时间戳(允许格式)
- adrend
枚举的结束时间戳。
- 只可以与adruser一起使用。
- 类型:时间戳(允许格式)
- adrdir
列举的方向:
- newer
- 最早的优先。注意:adrstart应早于adrend。
- older
- 最新的优先(默认)。注意:adrstart应晚于adrend。
- 以下值中的一个:newer、older
- 默认:older
- adrfrom
从此标题开始列出。
- 不能与adruser一起使用。
- adrto
列出至此标题为止。
- 不能与adruser一起使用。
- adrprefix
搜索所有以此值开头的页面标题。
- 不能与adruser一起使用。
- adrexcludeuser
不要列出此用户做出的修订。
- 不能与adruser一起使用。
- 类型:用户名
- adrtag
只列出被此标签标记的修订。
- adrcontinue
当更多结果可用时,使用这个继续。
- adrgeneratetitles
当作为生成器使用时,生成标题而不是修订ID。
- 类型:布尔值(详细信息)
- 列出由Example作出的最近50次已删除贡献。
- api.php?action=query&list=alldeletedrevisions&adruser=Example&adrlimit=50
- 列出前50次已删除的主名字空间修订。
- api.php?action=query&list=alldeletedrevisions&adrdir=newer&adrlimit=50
list=allfileusages (af)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出所有文件用途,包括不存在的。
- afcontinue
当更多结果可用时,使用这个继续。
- affrom
要列举的起始文件标题。
- afto
要列举的最终文件标题。
- afprefix
搜索所有以此值开头的文件标题。
- afunique
只显示明显的文件标题。不能与afprop=ids一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- afprop
要包含的信息束:
- ids
- 添加使用中的页面的页面ID(不能与afunique一起使用)。
- title
- 添加文件的标题。
- 值(以|分隔):ids、title
- 默认:title
- aflimit
要返回的总计项目。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- afdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 列举文件标题,包含丢失的文件、它们来自的页面ID,以B开头。
- api.php?action=query&list=allfileusages&affrom=B&afprop=ids|title
- 列出唯一文件标题。
- api.php?action=query&list=allfileusages&afunique=&affrom=B
- 获取所有文件标题,并标记出缺失者。
- api.php?action=query&generator=allfileusages&gafunique=&gaffrom=B
- 获取包含这些文件的页面。
- api.php?action=query&generator=allfileusages&gaffrom=B
list=allimages (ai)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
按顺序枚举所有图像。
- aisort
要作为排序方式的属性。
- 以下值中的一个:name、timestamp
- 默认:name
- aidir
罗列所采用的方向。
- 以下值中的一个:ascending、descending、newer、older
- 默认:ascending
- aifrom
要列举的起始图片标题。只能与aisort=name一起使用。
- aito
要列举的最终图片标题。只能与aisort=name一起使用。
- aicontinue
当更多结果可用时,使用这个继续。
- aistart
要列举的起始时间戳。只能与aisort=timestamp一起使用。
- 类型:时间戳(允许格式)
- aiend
要列举的最终时间戳。只能与aisort=timestamp一起使用。
- 类型:时间戳(允许格式)
- aiprop
要获取的文件信息:
- timestamp
- 添加时间戳至上传的版本。
- user
- 添加上传了每个文件版本的用户。
- userid
- 添加上传了每个文件版本的用户ID。
- comment
- 此版本的摘要。
- parsedcomment
- 解析版本上的注释。
- canonicaltitle
- 添加文件的规范标题。
- url
- 为文件及其描述页面提供URL。
- size
- 添加文件大小(字节)及其高度、宽度和页面数(如果可以)。
- dimensions
- 用于大小的别名。
- sha1
- 为文件加入SHA-1哈希值。
- mime
- 添加文件的MIME类型。
- mediatype
- 添加文件媒体类型。
- metadata
- 列出这个版本的文件的EXIF元数据。
- commonmetadata
- 为文件的修订版本列出文件格式相关元数据。
- extmetadata
- 列出结合自多个来源的格式化的元数据。结果均依HTML格式化。
- bitdepth
- 添加修订的字节深度。
- 值(以|分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、mediatype、metadata、commonmetadata、extmetadata、bitdepth
- 默认:timestamp|url
- aiprefix
搜索所有以此值开头的图像标题。只能与aisort=name一起使用。
- aiminsize
限于至少这么多字节的图像。
- 类型:整数
- aimaxsize
限于顶多这么多字节的图像。
- 类型:整数
- aisha1
图像的 SHA1 哈希。覆盖aisha1base36。
- aisha1base36
基于base 36的图片的SHA1哈希值(用于MediaWiki)。
- aiuser
只返回此用户上传的文件。只能与aisort=timestamp一起使用。不能与aifilterbots一起使用。
- 类型:用户名
- aifilterbots
如何过滤由机器人上传的文件。只能与aisort=timestamp一起使用。不能与aiuser一起使用。
- 以下值中的一个:all、bots、nobots
- 默认:all
- aimime
要搜索的MIME类型,例如image/jpeg。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- ailimit
共计要返回多少图像。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- 显示以字母B开始的文件列表。
- api.php?action=query&list=allimages&aifrom=B
- 显示一个最近上传文件的列表,类似Special:NewFiles。
- api.php?action=query&list=allimages&aiprop=user|timestamp|url&aisort=timestamp&aidir=older
- 显示带MIME类型image/png或image/gif的文件列表
- api.php?action=query&list=allimages&aimime=image/png|image/gif
- 显示有关4个以T开头的文件的信息。
- api.php?action=query&generator=allimages&gailimit=4&gaifrom=T&prop=imageinfo
list=alllinks (al)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列举所有指向至指定名字空间的链接。
- alcontinue
当更多结果可用时,使用这个继续。
- alfrom
要列举的起始标题链接。
- alto
要列举的最终标题链接。
- alprefix
搜索所有以此值开头的已链接标题。
- alunique
只显示明显的链接标题。不能与alprop=ids一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- alprop
要包含的信息束:
- ids
- 添加链接中的页面的页面ID(不能与alunique一起使用)。
- title
- 添加链接的标题。
- 值(以|分隔):ids、title
- 默认:title
- alnamespace
要列举的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- allimit
总共要返回多少个项目。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- aldir
列出方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 列出链接的标题,包括丢失的,带它们来自的页面ID,以B开头。
- api.php?action=query&list=alllinks&alfrom=B&alprop=ids|title
- 列出唯一的链接标题。
- api.php?action=query&list=alllinks&alunique=&alfrom=B
- 获取所有已链接的标题,标记缺少的。
- api.php?action=query&generator=alllinks&galunique=&galfrom=B
- 获取包含这些链接的页面。
- api.php?action=query&generator=alllinks&galfrom=B
list=allpages (ap)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
循序列举在指定名字空间中的所有页面。
- apfrom
枚举的起始页面标题。
- apcontinue
当更多结果可用时,使用这个继续。
- apto
枚举的结束页面标题。
- apprefix
搜索所有以此值开头的页面标题。
- apnamespace
要列举的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- apfilterredir
要列出哪些页面。
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- apminsize
限于至少这么多字节的页面。
- 类型:整数
- apmaxsize
限于至多这么多字节的页面。
- 类型:整数
- apprtype
仅限于受保护页面。
- 值(以|分隔):edit、move、upload
- apprlevel
Filter protections based on protection level (must be used with apprtype= parameter).
- 值(以|分隔):可以为空,或autoconfirmed、sysop
- apprfiltercascade
过滤基于cascadingness的保护(当apprtype未设置时忽略)。
- 以下值中的一个:cascading、noncascading、all
- 默认:all
- aplimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- apdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- apfilterlanglinks
过滤基于页面是否有语言链接。注意这可能不考虑由扩展添加的语言链接。
- 以下值中的一个:withlanglinks、withoutlanglinks、all
- 默认:all
- apprexpiry
要在页面上过滤的保护期限:
- indefinite
- 只获取带无限期保护的页面。
- definite
- 只获取带指定保护期限的页面。
- all
- 获取任意保护期限的页面。
- 以下值中的一个:indefinite、definite、all
- 默认:all
list=allredirects (ar)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出至一个名字空间的重定向。
- arcontinue
当更多结果可用时,使用这个继续。
- arfrom
要列举的起始重定向标题。
- arto
要列举的最终重定向标题。
- arprefix
搜索所有以此值开头的目标页面。
- arunique
只显示明显的目标页面。不能与arprop=ids|fragment|interwiki一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- arprop
要包含的信息束:
- ids
- 添加重定向页面的页面ID(不能与arunique一起使用)。
- title
- 添加重定向的标题。
- fragment
- 添加来自重定向的碎片,如果有(不能与arunique一起使用)。
- interwiki
- 添加来自重定向的跨wiki前缀,如果有(不能与arunique一起使用)。
- 值(以|分隔):ids、title、fragment、interwiki
- 默认:title
- arnamespace
要列举的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- arlimit
返回的总计项目数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ardir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- List target pages, including missing ones, with page IDs they are from, starting at B.
- api.php?action=query&list=allredirects&arfrom=B&arprop=ids|title
- 列出孤立目标页面。
- api.php?action=query&list=allredirects&arunique=&arfrom=B
- 获取所有目标页面,标记丢失的。
- api.php?action=query&generator=allredirects&garunique=&garfrom=B
- 获取包含重定向的页面。
- api.php?action=query&generator=allredirects&garfrom=B
list=alltransclusions (at)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- atcontinue
当更多结果可用时,使用这个继续。
- atfrom
要列举的起始嵌入标题。
- atto
要列举的最终嵌入标题。
- atprefix
搜索所有以此值开头的嵌入的标题。
- atunique
只显示明显的被嵌入标题。不能与atprop=ids一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- atprop
要包含的信息束:
- ids
- 添加嵌入中的页面的页面ID(不能与atunique一起使用)。
- title
- 添加嵌入的标题。
- 值(以|分隔):ids、title
- 默认:title
- atnamespace
要列举的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:10
- atlimit
要返回的总计项目。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- atdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 列出嵌入的标题,包括丢失的,带有来自的页面ID,从B开始。
- api.php?action=query&list=alltransclusions&atfrom=B&atprop=ids|title
- 列出孤立嵌入标题
- api.php?action=query&list=alltransclusions&atunique=&atfrom=B
- 获取所有嵌入的标题,并标记缺失的。
- api.php?action=query&generator=alltransclusions&gatunique=&gatfrom=B
- 获得包含嵌入内容的页面。
- api.php?action=query&generator=alltransclusions&gatfrom=B
list=allusers (au)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列举所有注册用户。
- aufrom
枚举的起始用户名。
- auto
枚举的结束用户名。
- auprefix
搜索所有以此值开头的用户。
- audir
排序方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- augroup
只包含指定组中的用户。
- 值(以|分隔):bot、sysop、bureaucrat
- auexcludegroup
排除指定组中的用户。
- 值(以|分隔):bot、sysop、bureaucrat
- aurights
仅列出有所选权限的用户。不包括隐性的或自动加入的用户组别(如*、用户或自动确认用户)所授予的权限。
- 值(以|分隔):apihighlimits、applychangetags、autoconfirmed、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjs、editmywatchlist、editsemiprotected、editusercssjs、editusercss、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、passwordreset、patrol、patrolmarks、protect、proxyunbannable、purge、read、reupload、reupload-own、reupload-shared、rollback、sendemail、siteadmin、suppressionlog、suppressredirect、suppressrevision、unblockself、undelete、unwatchedpages、upload、upload_by_url、userrights、userrights-interwiki、viewmyprivateinfo、viewmywatchlist、viewsuppressed、writeapi、skipcaptcha、interwiki
- 值的最高数字是50(对于机器人则是500)。
- auprop
要包含的信息束:
- blockinfo
- 添加有关用户当前封禁的信息。
- groups
- 列举用户所在的组。这使用更多服务器资源,并可能返回少于限制的结果。
- implicitgroups
- 列出用户自动属于的所有组。
- rights
- 用户拥有的权限列表。
- editcount
- 添加用户的编辑计数。
- registration
- 如果可能,添加用户注册时的时间戳(可能为空白)。
- 值(以|分隔):blockinfo、groups、implicitgroups、rights、editcount、registration
- aulimit
返回的总计用户数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- auwitheditsonly
只列出有编辑的用户。
- 类型:布尔值(详细信息)
- auactiveusers
只列出最近30天内活跃的用户。
- 类型:布尔值(详细信息)
list=backlinks (bl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有链接至指定页面的页面。
- bltitle
要搜索的标题。不能与blpageid一起使用。
- blpageid
要搜索的页面ID。不能与bltitle一起使用。
- 类型:整数
- blcontinue
当更多结果可用时,使用这个继续。
- blnamespace
要列举的名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- bldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- blfilterredir
如何过滤重定向。当blredirect被启用时如果设置为nonredirects,这只会应用到第二级。
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- bllimit
返回总计页面数。如果blredirect被启用,则限定分别适用于每一等级(这意味着将返回多达2 * bllimit个结果)。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- blredirect
如果链入页面是一个重定向,则寻找所有链接至此重定向的页面。最大限制减半。
- 类型:布尔值(详细信息)
- 显示至Main page的链接。
- api.php?action=query&list=backlinks&bltitle=Main%20Page
- 获取关于链接至Main page的页面的信息。
- api.php?action=query&generator=backlinks&gbltitle=Main%20Page&prop=info
list=blocks (bk)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出所有被封禁的用户和IP地址。
- bkstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- bkend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- bkdir
列举的方向:
- newer
- 最早的优先。注意:bkstart应早于bkend。
- older
- 最新的优先(默认)。注意:bkstart应晚于bkend。
- 以下值中的一个:newer、older
- 默认:older
- bkids
要列出的封禁ID列表(可选)。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- bkusers
要搜索的用户列表(可选)。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- bkip
Get all blocks applying to this IP or CIDR range, including range blocks. Cannot be used together with bkusers. CIDR ranges broader than IPv4/16 or IPv6/19 are not accepted.
- bklimit
封禁列表的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- bkprop
要获取的属性:
- id
- 添加封禁ID。
- user
- 添加被封禁用户的用户名。
- userid
- 添加被封禁用户的用户ID。
- by
- 添加执行封禁的用户的用户名。
- byid
- 添加执行封禁的用户的用户ID。
- timestamp
- 添加封禁生效时的时间戳。
- expiry
- 添加封禁截止时的时间戳。
- reason
- 添加封禁原因。
- range
- 添加受封禁影响的IP地址段。
- flags
- 标记编辑禁止(自动封禁、仅限匿名用户等)。
- 值(以|分隔):id、user、userid、by、byid、timestamp、expiry、reason、range、flags
- 默认:id|user|by|timestamp|expiry|reason|flags
- bkshow
Show only items that meet these criteria. For example, to see only indefinite blocks on IP addresses, set bkshow=ip|!temp.
- 值(以|分隔):account、!account、temp、!temp、ip、!ip、range、!range
- bkcontinue
当更多结果可用时,使用这个继续。
- 封禁列表。
- api.php?action=query&list=blocks
- 列出用户Alice和Bob的封禁。
- api.php?action=query&list=blocks&bkusers=Alice|Bob
list=categorymembers (cm)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
在指定的分类中列出所有页面。
- cmtitle
要列举的分类(必需)。必须包括分类:前缀。不能与cmpageid一起使用。
- cmpageid
要枚举的分类的页面 ID。不能与cmtitle一起使用。
- 类型:整数
- cmprop
要包含的信息束:
- ids
- 添加页面ID。
- title
- 添加页面标题和名字空间ID。
- sortkey
- Adds the sortkey used for sorting in the category (hexadecimal string).
- sortkeyprefix
- Adds the sortkey prefix used for sorting in the category (human-readable part of the sortkey).
- type
- Adds the type that the page has been categorised as (page, subcat or file).
- timestamp
- Adds the timestamp of when the page was included.
- 值(以|分隔):ids、title、sortkey、sortkeyprefix、type、timestamp
- 默认:ids|title
- cmnamespace
仅包含这些名字空间的页面。注意cmtype=subcat或cmtype=file可能被使用,而不是cmnamespace=14或6。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- cmtype
包含的分类成员类型。当cmsort=timestamp被设置时会忽略。
- 值(以|分隔):page、subcat、file
- 默认:page|subcat|file
- cmcontinue
当更多结果可用时,使用这个继续。
- cmlimit
返回页面的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- cmsort
要作为排序方式的属性。
- 以下值中的一个:sortkey、timestamp
- 默认:sortkey
- cmdir
排序的方向。
- 以下值中的一个:asc、desc、ascending、descending、newer、older
- 默认:ascending
- cmstart
开始列举的时间戳。只能与cmsort=timestamp一起使用。
- 类型:时间戳(允许格式)
- cmend
列举的结尾时间戳。只能与cmsort=timestamp一起使用。
- 类型:时间戳(允许格式)
- cmstarthexsortkey
开始列举的关键词,由cmprop=sortkey返回。不能与cmsort=sortkey一起使用。
- cmendhexsortkey
结束列举的关键词,由cmprop=sortkey返回。不能与cmsort=sortkey一起使用。
- cmstartsortkeyprefix
要开始列举的排序关键词前缀。只能与cmsort=sortkey一起使用。覆盖cmstarthexsortkey。
- cmendsortkeyprefix
Sortkey prefix to end listing before (not at; if this value occurs it will not be included!). Can only be used with cmsort=sortkey. Overrides cmendhexsortkey.
- cmstartsortkey
- 不推荐使用。
请改用cmstarthexsortkey。
- cmendsortkey
- 不推荐使用。
请改用cmendhexsortkey。
- 获取Category:Physics中的前10个页面。
- api.php?action=query&list=categorymembers&cmtitle=Category:Physics
- 获取有关Category:Physics中的前10个页面的页面信息。
- api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info
list=deletedrevs (dr)
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出被删除修订。
操作于三种模式中:
- 为指定标题列举已删除修订,按时间戳排列。
- 为指定用户列举已删除贡献,按时间戳排列(未指定标题)。
- 在指定名字空间中列举所有已删除修订,按标题和时间戳排列(无指定标题,未设置druser)。
任一参数只应用于一些模式,并忽略其他参数。
- drstart
枚举的起始时间戳。
- 模式:1、2
- 类型:时间戳(允许格式)
- drend
枚举的结束时间戳。
- 模式:1、2
- 类型:时间戳(允许格式)
- drdir
列举的方向:
- newer
- 最早的优先。注意:drstart应早于drend。
- older
- 最新的优先(默认)。注意:drstart应晚于drend。
- 模式:1、3
- 以下值中的一个:newer、older
- 默认:older
- drfrom
从此标题开始列出。
- 模式:3
- drto
列出至此标题为止。
- 模式:3
- drprefix
搜索所有以此值开头的页面标题。
- 模式:3
- drunique
每个页面只列出一个修订。
- 模式:3
- 类型:布尔值(详细信息)
- drnamespace
只列出此名字空间的页面。
- 模式:3
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- drtag
只列出被此标签标记的修订。
- druser
只列出此用户做出的修订。
- 类型:用户名
- drexcludeuser
不要列出此用户做出的修订。
- 类型:用户名
- drprop
要获取的属性:
- revid
- 添加被删除修订的修订ID。
- parentid
- 添加上一修订的修订ID至页面。
- user
- 添加做出修订的用户。
- userid
- 添加做出修订的用户ID。
- comment
- 添加修订摘要。
- parsedcomment
- 添加解析过的修订摘要。
- minor
- 如果修订是小编辑则加标签。
- len
- 添加修订长度(字节)。
- sha1
- 添加修订的SHA-1(base 16)。
- content
- 添加修订内容。
- token
- 已弃用。提供编辑令牌。
- tags
- 修订标签。
- 值(以|分隔):revid、parentid、user、userid、comment、parsedcomment、minor、len、sha1、content、token、tags
- 默认:user|comment
- drlimit
The maximum amount of revisions to list.
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- drcontinue
当更多结果可用时,使用这个继续。
- 列出最近已删除的对页面Main Page和Talk:Main Page的贡献,带内容(模式1)。
- api.php?action=query&list=deletedrevs&titles=Main%20Page|Talk:Main%20Page&drprop=user|comment|content
- 列出由Bob作出的最近50次已删除贡献(模式2)。
- api.php?action=query&list=deletedrevs&druser=Bob&drlimit=50
- 列出前50次主名字空间已删除贡献(模式3)。
- api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50
- 列出前50次讨论名字空间已删除页面(模式3)。
- api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique=
list=embeddedin (ei)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有嵌入指定标题的页面。
- eititle
要搜索的标题。不能与eipageid一起使用。
- eipageid
要搜索的页面ID。不能与eititle一起使用。
- 类型:整数
- eicontinue
当更多结果可用时,使用这个继续。
- einamespace
列举的名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- eidir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- eifilterredir
如何过滤重定向。
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- eilimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- 显示嵌入Template:Stub的页面。
- api.php?action=query&list=embeddedin&eititle=Template:Stub
- 获取有关显示嵌入Template:Stub的页面的信息。
- api.php?action=query&generator=embeddedin&geititle=Template:Stub&prop=info
list=exturlusage (eu)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列举包含一个指定URL的页面。
- euprop
要包含的信息束:
- ids
- 添加页面ID。
- title
- 添加页面的标题和名字空间ID。
- url
- 添加页面中使用的URL。
- 值(以|分隔):ids、title、url
- 默认:ids|title|url
- euoffset
当更多结果可用时,使用这个继续。
- 类型:整数
- euprotocol
URL协议。如果为空并且euquery被设置,协议为http。将此和euquery都留空以列举所有外部链接。
- 以下值中的一个:可以为空,或bitcoin、ftp、ftps、geo、git、gopher、http、https、irc、ircs、magnet、mailto、mms、news、nntp、redis、sftp、sip、sips、sms、ssh、svn、tel、telnet、urn、worldwind、xmpp
- 默认:(空)
- euquery
不包括协议的搜索字符串。参见Special:LinkSearch。留空以列出所有外部链接。
- eunamespace
要列举的页面名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- eulimit
返回多少页面。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- euexpandurl
用标准协议展开协议相关URL。
- 类型:布尔值(详细信息)
list=filearchive (fa)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
循序列举所有被删除的文件。
- fafrom
枚举的起始图片标题。
- fato
枚举的结束图片标题。
- faprefix
搜索所有以此值开头的图像标题。
- fadir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- fasha1
图片的SHA1哈希值。覆盖fasha1base36。
- fasha1base36
基于base 36的图片的SHA1哈希值(用于MediaWiki)。
- faprop
要获取的图片信息:
- sha1
- 为文件加入SHA-1哈希值。
- timestamp
- 为已上传版本添加时间戳。
- user
- 添加上传了图片版本的用户。
- size
- 添加图片大小(字节)及其高度、宽度和页面计数(如果可以)。
- dimensions
- 用于大小的别名。
- description
- 添加图片版本的说明。
- parseddescription
- 解析版本的描述。
- mime
- 添加图片的MIME。
- mediatype
- 添加图片的媒体类型。
- metadata
- 为图片版本列出Exif元数据。
- bitdepth
- 添加版本的字节深度。
- archivename
- 添加用于非最新版本的存档版本的文件名。
- 值(以|分隔):sha1、timestamp、user、size、dimensions、description、parseddescription、mime、mediatype、metadata、bitdepth、archivename
- 默认:timestamp
- falimit
返回图像的总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- facontinue
当更多结果可用时,使用这个继续。
- 显示已删除文件列表。
- api.php?action=query&list=filearchive
list=imageusage (iu)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有使用指定图片标题的页面。
- iutitle
要搜索的标题。不能与iupageid一起使用。
- iupageid
要搜索的页面ID。不能与iutitle一起使用。
- 类型:整数
- iucontinue
当更多结果可用时,使用这个继续。
- iunamespace
要列举的名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- iudir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- iufilterredir
How to filter for redirects. If set to nonredirects when iuredirect is enabled, this is only applied to the second level.
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- iulimit
How many total pages to return. If iuredirect is enabled, the limit applies to each level separately (which means up to 2 * iulimit results may be returned).
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- iuredirect
If linking page is a redirect, find all pages that link to that redirect as well. Maximum limit is halved.
- 类型:布尔值(详细信息)
list=iwbacklinks (iwbl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
查找所有链接至指定跨wiki链接的页面。
可被用于查找带某一前缀的所有链接,或所有至某一标题的链接(带指定前缀)。两参数都不使用就意味着“所有跨wiki链接”。
- iwblprefix
跨维基前缀。
- iwbltitle
要搜索的跨wiki链接。必须与iwblblprefix一起使用。
- iwblcontinue
当更多结果可用时,使用这个继续。
- iwbllimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- iwblprop
要获取的属性:
- iwprefix
- 加入跨wiki前缀。
- iwtitle
- 加入跨wiki标题。
- 值(以|分隔):iwprefix、iwtitle
- 默认:(空)
- iwbldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
list=langbacklinks (lbl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Find all pages that link to the given language link.
Can be used to find all links with a language code, or all links to a title (with a given language). Using neither parameter is effectively "all language links".
Note that this may not consider language links added by extensions.
- lbllang
用于语言链接的语言。
- lbltitle
要搜索的语言链接。必须与lbllang一起使用。
- lblcontinue
当更多结果可用时,使用这个继续。
- lbllimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- lblprop
要获得的属性:
- lllang
- 添加语言链接的语言代码。
- lltitle
- 添加语言链接的标题。
- 值(以|分隔):lllang、lltitle
- 默认:(空)
- lbldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
list=logevents (le)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从日志获取事件。
- leprop
要获取的属性:
- ids
- 添加日志活动的ID。
- title
- 为日志事件添加页面标题。
- type
- 添加日志活动的类型。
- user
- 为日志事件添加用户责任。
- userid
- 为日志事件添加对此负责的用户ID。
- timestamp
- 为日志活动添加时间戳。
- comment
- 添加日志活动的摘要。
- parsedcomment
- 添加被解析的日志活动的摘要。
- details
- 列举有关日志事件的额外详细信息。
- tags
- 列举用于日志活动的标签。
- 值(以|分隔):ids、title、type、user、userid、timestamp、comment、parsedcomment、details、tags
- 默认:ids|title|type|user|timestamp|comment|details
- letype
过滤日志记录至仅限此类型。
- 以下值中的一个:可以为空,或block、protect、rights、delete、upload、move、import、patrol、merge、suppress、tag、managetags、contentmodel、newusers、interwiki
- leaction
过滤日志操作为仅限此操作。覆盖letype。在可用值列表中,带星号通配符的值例如action/*可在斜线(/)后拥有不同字符串。
- 以下值中的一个:protect/modify、protect/protect、protect/unprotect、block/block、block/reblock、block/unblock、contentmodel/change、delete/delete、delete/event、delete/restore、delete/revision、import/interwiki、import/upload、managetags/activate、managetags/create、managetags/deactivate、managetags/delete、merge/merge、move/move、move/move_redir、patrol/patrol、protect/move_prot、rights/autopromote、rights/rights、suppress/block、suppress/delete、suppress/event、suppress/reblock、suppress/revision、tag/update、upload/overwrite、upload/revert、upload/upload、newusers/newusers、newusers/create、newusers/create2、newusers/byemail、newusers/autocreate、interwiki/*
- lestart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- leend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- ledir
列举的方向:
- newer
- 最早的优先。注意:lestart应早于leend。
- older
- 最新的优先(默认)。注意:lestart应晚于leend。
- 以下值中的一个:newer、older
- 默认:older
- leuser
过滤记录为这些由指定用户做出的。
- letitle
过滤记录至这些与页面相关的。
- lenamespace
过滤事件为在这些指定的名字空间中。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- leprefix
过滤以此前缀开头的记录。
- letag
只列举带此标签的事件日志记录。
- lelimit
返回的事件日志记录总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- lecontinue
当更多结果可用时,使用这个继续。
- 列出最近日志事件。
- api.php?action=query&list=logevents
list=pagepropnames (ppn)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出wiki中所有使用中的页面属性名称。
- ppncontinue
当更多结果可用时,使用这个继续。
- ppnlimit
返回名称的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- 获取前10个属性名称。
- api.php?action=query&list=pagepropnames
list=pageswithprop (pwp)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出所有使用指定页面属性的页面。
- pwppropname
要用于列举页面的页面属性。
- 这个参数是必须的。
- pwpprop
要包含的信息束:
- ids
- 添加页面ID。
- title
- 添加页面的标题和名字空间ID。
- value
- 添加页面属性值。
- 值(以|分隔):ids、title、value
- 默认:ids|title
- pwpcontinue
当更多结果可用时,使用这个继续。
- pwplimit
返回页面的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- pwpdir
排序的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 列出前10个使用
{{DISPLAYTITLE:}}
的页面。 - api.php?action=query&list=pageswithprop&pwppropname=displaytitle&pwpprop=ids|title|value
- 获取有关前10个使用
__NOTOC__
的页面的额外信息。 - api.php?action=query&generator=pageswithprop&gpwppropname=notoc&prop=info
list=prefixsearch (ps)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Perform a prefix search for page titles.
- pssearch
搜索字符串。
- 这个参数是必须的。
- psnamespace
搜索的名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- pslimit
要返回的结果最大数。
- 不允许超过100个(对于机器人则是200个)。
- 类型:整数或max
- 默认:10
- psoffset
跳过的结果数。
- 类型:整数
- 默认:0
- 搜索以meaning开头的页面标题。
- api.php?action=query&list=prefixsearch&pssearch=meaning
list=protectedtitles (pt)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出所有被限制创建的标题。
- ptnamespace
只列出这些名字空间的标题。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- ptlevel
只列出带这些保护级别的标题。
- 值(以|分隔):autoconfirmed、sysop
- ptlimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ptdir
列举的方向:
- newer
- 最早的优先。注意:ptstart应早于ptend。
- older
- 最新的优先(默认)。注意:ptstart应晚于ptend。
- 以下值中的一个:newer、older
- 默认:older
- ptstart
Start listing at this protection timestamp.
- 类型:时间戳(允许格式)
- ptend
Stop listing at this protection timestamp.
- 类型:时间戳(允许格式)
- ptprop
要获取的属性:
- timestamp
- 添加保护被添加时的时间戳。
- user
- 添加对页面添加保护的用户。
- userid
- 添加对页面添加保护的用户ID。
- comment
- 为保护添加摘要。
- parsedcomment
- 为保护添加解析的摘要。
- expiry
- 添加保护将被提升时的时间戳。
- level
- 添加保护级别。
- 值(以|分隔):timestamp、user、userid、comment、parsedcomment、expiry、level
- 默认:timestamp|level
- ptcontinue
当更多结果可用时,使用这个继续。
list=querypage (qp)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Get a list provided by a QueryPage-based special page.
- qppage
The name of the special page. Note, this is case sensitive.
- 这个参数是必须的。
- 以下值中的一个:Ancientpages、BrokenRedirects、Deadendpages、DoubleRedirects、ListDuplicatedFiles、Listredirects、Lonelypages、Longpages、MediaStatistics、Mostcategories、Mostimages、Mostinterwikis、Mostlinkedcategories、Mostlinkedtemplates、Mostlinked、Mostrevisions、Fewestrevisions、Shortpages、Uncategorizedcategories、Uncategorizedpages、Uncategorizedimages、Uncategorizedtemplates、Unusedcategories、Unusedimages、Wantedcategories、Wantedfiles、Wantedpages、Wantedtemplates、Unwatchedpages、Unusedtemplates、Withoutinterwiki
- qpoffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- qplimit
返回的结果数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
list=random (rn)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取一组随机页面。
页面列举在一个固定序列中,只有起始点是随机的。这意味着如果Main Page是列表中第一个随机页面的话,List of fictional monkeys将总是第二个,List of people on stamps of Vanuatu是第三个等。
- rnnamespace
只返回这些名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- rnfilterredir
如何过滤重定向。
- 以下值中的一个:all、redirects、nonredirects
- 默认:nonredirects
- rnredirect
- 不推荐使用。
请改用rnfilterredir=redirects。
- 类型:布尔值(详细信息)
- rnlimit
限制返回多少随机页面。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:1
- rncontinue
当更多结果可用时,使用这个继续。
- 从主名字空间返回两个随机页面。
- api.php?action=query&list=random&rnnamespace=0&rnlimit=2
- 返回有关来自主名字空间的两个随机页面的页面信息。
- api.php?action=query&generator=random&grnnamespace=0&grnlimit=2&prop=info
list=recentchanges (rc)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
枚举最近更改。
- rcstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- rcend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- rcdir
列举的方向:
- newer
- 最早的优先。注意:rcstart应早于rcend。
- older
- 最新的优先(默认)。注意:rcstart应晚于rcend。
- 以下值中的一个:newer、older
- 默认:older
- rcnamespace
过滤更改为仅限这些名字空间。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- rcuser
只列出此用户的更改。
- 类型:用户名
- rcexcludeuser
不要列出此用户的更改。
- 类型:用户名
- rctag
只列出带此标签的更改。
- rcprop
包含的额外信息束:
- user
- Adds the user responsible for the edit and tags if they are an IP.
- userid
- Adds the user ID responsible for the edit.
- comment
- Adds the comment for the edit.
- parsedcomment
- Adds the parsed comment for the edit.
- flags
- 为编辑添加标记。
- timestamp
- 添加编辑的时间戳。
- title
- 添加编辑的页面标题。
- ids
- 添加页面ID、最近更改ID和新旧修订的ID。
- sizes
- Adds the new and old page length in bytes.
- redirect
- Tags edit if page is a redirect.
- patrolled
- Tags patrollable edits as being patrolled or unpatrolled.
- loginfo
- Adds log information (log ID, log type, etc) to log entries.
- tags
- Lists tags for the entry.
- sha1
- Adds the content checksum for entries associated with a revision.
- 值(以|分隔):user、userid、comment、parsedcomment、flags、timestamp、title、ids、sizes、redirect、patrolled、loginfo、tags、sha1
- 默认:title|timestamp|ids
- rctoken
- 不推荐使用。
- 值(以|分隔):patrol
- rcshow
Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set rcshow=minor|!anon.
- 值(以|分隔):minor、!minor、bot、!bot、anon、!anon、redirect、!redirect、patrolled、!patrolled、unpatrolled
- rclimit
返回总计更新数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- rctype
显示的更改类型。
- 值(以|分隔):edit、external、new、log
- 默认:edit|new|log
- rctoponly
Only list changes which are the latest revision.
- 类型:布尔值(详细信息)
- rccontinue
当更多结果可用时,使用这个继续。
list=search (sr)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
执行一次全文本搜索。
- srsearch
搜索所有匹配此值的页面标题或内容。根据wiki的搜索后端工具,您可以使用搜索字符串以调用特殊搜索功能。
- 这个参数是必须的。
- srnamespace
只在这些名字空间搜索。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 默认:0
- srwhat
要执行的搜索类型。
- 以下值中的一个:title、text、nearmatch
- srinfo
要返回的元数据。
- 值(以|分隔):totalhits、suggestion、rewrittenquery
- 默认:totalhits|suggestion|rewrittenquery
- srprop
要返回的属性:
- size
- Adds the size of the page in bytes.
- wordcount
- Adds the word count of the page.
- timestamp
- Adds the timestamp of when the page was last edited.
- snippet
- Adds a parsed snippet of the page.
- titlesnippet
- Adds a parsed snippet of the page title.
- redirecttitle
- Adds the title of the matching redirect.
- redirectsnippet
- Adds a parsed snippet of the redirect title.
- sectiontitle
- Adds the title of the matching section.
- sectionsnippet
- Adds a parsed snippet of the matching section title.
- isfilematch
- Adds a boolean indicating if the search matched file content.
- categorysnippet
- Adds a parsed snippet of the matching category.
- score
- Deprecated and ignored.
- hasrelated
- Deprecated and ignored.
- 值(以|分隔):size、wordcount、timestamp、snippet、titlesnippet、redirecttitle、redirectsnippet、sectiontitle、sectionsnippet、isfilematch、categorysnippet、score、hasrelated
- 默认:size|wordcount|timestamp|snippet
- sroffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- srlimit
返回的总计页面数。
- 不允许超过50个(对于机器人则是500个)。
- 类型:整数或max
- 默认:10
- srinterwiki
搜索结果中包含跨wiki结果,如果可用。
- 类型:布尔值(详细信息)
- srenablerewrites
Enable internal query rewriting. Some search backends can rewrite the query into one its thinks gives better results, such as correcting spelling errors.
- 类型:布尔值(详细信息)
- 搜索meaning。
- api.php?action=query&list=search&srsearch=meaning
- 搜索文本meaning。
- api.php?action=query&list=search&srwhat=text&srsearch=meaning
- 获得有关搜索meaning返回页面的页面信息。
- api.php?action=query&generator=search&gsrsearch=meaning&prop=info
list=tags (tg)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
列出更改标签。
- tgcontinue
当更多结果可用时,使用这个继续。
- tglimit
列出标签的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- tgprop
要获取哪个属性:
- name
- 添加标签名称。
- displayname
- 为标签添加系统消息。
- description
- 为标签添加描述。
- hitcount
- 已添加此标签的修订版本与日志数量。
- defined
- 标识标签是否已定义。
- source
- 获得标签来源,它可能包括用于扩展定义的标签的extension,以及用于可被用户手动应用的标签的manual。
- active
- 标签是否仍可被应用。
- 值(以|分隔):name、displayname、description、hitcount、defined、source、active
- 默认:name
list=usercontribs (uc)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取一位用户的所有编辑。
- uclimit
返回贡献的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ucstart
返回的起始时间戳。
- 类型:时间戳(允许格式)
- ucend
返回的最终时间戳。
- 类型:时间戳(允许格式)
- uccontinue
当更多结果可用时,使用这个继续。
- ucuser
要检索贡献的用户。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- ucuserprefix
Retrieve contributions for all users whose names begin with this value. Overrides ucuser.
- ucdir
列举的方向:
- newer
- 最早的优先。注意:ucstart应早于ucend。
- older
- 最新的优先(默认)。注意:ucstart应晚于ucend。
- 以下值中的一个:newer、older
- 默认:older
- ucnamespace
只列出这些名字空间的贡献。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- ucprop
包含额外的信息束:
- ids
- 添加页面ID和修订ID。
- title
- 添加页面标题及其名字空间ID。
- timestamp
- 添加编辑的时间戳。
- comment
- 添加编辑摘要。
- parsedcomment
- 添加被解析的编辑摘要。
- size
- 添加编辑的新大小。
- sizediff
- 添加与父编辑相比该编辑的大小变化。
- flags
- 添加编辑标记。
- patrolled
- 标记已巡查编辑。
- tags
- 列举用于编辑的标签。
- 值(以|分隔):ids、title、timestamp、comment、parsedcomment、size、sizediff、flags、patrolled、tags
- 默认:ids|title|timestamp|comment|size|flags
- ucshow
只显示符合这些标准的项目,例如只显示不是小编辑的编辑:ucshow=!minor。
如果ucshow=patrolled或ucshow=!patrolled被设定,早于$wgRCMaxAge(7776000秒)的修订不会被显示。
- 值(以|分隔):minor、!minor、patrolled、!patrolled、top、!top、new、!new
- uctag
Only list revisions tagged with this tag.
- uctoponly
- 不推荐使用。
Only list changes which are the latest revision.
- 类型:布尔值(详细信息)
- 显示用户Example的贡献。
- api.php?action=query&list=usercontribs&ucuser=Example
- 显示来自192.0.2.前缀所有 IP 地址的贡献。
- api.php?action=query&list=usercontribs&ucuserprefix=192.0.2.
list=users (us)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取有关列出用户的信息。
- usprop
要包含的信息束:
- blockinfo
- 如果用户被封禁就标记,并注明是谁封禁,以何种原因封禁的。
- groups
- 列举每位用户属于的所有组。
- implicitgroups
- Lists all the groups a user is automatically a member of.
- rights
- Lists all the rights each user has.
- editcount
- Adds the user's edit count.
- registration
- Adds the user's registration timestamp.
- emailable
- Tags if the user can and wants to receive email through Special:Emailuser.
- gender
- Tags the gender of the user. Returns "male", "female", or "unknown".
- 值(以|分隔):blockinfo、groups、implicitgroups、rights、editcount、registration、emailable、gender
- ususers
A list of users to obtain information for.
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- ustoken
- 不推荐使用。
- 值(以|分隔):userrights
list=watchlist (wl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
在当前用户的监视列表中获取对页面的最近更改。
- wlallrev
Include multiple revisions of the same page within given timeframe.
- 类型:布尔值(详细信息)
- wlstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- wlend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- wlnamespace
Filter changes to only the given namespaces.
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- wluser
只列出此用户的更改。
- 类型:用户名
- wlexcludeuser
不要列出此用户的更改。
- 类型:用户名
- wldir
列举的方向:
- newer
- 最早的优先。注意:wlstart应早于wlend。
- older
- 最新的优先(默认)。注意:wlstart应晚于wlend。
- 以下值中的一个:newer、older
- 默认:older
- wllimit
根据结果返回的结果总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- wlprop
要获取的额外属性:
- ids
- 添加修订ID和页面ID。
- title
- 添加页面标题。
- flags
- 为编辑添加标记。
- user
- 添加做出编辑的用户。
- userid
- 添加做出编辑的用户的ID。
- comment
- 添加编辑摘要。
- parsedcomment
- 添加解析过的编辑摘要。
- timestamp
- 添加编辑时间戳。
- patrol
- 将编辑标记为已巡查。
- sizes
- 添加页面的旧有长度和新长度。
- notificationtimestamp
- 添加最近被通知有关编辑的用户的时间戳。
- loginfo
- 在适当位置添加日志信息。
- 值(以|分隔):ids、title、flags、user、userid、comment、parsedcomment、timestamp、patrol、sizes、notificationtimestamp、loginfo
- 默认:ids|title|flags
- wlshow
Show only items that meet these criteria. For example, to see only minor edits done by logged-in users, set wlshow=minor|!anon.
- 值(以|分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、unread、!unread
- wltype
要显示的更改类型:
- edit
- 定期页面编辑。
- external
- 外部更改。
- new
- 页面创建。
- log
- 日志记录。
- 值(以|分隔):edit、external、new、log
- 默认:edit|new|log
- wlowner
Used along with wltoken to access a different user's watchlist.
- 类型:用户名
- wltoken
允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。
- wlcontinue
当更多结果可用时,使用这个继续。
- 在当前用户的监视列表中列出用于最近更改页面的最新修订。
- api.php?action=query&list=watchlist
- 在当前用户的监视列表中检索有关用于最近更改页面的最新修订的额外信息。
- api.php?action=query&list=watchlist&wlprop=ids|title|timestamp|user|comment
- 在当前用户的监视列表中检索有关所有最近对页面的更改的信息。
- api.php?action=query&list=watchlist&wlallrev=&wlprop=ids|title|timestamp|user|comment
- 在当前用户的监视列表中检索用于最近更改页面的页面信息。
- api.php?action=query&generator=watchlist&prop=info
- 在当前用户的监视列表中检索用于对页面最近更改的修订信息。
- api.php?action=query&generator=watchlist&gwlallrev=&prop=revisions&rvprop=timestamp|user
- 在用户Example的监视列表中列出用于最近更改页面的最新修订。
- api.php?action=query&list=watchlist&wlowner=Example&wltoken=123ABC
list=watchlistraw (wr)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获得当前用户的监视列表上的所有页面。
- wrcontinue
当更多结果可用时,使用这个继续。
- wrnamespace
只列出指定名字空间的页面。
- 值(以|分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- wrlimit
根据结果返回的结果总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- wrprop
要获取的额外属性:
- changed
- 添加最近被通知有关编辑的用户的时间戳。
- 值(以|分隔):changed
- wrshow
Only list items that meet these criteria.
- 值(以|分隔):changed、!changed
- wrowner
Used along with wrtoken to access a different user's watchlist.
- 类型:用户名
- wrtoken
允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。
- wrdir
列举的方向:
- newer
- 最早的优先。注意:wrstart应早于wrend。
- older
- 最新的优先(默认)。注意:wrstart应晚于wrend。
- 以下值中的一个:ascending、descending
- 默认:ascending
- wrfromtitle
要列举的起始标题(带名字空间前缀)。
- wrtotitle
要列举的最终标题(带名字空间前缀)。
- 列出当前用户的监视列表中的页面。
- api.php?action=query&list=watchlistraw
- Fetch page info for pages on the current user's watchlist.
- api.php?action=query&generator=watchlistraw&gwrshow=changed&prop=info
meta=allmessages (am)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回来自该网站的消息。
- ammessages
要输出的消息。*(默认)表示所有消息。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- 默认:*
- amprop
要获取的属性。
- 值(以|分隔):default
- amenableparser
Set to enable parser, will preprocess the wikitext of message (substitute magic words, handle templates, etc.).
- 类型:布尔值(详细信息)
- amnocontent
If set, do not include the content of the messages in the output.
- 类型:布尔值(详细信息)
- amincludelocal
Also include local messages, i.e. messages that don't exist in the software but do exist as a MediaWiki: page. This lists all MediaWiki: pages, so it will also list those that aren't really messages such as Common.js.
- 类型:布尔值(详细信息)
- amargs
要替代进消息的参数。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- amfilter
只返回名称包含此字符串的消息。
- amcustomised
只返回在此定制情形下的消息。
- 以下值中的一个:all、modified、unmodified
- 默认:all
- amlang
返回这种语言的信息。
- amfrom
从此消息开始返回消息。
- amto
返回消息至此消息为止。
- amtitle
Page name to use as context when parsing message (for amenableparser option).
- amprefix
返回带有该前缀的消息。
- 显示以ipb-开始的消息。
- api.php?action=query&meta=allmessages&refix=ipb-
- 显示德语版的august和mainpage消息。
- api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de
meta=filerepoinfo (fri)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回有关wiki配置的图片存储库的元信息。
- friprop
Which repository properties to get (there may be more available on some wikis):
- apiurl
- URL to the repository API - helpful for getting image info from the host.
- name
- The key of the repository - used in e.g. $wgForeignFileRepos and imageinfo return values.
- displayname
- The human-readable name of the repository wiki.
- rooturl
- Root URL for image paths.
- local
- Whether that repository is the local one or not.
- 值(以|分隔):name、displayname、rootUrl、local、url、thumbUrl、initialCapital、descBaseUrl、fetchDescription、scriptDirUrl、scriptExtension、favicon、canUpload
- 默认:name|displayname|rootUrl|local|url|thumbUrl|initialCapital|descBaseUrl|fetchDescription|scriptDirUrl|scriptExtension|favicon|canUpload
meta=siteinfo (si)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
返回有关网站的一般信息。
- siprop
要获取的信息:
- general
- 全部系统信息。
- namespaces
- 注册的名字空间及其规范名称列表。
- namespacealiases
- 注册的名字空间别名列表。
- specialpagealiases
- 特殊页面别名列表。
- magicwords
- 魔术字及其别名列表。
- interwikimap
- 返回跨wiki映射(可选过滤,可选择使用siinlanguagecode本地化)。
- dbrepllag
- 返回数据库服务器与最高反应延迟。
- statistics
- 返回网站统计。
- usergroups
- 返回用户组及其相关权限。
- libraries
- 返回wiki上安装的库。
- extensions
- 返回wiki上安装的扩展。
- fileextensions
- 返回允许上传的文件扩展名列表。
- rightsinfo
- 如果可用,返回wiki的版权信息。
- restrictions
- 返回可用的编辑限制(保护)类型信息。
- languages
- 返回MediaWiki支持的语言列表(可选择使用siinlanguagecode本地化)。
- skins
- 返回所有启用的皮肤列表(可选择使用siinlanguagecode本地化,否则是内容语言)。
- extensiontags
- 返回解析器扩展标签列表。
- functionhooks
- 返回解析器函数钩列表。
- showhooks
- 返回所有订阅的钩列表($wgHooks的内容)。
- variables
- 返回变量ID列表。
- protocols
- 返回外部链接中允许的协议列表。
- defaultoptions
- 返回用户设置的默认值。
- 值(以|分隔):general、namespaces、namespacealiases、specialpagealiases、magicwords、interwikimap、dbrepllag、statistics、usergroups、libraries、extensions、fileextensions、rightsinfo、restrictions、languages、skins、extensiontags、functionhooks、showhooks、variables、protocols、defaultoptions
- 默认:general
- sifilteriw
只返回跨wiki地图中的本地或非本地记录。
- 以下值中的一个:local、!local
- sishowalldb
列出所有数据库服务器,不只是最落后的那个。
- 类型:布尔值(详细信息)
- sinumberingroup
列出用户组中的用户数。
- 类型:布尔值(详细信息)
- siinlanguagecode
用于本地化语言名称(尽可能)和皮肤名称的语言代码。
meta=tokens
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取可修改数据的操作的令牌。
- type
要请求的令牌类型。
- 值(以|分隔):csrf、patrol、rollback、userrights、watch
- 默认:csrf
- 检索一个csrf令牌(默认)。
- api.php?action=query&meta=tokens
- 检索一个监视令牌和一个巡查令牌。
- api.php?action=query&meta=tokens&type=watch|patrol
meta=userinfo (ui)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取有关当前用户的信息。
- uiprop
要包含的信息束:
- blockinfo
- 如果当前用户被封禁就标记,并注明是谁封禁,以何种原因封禁的。
- hasmsg
- 如果当前用户有等待中的消息的话,添加标签messages。
- groups
- Lists all the groups the current user belongs to.
- implicitgroups
- Lists all the groups the current user is automatically a member of.
- rights
- Lists all the rights the current user has.
- changeablegroups
- Lists the groups the current user can add to and remove from.
- options
- Lists all preferences the current user has set.
- preferencestoken
- Deprecated. Get a token to change current user's preferences.
- editcount
- Adds the current user's edit count.
- ratelimits
- Lists all rate limits applying to the current user.
- Adds the user's email address and email authentication date.
- realname
- 添加用户的真实姓名。
- acceptlang
- Echoes the
Accept-Language
header sent by the client in a structured format. - registrationdate
- 添加用户的注册时间。
- unreadcount
- Adds the count of unread pages on the user's watchlist (maximum 999; returns 1000+ if more).
- 值(以|分隔):blockinfo、hasmsg、groups、implicitgroups、rights、changeablegroups、options、preferencestoken、editcount、ratelimits、email、realname、acceptlang、registrationdate、unreadcount
action=revisiondelete
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
删除和恢复修订版本。
- type
Type of revision deletion being performed.
- 这个参数是必须的。
- 以下值中的一个:revision、archive、oldimage、filearchive、logging
- target
Page title for the revision deletion, if required for the type.
- ids
用于将被删除的修订的标识符。
- 这个参数是必须的。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- hide
每次修订要隐藏的东西。
- 值(以|分隔):content、comment、user
- show
每次修订要恢复显示的东西。
- 值(以|分隔):content、comment、user
- suppress
Whether to suppress data from administrators as well as others.
- 以下值中的一个:yes、no、nochange
- 默认:nochange
- reason
删除或恢复的原因。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=rollback
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
撤销对页面的最近编辑。
如果最近编辑页面的用户在一行中进行多次编辑,所有编辑将被回退。
- title
要回退的页面标题。不能与pageid一起使用。
- pageid
要回退的页面的页面 ID。不能与title一起使用。
- 类型:整数
- user
Name of the user whose edits are to be rolled back.
- 这个参数是必须的。
- summary
Custom edit summary. If empty, default summary will be used.
- 默认:(空)
- markbot
Mark the reverted edits and the revert as bot edits.
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- token
从action=query&meta=tokens取回的“rollback”令牌
出于兼容性考虑,web UI中使用的令牌也被接受。
- 这个参数是必须的。
- 回退由用户Example对Main Page做出的最近编辑。
- api.php?action=rollback&title=Main%20Page&user=Example&token=123ABC
- 回退由IP用户192.0.2.5对页面Main Page做出的最近编辑,带编辑摘要Reverting vandalism,并将这些编辑和回退标记为机器人编辑。
- api.php?action=rollback&title=Main%20Page&user=192.0.2.5&token=123ABC&summary=Reverting%20vandalism&markbot=1
action=rsd
- 来源:MediaWiki
- 许可协议:GPL-2.0+
导出一个RSD(Really Simple Discovery)架构。
- 导出RSD架构。
- api.php?action=rsd
action=setnotificationtimestamp
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
更新用于监视页面的通知时间戳。
这会影响监视列表和历史中已更改页面的高亮度,并且如果“当我的监视列表中的页面或文件更改时发送电子邮件通知我”设置被启用的话,也会影响电子邮件的发送。
- entirewatchlist
工作于所有已监视页面。
- 类型:布尔值(详细信息)
- timestamp
要设置通知时间戳的时间戳。
- 类型:时间戳(允许格式)
- torevid
要设置通知时间戳的修订(只限一个页面)。
- 类型:整数
- newerthanrevid
要设置通知时间戳的较新修订(只限一个页面)。
- 类型:整数
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括gan、iu、kk、ku、shi、sr、tg、uz、zh。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 重置整个监视列表的通知状态。
- api.php?action=setnotificationtimestamp&entirewatchlist=&token=123ABC
- 重置用于Main page的通知状态。
- api.php?action=setnotificationtimestamp&titles=Main_page&token=123ABC
- 设置Main page的通知时间戳,这样所有从2012年1月1日起的编辑都会是未复核的。
- api.php?action=setnotificationtimestamp&titles=Main_page×tamp=2012-01-01T00:00:00Z&token=123ABC
- 重置在用户名字空间中的页面的通知状态。
- api.php?action=setnotificationtimestamp&generator=allpages&gapnamespace=2&token=123ABC
action=stashedit
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
Prepare an edit in shared cache.
This is intended to be used via AJAX from the edit form to improve the performance of the page save.
- title
Title of the page being edited.
- 这个参数是必须的。
- section
Section number. 0 for the top section, new for a new section.
- sectiontitle
The title for a new section.
- text
Page content.
- 这个参数是必须的。
- contentmodel
Content model of the new content.
- 这个参数是必须的。
- 以下值中的一个:wikitext、javascript、json、css、text
- contentformat
Content serialization format used for the input text.
- 这个参数是必须的。
- 以下值中的一个:text/x-wiki、text/javascript、application/json、text/css、text/plain
- baserevid
Revision ID of the base revision.
- 这个参数是必须的。
- 类型:整数
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=tag
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从个别修订或日志记录中添加或移除更改标签。
- rcid
要添加或移除标签的一个或更多的最近更改ID。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revid
要添加或移除标签的一个或更多的修订ID。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- logid
要添加或移除标签的一个或更多的日志记录ID。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- add
要添加的标签。只有手动定义的标签可以添加。
- 值(以|分隔):
- remove
要移除的标签。只有手动定义或完全不明确的标签可以被移除。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- reason
更改原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 将vandalism标签添加至修订ID 123,而不指定原因
- api.php?action=tag&revid=123&add=vandalism&token=123ABC
- 从日志记录ID 123移除spam标签,原因为Wrongly applied
- api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC
action=tokens
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
获取可修改数据的操作的令牌。
此模块被弃用以有利于action=query&meta=tokens。
- type
要请求的令牌类型。
- 值(以|分隔):block、delete、edit、email、import、move、options、patrol、protect、unblock、watch
- 默认:edit
- 检索一个编辑令牌(默认)。
- api.php?action=tokens
- 检索一个电子邮件令牌和一个移动令牌。
- api.php?action=tokens&type=email|move
action=unblock
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
解封一位用户。
- id
解封时需要的封禁ID(通过list=blocks获得)。不能与user一起使用。
- 类型:整数
- user
要解封的用户名、IP地址或IP段。不能与id一起使用。
- reason
解封的原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 解封封禁ID #105。
- api.php?action=unblock&id=105
- 解封用户Bob,原因Sorry Bob。
- api.php?action=unblock&user=Bob&reason=Sorry%20Bob
action=undelete
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
恢复一个被删除页面的修订。
被删除修订的列表(包括时间戳)可通过list=deletedrevs检索到,并且被删除的文件ID列表可通过list=filearchive检索到。
- title
要恢复的页面标题。
- 这个参数是必须的。
- reason
恢复的原因。
- 默认:(空)
- timestamps
要回复的修订的时间戳。如果timestamps和fileids都为空,所有将被恢复。
- 类型:时间戳列表(允许格式)
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- fileids
要恢复的文件修订ID。如果timestamps和fileids都为空,所有将被恢复。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- watchlist
Unconditionally add or remove the page from the current user's watchlist, use preferences or do not change watch.
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=upload
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
上传一个文件,或获取正在等待中的上传的状态。
可以使用的几种方法:
- 直接上传文件内容,使用file参数。
- 成批上传文件,使用filesize、chunk和offset参数。
- 有MediaWiki服务器从URL检索一个文件,使用url参数。
- Complete an earlier upload that failed due to warnings, using the filekey parameter.
Note that the HTTP POST must be done as a file upload (i.e. using multipart/form-data
) when sending the file.
- filename
目标文件名。
- comment
上传注释。如果没有指定text,那么它也被用于新文件的初始页面文本。
- 默认:(空)
- text
Initial page text for new files.
- watch
- 不推荐使用。
监视页面。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、preferences、nochange
- 默认:preferences
- ignorewarnings
忽略任何警告。
- 类型:布尔值(详细信息)
- file
文件内容。
- 必须被公布为使用multipart/form-data的一次文件上传。
- url
要检索文件来源的URL。
- filekey
Key that identifies a previous upload that was stashed temporarily.
- sessionkey
- 不推荐使用。
Same as filekey, maintained for backward compatibility.
- stash
如果设置,服务器将临时藏匿文件而不是加入存储库。
- 类型:布尔值(详细信息)
- filesize
全部上传的文件大小。
- 值必须介于0和104,857,600之间。
- 类型:整数
- offset
块的偏移量(字节)。
- 值必须不少于0。
- 类型:整数
- chunk
大块内容。
- 必须被公布为使用multipart/form-data的一次文件上传。
- async
Make potentially large file operations asynchronous when possible.
- 类型:布尔值(详细信息)
- asyncdownload
Make fetching a URL asynchronous.
- 类型:布尔值(详细信息)
- leavemessage
如果asyncdownload被使用,当完成时,在用户讨论页留下一条消息。
- 类型:布尔值(详细信息)
- statuskey
Fetch the upload status for this file key (upload by URL).
- checkstatus
Only fetch the upload status for the given file key.
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=userrights
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
更改一位用户的组成员。
- user
用户名。
- userid
用户ID。
- 类型:整数
- add
将用户加入至这些组中。
- 值(以|分隔):bot、sysop、bureaucrat
- remove
将用户从这些组中移除。
- 值(以|分隔):bot、sysop、bureaucrat
- reason
更改原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“userrights”令牌
出于兼容性考虑,web UI中使用的令牌也被接受。
- 这个参数是必须的。
- 将用户FooBot添加至bot用户组,并从sysop和bureaucrat组移除。
- api.php?action=userrights&user=FooBot&add=bot&remove=sysop|bureaucrat&token=123ABC
- 将ID为123的用户加入至机器人组,并将其从管理员和行政员组移除。
- api.php?action=userrights&userid=123&add=bot&remove=sysop|bureaucrat&token=123ABC
action=watch
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
从当前用户的监视列表中添加或移除页面。
- title
- 不推荐使用。
要(取消)监视的页面。也可使用titles。
- unwatch
如果设置页面将被取消监视而不是被监视。
- 类型:布尔值(详细信息)
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过“|”隔开各值。 值的最高数字是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括gan、iu、kk、ku、shi、sr、tg、uz、zh。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“watch”令牌
- 这个参数是必须的。
- 监视页面Main Page。
- api.php?action=watch&titles=Main_Page&token=123ABC
- 取消监视页面Main Page。
- api.php?action=watch&titles=Main_Page&unwatch=&token=123ABC
- 监视主名字空间中的最少几个页面。
- api.php?action=watch&generator=allpages&gapnamespace=0&token=123ABC
format=dbg
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为PHP的var_export()
格式。
format=dbgfm
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为PHP的var_export()
格式(HTML优质打印效果)。
format=json
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为JSON格式。
- callback
如果指定,将输出内容包裹在一个指定的函数调用中。出于安全考虑,所有用户相关的数据将被限制。
- utf8
如果指定,使用十六进制转义序列将大多数(但不是全部)非ASCII的字符编码为UTF-8,而不是替换它们。默认当formatversion不是1时。
- 类型:布尔值(详细信息)
- ascii
如果指定,使用十六进制转义序列将所有非ASCII编码。默认当formatversion为1时。
- 类型:布尔值(详细信息)
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=jsonfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为JSON格式(HTML优质打印效果)。
- callback
如果指定,将输出内容包裹在一个指定的函数调用中。出于安全考虑,所有用户相关的数据将被限制。
- utf8
如果指定,使用十六进制转义序列将大多数(但不是全部)非ASCII的字符编码为UTF-8,而不是替换它们。默认当formatversion不是1时。
- 类型:布尔值(详细信息)
- ascii
如果指定,使用十六进制转义序列将所有非ASCII编码。默认当formatversion为1时。
- 类型:布尔值(详细信息)
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=none
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
不输出任何东西。
format=php
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为序列化PHP格式。
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=phpfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为序列化PHP格式(HTML优质打印效果)。
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=rawfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为JSON格式,带调试元素(HTML优质打印效果)。
format=txt
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为PHP的print_r()
格式。
format=txtfm
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为PHP的print_r()
格式(HTML优质打印效果)。
format=xml
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为XML格式。
- xslt
如果指定,加入已命名的页面作为一个XSL样式表。值必须是在MediaWiki名字空间以
.xsl
为结尾的标题。- includexmlnamespace
如果指定,添加一个XML名字空间。
- 类型:布尔值(详细信息)
format=xmlfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为XML格式(HTML优质打印效果)。
- xslt
如果指定,加入已命名的页面作为一个XSL样式表。值必须是在MediaWiki名字空间以
.xsl
为结尾的标题。- includexmlnamespace
如果指定,添加一个XML名字空间。
- 类型:布尔值(详细信息)
format=yaml
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为YAML格式。
- callback
如果指定,将输出内容包裹在一个指定的函数调用中。出于安全考虑,所有用户相关的数据将被限制。
- utf8
如果指定,使用十六进制转义序列将大多数(但不是全部)非ASCII的字符编码为UTF-8,而不是替换它们。默认当formatversion不是1时。
- 类型:布尔值(详细信息)
- ascii
如果指定,使用十六进制转义序列将所有非ASCII编码。默认当formatversion为1时。
- 类型:布尔值(详细信息)
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=yamlfm
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
输出数据为YAML格式(HTML优质打印效果)。
- callback
如果指定,将输出内容包裹在一个指定的函数调用中。出于安全考虑,所有用户相关的数据将被限制。
- utf8
如果指定,使用十六进制转义序列将大多数(但不是全部)非ASCII的字符编码为UTF-8,而不是替换它们。默认当formatversion不是1时。
- 类型:布尔值(详细信息)
- ascii
如果指定,使用十六进制转义序列将所有非ASCII编码。默认当formatversion为1时。
- 类型:布尔值(详细信息)
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可以更改!
- latest
- 使用最新格式(当前为2),可以在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
数据类型
一些在API请求中的参数类型需要更进一步解释:
- boolean
- 布尔参数就像HTML复选框一样工作:如果指定参数,无论何值都被认为是真。如果要假值,则可完全忽略参数。
- timestamp
- 时间戳可被指定为很多格式。推荐使用ISO 8601日期和时间标准。所有时间为UTC时间,包含的任何时区会被忽略。
- ISO 8601日期和时间,2001-01-15T14:56:00Z(标点和Z是可选项)
- 带小数秒(会被忽略)的ISO 8601日期和时间,2001-01-15T14:56:00.00001Z(破折号、括号和Z是可选的)
- MediaWiki格式,20010115145600
- 一般数字格式,2001-01-15 14:56:00(GMT、+##或-##的可选时区会被忽略)
- EXIF格式,2001:01:15 14:56:00
- RFC 2822格式(时区可能会被省略),Mon, 15 Jan 2001 14:56:00
- RFC 850格式(时区可能会被省略),Monday, 15-Jan-2001 14:56:00
- C ctime格式,Mon Jan 15 14:56:00 2001
- 秒数是从1970-01-01T00:00:00Z开始,作为1到13位数的整数(除了0)
- 字符串now
制作人员
API 开发人员:
- Roan Kattouw(2007年9月~2009年的开发组领导)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Yuri Astrakhan(创建者,2006年9月~2007年9月的开发组领导)
- Brad Jorsch(2013年至今的开发组领导)
请将您的评论、建议和问题发送至mediawiki-api@lists.wikimedia.org,或提交错误请求在https://phabricator.wikimedia.org/。