MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:-{R|https://www.mediawiki.org/wiki/API:Main_page/zh}-
主模块
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
状态信息:MediaWiki API是一个成熟稳定的,不断受到支持和改进的界面。尽管我们尽力避免,但偶尔也需要作出重大更新;请订阅mediawiki-api-announce 邮件列表以便获得更新通知。
错误请求:当API收到错误请求时,HTTP header将会返回一个包含"MediaWiki-API-Error"的值,随后header的值与error code将会送回并设置为相同的值。详细信息请参阅API:错误与警告。
测试中:测试API请求的易用性,请参见Special:ApiSandbox。
- action
要执行的操作。
- aggregategroups
- 管理聚合消息组。
- block
- 封禁一位用户。
- categorytree
- 用于CategoryTree扩展的内部模块。
- changeauthenticationdata
- 更改当前用户的身份验证数据。
- checktoken
- 从action=query&meta=tokens检查令牌有效性。
- cirrus-config-dump
- CirrusSearch配置的转储。
- cirrus-mapping-dump
- 用于此wiki的CirrusSearch映射转储。
- cirrus-profiles-dump
- Dump of CirrusSearch profiles for this wiki.
- cirrus-settings-dump
- 用于此wiki的CirrusSearch设置转储。
- clearhasmsg
- 清除当前用户的
hasmsg
标记。 - clientlogin
- 使用交互式流登录wiki。
- compare
- 获取两页面之间的差异。
- createaccount
- 创建一个新用户账户。
- cspreport
- 由浏览器使用以报告违反内容安全方针的内容。此模块应永不使用,除了在被CSP兼容的浏览器自动使用时。
- delete
- 删除一个页面。
- echomarkread
- 对当前用户标记通知为已读。
- echomarkseen
- 对当前用户标记通知为已读。
- edit
- 创建和编辑页面。
- emailuser
- 电子邮件联系一位用户。
- expandtemplates
- 展开wiki文本中的所有模板。
- feedcontributions
- 返回用户贡献纲要。
- feedrecentchanges
- 返回最近更改的摘要。
- feedwatchlist
- 返回监视列表纲要。
- filerevert
- 回退一个文件至某一旧版本。
- flow
- 允许对Flow页面的操作。
- flow-parsoid-utils
- 在wiki文本和HTML之间互相转换文本。
- groupreview
- 设置信息组工作流状态。
- help
- 显示指定模块的帮助。
- imagerotate
- 旋转一幅或多幅图像。
- import
- 从其他wiki,或从XML文件导入页面。
- languagesearch
- 使用任何字母搜索语言名称。
- linkaccount
- 将来自第三方提供商的账户链接至当前用户。
- login
- 登录并获取身份验证cookie。
- logout
- 退出并清除会话数据。
- managetags
- 执行有关更改标签的管理任务。
- mergehistory
- 合并页面历史。
- mobileview
- 返回移动浏览需要的数据。
- move
- 移动一个页面。
- oathvalidate
- 验证一个双因素验证(OATH)令牌。
- opensearch
- 使用开放搜索协议搜索wiki。
- options
- 更改当前用户的参数设置。
- paraminfo
- 获得关于API模块的信息。
- parse
- 解析内容并返回解析器输出。
- patrol
- 巡查页面或修订版本。
- protect
- 更改页面的保护等级。
- purge
- 为指定标题刷新缓存。
- query
- 取得来自并有关MediaWiki的数据。
- removeauthenticationdata
- 从当前用户移除身份验证数据。
- resetpassword
- 向用户发送密码重置邮件。
- revisiondelete
- 删除和恢复修订版本。
- rollback
- 撤销对页面的最近编辑。
- rsd
- 导出一个RSD(Really Simple Discovery)架构。
- scribunto-console
- 从Scribunto控制台提供XHR请求的内部模块。
- searchtranslations
- 搜索译文。
- setnotificationtimestamp
- 更新监视页面的通知时间戳。
- setpagelanguage
- 更改页面的语言。
- shortenurl
- 将一个长URL缩短。
- spamblacklist
- 验证一个或多个URL是否触发垃圾链接黑名单。
- stashedit
- 在分享缓存中准备编辑。
- tag
- 从个别修订或日志记录中添加或移除更改标签。
- templatedata
- 获取由TemplateData扩展存储的数据。
- titleblacklist
- 验证一个页面的标题、文件名或用户名是否触发标题黑名单。
- translationaids
- 查询所有翻译帮助。
- translationcheck
- 验证翻译。
- translationreview
- 标记该翻译为已复核。
- ttmserver
- 从翻译记忆库查询建议。
- ulslocalization
- 获取指定语言的ULS本地化。
- unblock
- 解封一位用户。
- undelete
- 恢复删除页面的修订版本。
- unlinkaccount
- 从当前用户移除已连接的第三方账户。
- upload
- 上传文件,或获取正在等待中的上传的状态。
- userrights
- 更改一位用户的组成员。
- validatepassword
- 验证密码是否符合wiki的密码方针。
- visualeditor
- 从Parsoid服务返回页面的HTML5。
- visualeditoredit
- 保存一个HTML5页面至MediaWiki(通过Parsoid服务转换为wiki文本)。
- watch
- 从当前用户的监视列表中添加或移除页面。
- webapp-manifest
- 返回webapp证明。
- tokens
- 已弃用。 获取数据修改操作的令牌。
- 以下值中的一个:aggregategroups、block、categorytree、changeauthenticationdata、checktoken、cirrus-config-dump、cirrus-mapping-dump、cirrus-profiles-dump、cirrus-settings-dump、clearhasmsg、clientlogin、compare、createaccount、cspreport、delete、echomarkread、echomarkseen、edit、emailuser、expandtemplates、feedcontributions、feedrecentchanges、feedwatchlist、filerevert、flow、flow-parsoid-utils、groupreview、help、imagerotate、import、languagesearch、linkaccount、login、logout、managetags、mergehistory、mobileview、move、oathvalidate、opensearch、options、paraminfo、parse、patrol、protect、purge、query、removeauthenticationdata、resetpassword、revisiondelete、rollback、rsd、scribunto-console、searchtranslations、setnotificationtimestamp、setpagelanguage、shortenurl、spamblacklist、stashedit、tag、templatedata、titleblacklist、translationaids、translationcheck、translationreview、ttmserver、ulslocalization、unblock、undelete、unlinkaccount、upload、userrights、validatepassword、visualeditor、visualeditoredit、watch、webapp-manifest、tokens
- 默认:help
- format
输出的格式。
- 以下值中的一个:json、jsonfm、none、php、phpfm、rawfm、xml、xmlfm
- 默认:jsonfm
- maxlag
最大延迟可被用于MediaWiki安装于数据库复制集中。要保存导致更多网站复制延迟的操作,此参数可使客户端等待直到复制延迟少于指定值时。万一发生过多延迟,错误代码maxlag会返回消息,例如等待$host中:延迟$lag秒。
参见手册:Maxlag参数以获取更多信息。- 类型:整数
- smaxage
设置
s-maxage
HTTP缓存控制头至这些秒。错误不会缓存。- 类型:整数
- 默认:0
- maxage
设置
max-age
HTTP缓存控制头至这些秒。错误不会缓存。- 类型:整数
- 默认:0
- assert
如果设置为user就验证用户是否登录,或如果设置为bot就验证是否有机器人用户权限。
- 以下值中的一个:user、bot
- assertuser
验证当前用户是命名用户。
- 类型:用户名
- requestid
任何在此提供的值将包含在响应中。可以用以区别请求。
- servedby
包含保存结果请求的主机名。
- 类型:布尔值(详细信息)
- curtimestamp
在结果中包括当前时间戳。
- 类型:布尔值(详细信息)
- responselanginfo
包含在结果中用于uselang和errorlang的语言。
- 类型:布尔值(详细信息)
- origin
当通过跨域名AJAX请求(CORS)访问API时,设置此作为起始域名。这必须包括在任何pre-flight请求中,并因此必须是请求的URI的一部分(而不是POST正文)。
对于已验证的请求,这必须正确匹配
Origin
标头中的原点之一,因此它已经设置为像-{R|https://en.wikipedia.org}-或-{R|https://meta.wikimedia.org}-的东西。如果此参数不匹配Origin
页顶,就返回403错误响应。如果此参数匹配Origin
页顶并且起点被白名单,将设置Access-Control-Allow-Origin
和Access-Control-Allow-Credentials
开头。对于未验证的请求,会指定值*。这将导致
Access-Control-Allow-Origin
标头被设置,但Access-Control-Allow-Credentials
将为false
,且所有用户特定数据将受限制。- uselang
用于消息翻译的语言。action=query&meta=siteinfo与siprop=languages可返回语言代码列表,或指定user以使用当前用户的语言设置,或指定content以使用此wiki的内容语言。
- 默认:user
- errorformat
用于警告和错误文本输出的格式。
- plaintext
- 已移除HTML标签,并被替换实体的Wiki文本。
- wikitext
- 未解析的wiki文本。
- html
- HTML。
- raw
- 消息关键词和参数。
- none
- 无文本输出,仅包含错误代码。
- bc
- 在MediaWiki 1.29以前版本使用的格式。errorlang和errorsuselocal会被忽略。
- 以下值中的一个:plaintext、wikitext、html、raw、none、bc
- 默认:bc
- errorlang
用于警告和错误的语言。action=query&meta=siteinfo带siprop=languages返回语言代码的列表,或指定content以使用此wiki的内容语言,或指定uselang以使用与uselang参数相同的值。
- 默认:uselang
- errorsuselocal
如果指定,错误文本将使用来自MediaWiki名字空间的本地自定义消息。
- 类型:布尔值(详细信息)
- 主模块帮助。
- api.php?action=help [在沙盒中打开]
- 一个页面中的所有帮助。
- api.php?action=help&recursivesubmodules=1 [在沙盒中打开]
action=aggregategroups
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
管理聚合消息组。
您可以添加和移除聚合消息组,以及从组中关联或分离消息(一次一个)。
- do
想要操作哪个聚合消息组。
- 这个参数是必须的。
- 以下值中的一个:associate、dissociate、remove、add、update
- aggregategroup
聚合消息组ID。
- group
消息组ID。
- groupname
聚合消息组的名称。
- groupdescription
聚合消息组的描述。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=block
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
封禁一位用户。
- user
要封禁的用户、IP地址或IP地址段。不能与userid一起使用
- 类型:用户名
- userid
要封禁的用户ID。不能与user一起使用。
- 类型:整数
- 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 的用户页和讨论页。
- 类型:布尔值(详细信息)
- tags
要在封禁日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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=categorytree
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:CategoryTree
- 许可协议:GPL-2.0-or-later
用于CategoryTree扩展的内部模块。
- category
分类名字空间中的标题,如果提供前缀将会被忽略。
- 这个参数是必须的。
- options
用于CategoryTree构造器的选项,作为一个JSON对象。depth选项默认为1。
action=changeauthenticationdata (changeauth)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
更改当前用户的身份验证数据。
- changeauthrequest
使用此身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=change。
- 这个参数是必须的。
- changeauthtoken
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- *
- 此模块允许额外参数,取决于可用的身份验证请求。使用action=query&meta=authmanagerinfo与amirequestsfor=change(或之前来自此模块的相应,如果可以)以决定可用请求及其使用的字段。
action=checktoken
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从action=query&meta=tokens检查令牌有效性。
- type
已开始测试的令牌类型。
- 这个参数是必须的。
- 以下值中的一个:createaccount、csrf、login、patrol、rollback、userrights、watch
- token
要测试的令牌。
- 这个参数是必须的。
- maxtokenage
令牌的最大允许年龄,以秒计。
- 类型:整数
- 测试csrf令牌的有效性。
- api.php?action=checktoken&type=csrf&token=123ABC [在沙盒中打开]
action=cirrus-config-dump
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
CirrusSearch配置的转储。
- 获取CirrusSearch配置的转储。
- api.php?action=cirrus-config-dump [在沙盒中打开]
action=cirrus-mapping-dump
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
用于此wiki的CirrusSearch映射转储。
- 获取用于此wiki的CirrusSearch映射转储。
- api.php?action=cirrus-mapping-dump [在沙盒中打开]
action=cirrus-profiles-dump
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
Dump of CirrusSearch profiles for this wiki.
- verbose
Dump the profiles content
- 类型:布尔值(详细信息)
- Get a dump of CirrusSearch profiles for this wiki.
- api.php?action=cirrus-profiles-dump [在沙盒中打开]
action=cirrus-settings-dump
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
用于此wiki的CirrusSearch设置转储。
- 获取用于此wiki的CirrusSearch设置转储。
- api.php?action=cirrus-settings-dump [在沙盒中打开]
action=clearhasmsg
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
清除当前用户的hasmsg
标记。
- 清除当前用户的
hasmsg
标记。 - api.php?action=clearhasmsg [在沙盒中打开]
action=clientlogin (login)
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
使用交互式流登录wiki。
使用此模块的一般程序是:
- 通过amirequestsfor=login取得来自action=query&meta=authmanagerinfo的可用字段,和来自action=query&meta=tokens的login令牌。
- 向用户显示字段,并获得其提交的内容。
- 发送(POST)至此模块,提供loginreturnurl及任何相关字段。
- 在响应中检查status。
- 如果您收到了PASS(成功)或FAIL(失败),则认为操作结束。成功与否如上句所示。
- 如果您收到了UI,向用户显示新字段,并再次获取其提交的内容。然后再次使用logincontinue,向本模块提交相关字段,并重复第四步。
- 如果您收到了REDIRECT,将用户指向redirecttarget中的目标,等待其返回loginreturnurl。然后再次使用logincontinue,向本模块提交返回URL中提供的一切字段,并重复第四步。
- 如果您收到了RESTART,这意味着身份验证正常运作,但我们没有链接的用户账户。您可以将此看做UI或FAIL。
- loginrequests
只使用这些身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=login,或来自此模块之前的响应。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- loginmessageformat
用于返回消息的格式。
- 以下值中的一个:html、wikitext、raw、none
- 默认:wikitext
- loginmergerequestfields
合并用于所有身份验证请求的字段信息至一个数组中。
- 类型:布尔值(详细信息)
- loginpreservestate
从之前失败的登录尝试中保持状态,如果可能。
- 类型:布尔值(详细信息)
- loginreturnurl
为第三方身份验证流返回URL,必须为绝对值。需要此值或logincontinue两者之一。
在接收REDIRECT响应时,您将代表性的打开浏览器或web视图到特定用于第三方身份验证流的redirecttarget URL。当它完成时,第三方将发生浏览器或web视图至此URL。您应当提取任何来自URL的查询或POST参数,并作为logincontinue请求传递至此API模块。
- logincontinue
此请求是在早先的UI或REDIRECT响应之后的附加请求。必需此值或loginreturnurl。
- 类型:布尔值(详细信息)
- logintoken
从action=query&meta=tokens取回的“login”令牌
- 这个参数是必须的。
- *
- 此模块允许额外参数,取决于可用的身份验证请求。使用action=query&meta=authmanagerinfo与amirequestsfor=login(或之前来自此模块的相应,如果可以)以决定可用请求及其使用的字段。
- 开始作为用户Example和密码ExamplePassword登录至wiki的过程。
- api.php?action=clientlogin&username=Example&password=ExamplePassword&loginreturnurl=http://example.org/&logintoken=123ABC [在沙盒中打开]
- 在UI响应双因素验证后继续登录,补充OATHToken 987654。
- api.php?action=clientlogin&logincontinue=1&OATHToken=987654&logintoken=123ABC [在沙盒中打开]
action=compare
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取两页面之间的差异。
必须传递“from”和“to”之间的修订版本号、页面标题、页面ID、文本或相关参考资料。
- fromtitle
要比较的第一个标题。
- fromid
要比较的第一个页面 ID。
- 类型:整数
- fromrev
要比较的第一个修订版本。
- 类型:整数
- fromslots
Override content of the revision specified by fromtitle, fromid or fromrev.
This parameter specifies the slots that are to be modified. Use fromtext-{slot}, fromcontentmodel-{slot}, and fromcontentformat-{slot} to specify content for each slot.
- 值(以|或替代物分隔):main
- fromtext-{slot}
Text of the specified slot. If omitted, the slot is removed from the revision.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为fromslots的值。
- fromsection-{slot}
When fromtext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by fromtitle, fromid or fromrev as if for a section edit.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为fromslots的值。
- fromcontentformat-{slot}
Content serialization format of fromtext-{slot}.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为fromslots的值。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- fromcontentmodel-{slot}
Content model of fromtext-{slot}. If not supplied, it will be guessed based on the other parameters.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为fromslots的值。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- frompst
在fromtext执行预保存转变。
- 类型:布尔值(详细信息)
- fromtext
- 已弃用。
使用该文本而不是由fromtitle、fromid或fromrev指定的修订版本内容。
- fromcontentformat
- 已弃用。
fromtext的内容序列化格式。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- fromcontentmodel
- 已弃用。
fromtext的内容模型。如果未指定,这将基于其他参数猜想。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- fromsection
- 已弃用。
只使用指定“from”内容的指定章节。
- totitle
要比较的第二个标题。
- toid
要比较的第二个页面 ID。
- 类型:整数
- torev
要比较的第二个修订版本。
- 类型:整数
- torelative
使用与定义自fromtitle、fromid或fromrev的修订版本相关的修订版本。所有其他“to”的选项将被忽略。
- 以下值中的一个:prev、next、cur
- toslots
Override content of the revision specified by totitle, toid or torev.
This parameter specifies the slots that are to be modified. Use totext-{slot}, tocontentmodel-{slot}, and tocontentformat-{slot} to specify content for each slot.
- 值(以|或替代物分隔):main
- totext-{slot}
Text of the specified slot. If omitted, the slot is removed from the revision.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为toslots的值。
- tosection-{slot}
When totext-{slot} is the content of a single section, this is the section number. It will be merged into the revision specified by totitle, toid or torev as if for a section edit.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为toslots的值。
- tocontentformat-{slot}
Content serialization format of totext-{slot}.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为toslots的值。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- tocontentmodel-{slot}
Content model of totext-{slot}. If not supplied, it will be guessed based on the other parameters.
- 这是一个模板参数。当做出请求时,参数名中的{slot}应替换为toslots的值。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- topst
在totext执行预保存转换。
- 类型:布尔值(详细信息)
- totext
- 已弃用。
使用该文本而不是由totitle、toid或torev指定的修订版本内容。
- tocontentformat
- 已弃用。
totext的内容序列化格式。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- tocontentmodel
- 已弃用。
totext的内容模型。如果未指定,这将基于其他参数猜想。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- tosection
- 已弃用。
只使用指定“to”内容的指定章节。
- prop
要获取的信息束。
- diff
- 差异HTML。
- diffsize
- 差异HTML的大小(字节)。
- rel
- “from”之前及“to”之后修订版本的修订ID,如果有。
- ids
- “from”和“to”修订版本的页面及修订ID。
- title
- “from”和“to”修订版本的页面标题。
- user
- “from”和“to”修订版本的用户名和ID。
- comment
- “from”和“to”修订版本的注释。
- parsedcomment
- “from”和“to”修订版本的已解析注释。
- size
- “from”和“to”修订版本的大小。
- 值(以|或替代物分隔):diff、diffsize、rel、ids、title、user、comment、parsedcomment、size
- 默认:diff|ids|title
- slots
Return individual diffs for these slots, rather than one combined diff for all slots.
- 值(以|或替代物分隔):main
- 要指定所有值,请使用*。
- 在版本1和2中创建差异。
- api.php?action=compare&fromrev=1&torev=2 [在沙盒中打开]
action=createaccount (create)
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
创建一个新用户账户。
使用此模块的一般程序是:
- 通过amirequestsfor=create取得来自action=query&meta=authmanagerinfo的可用字段,和来自action=query&meta=tokens的createaccount令牌。
- 向用户显示字段,并获得其提交的内容。
- 发送(POST)至此模块,提供createreturnurl及任何相关字段。
- 在响应中检查status。
- 如果您收到了PASS(成功)或FAIL(失败),则认为操作结束。成功与否如上句所示。
- 如果您收到了UI,向用户显示新字段,并再次获取其提交的内容。然后再次使用createcontinue,向本模块提交相关字段,并重复第四步。
- 如果您收到了REDIRECT,将用户指向redirecttarget中的目标,等待其返回createreturnurl。然后再次使用createcontinue,向本模块提交返回URL中提供的一切字段,并重复第四步。
- 如果您收到了RESTART,这意味着身份验证正常运作,但我们没有链接的用户账户。您可以将此看做UI或FAIL。
- createrequests
只使用这些身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=create,或来自此模块之前的响应。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- createmessageformat
用于返回消息的格式。
- 以下值中的一个:html、wikitext、raw、none
- 默认:wikitext
- createmergerequestfields
合并用于所有身份验证请求的字段信息至一个数组中。
- 类型:布尔值(详细信息)
- createpreservestate
从之前失败的登录尝试中保持状态,如果可能。
如果action=query&meta=authmanagerinfo返回用于hasprimarypreservedstate的真值,标记为primary-required的请求应被忽略。如果它返回用于preservedusername的非空值,用户名必须用于username参数。
- 类型:布尔值(详细信息)
- createreturnurl
为第三方身份验证流返回URL,必须为绝对值。需要此值或createcontinue两者之一。
在接收REDIRECT响应时,您将代表性的打开浏览器或web视图到特定用于第三方身份验证流的redirecttarget URL。当它完成时,第三方将发生浏览器或web视图至此URL。您应当提取任何来自URL的查询或POST参数,并作为createcontinue请求传递至此API模块。
- createcontinue
此请求是在早先的UI或REDIRECT响应之后的附加请求。必需此值或createreturnurl。
- 类型:布尔值(详细信息)
- createtoken
从action=query&meta=tokens取回的“createaccount”令牌
- 这个参数是必须的。
- *
- 此模块允许额外参数,取决于可用的身份验证请求。使用action=query&meta=authmanagerinfo与amirequestsfor=create(或之前来自此模块的相应,如果可以)以决定可用请求及其使用的字段。
action=cspreport
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
由浏览器使用以报告违反内容安全方针的内容。此模块应永不使用,除了在被CSP兼容的浏览器自动使用时。
- reportonly
标记作为来自监视方针的报告,而不是执行方针的报告
- 类型:布尔值(详细信息)
- source
生成引发此报告的CSP标头的事物
- 默认:internal
action=delete
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
删除一个页面。
- title
要删除的页面标题。不能与pageid一起使用。
- pageid
要删除的页面的页面 ID。不能与title一起使用。
- 类型:整数
- reason
删除原因。如果未设置,将使用一个自动生成的原因。
- tags
要在删除日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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=echomarkread
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Echo
- 许可协议:MIT
对当前用户标记通知为已读。
- list
要标记已读的通知ID列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- unreadlist
要标记未读的通知ID列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- all
如果设置,标记一位用户的所有通知为已读。
- 类型:布尔值(详细信息)
- sections
要标记为已读的部分列表。
- 值(以|或替代物分隔):alert、message
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=echomarkseen
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Echo
- 许可协议:MIT
对当前用户标记通知为已读。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- type
要标记为已读的通知类型:“alert”、“message”或“all”。
- 这个参数是必须的。
- 以下值中的一个:alert、message、all
- timestampFormat
用于输出的时间戳格式,“ISO_8601”或“MW”。“MW”在此被弃用,因此所有客户端应切换为“ISO_8601”。此参数将被移除,且“ISO_8601”将成为唯一的输出格式。
- 以下值中的一个:ISO_8601、MW
- 默认:MW
- 标记所有类型的通知为已读
- api.php?action=echomarkseen&type=all [在沙盒中打开]
action=edit
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
创建和编辑页面。
- 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。
- 值必须不少于0。
- 类型:整数
- undoafter
撤销从undo至此的所有修订。如果不设置就撤销一次修订。
- 值必须不少于0。
- 类型:整数
- redirect
自动解决重定向。
- 类型:布尔值(详细信息)
- contentformat
用于输入文本的内容序列化格式。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- contentmodel
新内容的内容模型。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- token
从action=query&meta=tokens取回的“csrf”令牌
令牌应总是发送为最后参数,或至少在text参数之后。
- 这个参数是必须的。
- captchaword
回答验证码
- captchaid
之前请求的验证码ID
- 编辑一个页面。
- 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 [在沙盒中打开]
- 撤销修订版本13579至13585并自动填写编辑摘要。
- 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-or-later
电子邮件联系一位用户。
- 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-or-later
展开wiki文本中的所有模板。
- title
页面标题。
- text
要转换的wiki文本。
- 这个参数是必须的。
- revid
修订版本ID,用于
{{REVISIONID}}
和类似变体。- 类型:整数
- prop
要获取的那条信息。
注意如果没有选定值,结果将包含wiki文本,但将以弃用的格式显示。
- wikitext
- 展开后的wiki文本。
- categories
- 任何在输出中提供的,未在wiki文本输出中表现的分类。
- 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-or-later
返回用户贡献纲要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- user
获取哪些用户的贡献。
- 这个参数是必须的。
- 类型:用户名
- namespace
过滤哪些名字空间的贡献。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- year
起始年份(及更早)。
- 类型:整数
- month
起始月份(及更早)。
- 类型:整数
- tagfilter
过滤有这些标签的贡献者。
- 值(以|或替代物分隔):mw-contentmodelchange、mw-new-redirect、mw-removed-redirect、mw-changed-redirect-target、mw-blank、mw-replace、mw-rollback、mw-undo、mobile edit、mobile web edit、advanced mobile edit、visualeditor、visualeditor-needcheck、visualeditor-switched、visualeditor-wikitext、HHVM、php7
- 默认:(空)
- deletedonly
仅显示已删除的贡献。
- 类型:布尔值(详细信息)
- toponly
仅仅显示那些作为最新修订的编辑。
- 类型:布尔值(详细信息)
- newonly
仅仅显示那些作为页面创建的编辑。
- 类型:布尔值(详细信息)
- hideminor
隐藏小编辑。
- 类型:布尔值(详细信息)
- showsizediff
显示修订版本之间的大小差别。
- 类型:布尔值(详细信息)
- 返回用户Example的贡献。
- api.php?action=feedcontributions&user=Example [在沙盒中打开]
action=feedrecentchanges
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回最近更改的摘要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- namespace
用于限制结果的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- invert
除所选定者外的所有名字空间。
- 类型:布尔值(详细信息)
- associated
包括相关的名字空间(讨论页或主要)。
- 类型:布尔值(详细信息)
- days
用于限制结果的天数。
- 值必须不少于1。
- 类型:整数
- 默认:7
- limit
所要返回结果的最大数目。
- 值必须介于1和50之间。
- 类型:整数
- 默认:50
- from
显示自那时以来的更改。
- 类型:时间戳(允许格式)
- hideminor
隐藏小更改。
- 类型:布尔值(详细信息)
- hidebots
隐藏机器人所做的更改。
- 类型:布尔值(详细信息)
- hideanons
隐藏匿名用户做出的更改。
- 类型:布尔值(详细信息)
- hideliu
隐藏注册用户做出的更改。
- 类型:布尔值(详细信息)
- hidepatrolled
隐藏已巡查更改。
- 类型:布尔值(详细信息)
- hidemyself
隐藏当前用户做出的更改。
- 类型:布尔值(详细信息)
- hidecategorization
隐藏分类成员更改。
- 类型:布尔值(详细信息)
- tagfilter
按标签过滤。
- target
仅仅显示从该页面链出的那些页面的变更。
- showlinkedto
仅仅显示链入到该页面的那些页面的变更。
- 类型:布尔值(详细信息)
action=feedwatchlist
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回监视列表纲要。
- feedformat
纲要的格式。
- 以下值中的一个:rss、atom
- 默认:rss
- hours
列出从现在起数小时内修改的页面。
- 值必须介于1和72之间。
- 类型:整数
- 默认:24
- linktosections
如果可能的话,直接链接到已变更的小节。
- 类型:布尔值(详细信息)
- allrev
将同一页面的多个修订包含于指定的时间表内。
- 类型:布尔值(详细信息)
- wlowner
与token一起使用以访问不同用户的监视列表。
- 类型:用户名
- wltoken
允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。
- wlshow
只显示满足这些标准的项目。例如,要只查看由登录用户做出的小编辑,设置show=minor|!anon。
- 值(以|或替代物分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、autopatrolled、!autopatrolled、unread、!unread
- wltype
要显示的更改类型:
- edit
- 普通页面编辑。
- new
- 页面创建。
- log
- 日志记录。
- external
- 外部更改。
- categorize
- 分类成员组更改。
- 值(以|或替代物分隔):edit、new、log、external、categorize
- 默认:edit|new|log|categorize
- wlexcludeuser
不要列出此用户的更改。
- 类型:用户名
- 显示监视列表订阅。
- api.php?action=feedwatchlist [在沙盒中打开]
- 显示过去6小时内受监视页面的所有更改。
- api.php?action=feedwatchlist&allrev=&hours=6 [在沙盒中打开]
action=filerevert
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
回退一个文件至某一旧版本。
- 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=flow
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
允许对Flow页面的操作。
- submodule
要调用的Flow子模块。
- edit-header
- 编辑板块的描述。
- edit-post
- 编辑帖子的内容。
- edit-title
- 编辑话题的标题。
- edit-topic-summary
- 编辑一个话题的摘要内容。
- lock-topic
- 锁定或解锁一个Flow话题。
- moderate-post
- 限制一个Flow帖子。
- moderate-topic
- 限制一个Flow帖子。
- new-topic
- 在指定的工作流中创建一个新的Flow话题。
- reply
- 回复一个帖子。
- undo-edit-header
- 检索撤销描述编辑所必需的信息。
- undo-edit-post
- 检索撤销帖子编辑所必需的信息。
- undo-edit-topic-summary
- 检索撤销话题摘要编辑所必需的信息。
- view-header
- 查看板块描述。
- view-post
- 查看帖子。
- view-post-history
- 浏览一个帖子的修订历史。
- view-topic
- 查看话题。
- view-topic-history
- 浏览一个话题的修订历史。
- view-topic-summary
- 查看话题摘要。
- view-topiclist
- 查看话题列表。
- close-open-topic
- 已弃用。 由于action=flow&submodule=lock-topic而弃用。
- 这个参数是必须的。
- 以下值中的一个:edit-header、edit-post、edit-title、edit-topic-summary、lock-topic、moderate-post、moderate-topic、new-topic、reply、undo-edit-header、undo-edit-post、undo-edit-topic-summary、view-header、view-post、view-post-history、view-topic、view-topic-history、view-topic-summary、view-topiclist、close-open-topic
- page
要进行操作的页面。
- 默认:Topic:Flow-enabled_page
- token
从action=query&meta=tokens取回的令牌
- 默认:(空)
submodule=close-open-topic (cot)
- 此模块已弃用。
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
由于action=flow&submodule=lock-topic而弃用。
- cotmoderationState
提交话题的情形,要么“lock”要么“unlock”。
- 这个参数是必须的。
- 以下值中的一个:lock、unlock、close、reopen
- cotreason
锁定或解锁话题的原因。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=edit-header (eh)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
编辑板块的描述。
- ehprev_revision
当前描述修订的版本ID,以检查编辑冲突。
- ehcontent
用于描述的内容。
- 这个参数是必须的。
- ehformat
描述的格式(wikitext|html)
- 以下值中的一个:html、wikitext
- 默认:wikitext
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=edit-post (ep)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
编辑帖子的内容。
- eppostId
帖子ID。
- 这个参数是必须的。
- epprev_revision
当前帖子修订的版本ID,以检查编辑冲突。
- 这个参数是必须的。
- epcontent
帖子的内容。
- 这个参数是必须的。
- epformat
帖子内容的格式(wikitext|html)
- 以下值中的一个:html、wikitext
- 默认:wikitext
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=edit-title (et)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
编辑话题的标题。
- etprev_revision
当前标题修订的版本ID,以检查编辑冲突。
- 这个参数是必须的。
- etcontent
标题的内容,与允许用于编辑摘要的格式相同(话题-标题-wiki文本)。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=edit-topic-summary (ets)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
编辑一个话题的摘要内容。
- etsprev_revision
当前话题摘要修订的版本ID(如果有),以检查编辑冲突。
- etssummary
编辑摘要的内容。
- 这个参数是必须的。
- etsformat
摘要格式(wikitext|html)
- 以下值中的一个:html、wikitext
- 默认:wikitext
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=lock-topic (cot)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
锁定或解锁一个Flow话题。
- cotmoderationState
提交话题的情形,要么lock要么unlock。
- 这个参数是必须的。
- 以下值中的一个:lock、unlock、close、reopen
- cotreason
锁定或解锁此话题的原因。注意wiki上的Flow客户端在此使用“Marked as resolved”,并将可选的额外信息放置在摘要中。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=moderate-post (mp)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
限制一个Flow帖子。
- mpmoderationState
限制等级。
- 这个参数是必须的。
- 以下值中的一个:可以为空,或delete、hide、suppress、restore、unhide、undelete、unsuppress
- mpreason
限制的原因。
- 这个参数是必须的。
- mppostId
要限制的帖子ID。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=moderate-topic (mt)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
限制一个Flow帖子。
- mtmoderationState
限制等级。
- 这个参数是必须的。
- 以下值中的一个:可以为空,或delete、hide、suppress、restore、unhide、undelete、unsuppress
- mtreason
限制的原因。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=new-topic (nt)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
在指定的工作流中创建一个新的Flow话题。
- nttopic
用于新话题标题的文字。
- 这个参数是必须的。
- ntcontent
用于话题的最初回复的内容。
- 这个参数是必须的。
- ntformat
新话题首次回复的格式(wikitext|html)
- 以下值中的一个:html、wikitext
- 默认:wikitext
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=reply (rep)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
回复一个帖子。
- repreplyTo
要回复的ID。
- 这个参数是必须的。
- repcontent
新帖子的内容。
- 这个参数是必须的。
- repformat
新帖子的格式(wikitext|html)
- 以下值中的一个:html、wikitext
- 默认:wikitext
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
submodule=undo-edit-header (ueh)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
检索撤销描述编辑所必需的信息。
- uehstartId
要开始撤销的修订ID。
- 这个参数是必须的。
- uehendId
要结束撤销的修订ID。
- 这个参数是必须的。
submodule=undo-edit-post (uep)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
检索撤销帖子编辑所必需的信息。
- uepstartId
要开始撤销的修订ID。
- 这个参数是必须的。
- uependId
要结束撤销的修订ID。
- 这个参数是必须的。
submodule=undo-edit-topic-summary (uets)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
检索撤销话题摘要编辑所必需的信息。
- uetsstartId
要开始撤销的修订ID。
- 这个参数是必须的。
- uetsendId
要结束撤销的修订ID。
- 这个参数是必须的。
submodule=view-header (vh)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
查看板块描述。
- vhformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
- vhrevId
加载此修订版本,而不是最新的。
submodule=view-post (vp)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
查看帖子。
- vppostId
要查看的帖子ID。
- 这个参数是必须的。
- vpformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
submodule=view-post-history (vph)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
浏览一个帖子的修订历史。
- vphpostId
要查看修订历史的帖子ID。
- 这个参数是必须的。
- vphformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
submodule=view-topic (vt)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
查看话题。
- vtformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
submodule=view-topic-history (vth)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
浏览一个话题的修订历史。
- vthformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
submodule=view-topic-summary (vts)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
查看话题摘要。
- vtsformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
- vtsrevId
加载此修订版本,而不是最新的。
submodule=view-topiclist (vtl)
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
查看话题列表。
- vtloffset-dir
排序话题的方向。
- 以下值中的一个:fwd、rev
- 默认:fwd
- vtlsortby
话题的排序选项,既可以是updated(按话题更新时间排序),又可以是newest(按话题创建时间排序)。
- 以下值中的一个:newest、updated、user
- 默认:user
- vtlsavesortby
保存排序方式选项至用户设置,如果设置。
- 类型:布尔值(详细信息)
- vtloffset-id
开始抓取话题的偏移值(UUID格式),只与newest一起用于排序
- vtloffset
偏移值(作为一个
TS_MW
格式的话题更新时间戳(YYYYMMDDHHMMSS
)),以开始取得话题;只与updated一起排序- vtlinclude-offset
在结果中也包括抵消项目。
- 类型:布尔值(详细信息)
- vtllimit
要取得的话题数量。
- 不允许超过100个(对于机器人则是100个)。
- 类型:整数或max
- 默认:10
- vtltoconly
是否只响应TOC需要的信息。
- 类型:布尔值(详细信息)
- vtlformat
返回内容的格式。
- 以下值中的一个:html、wikitext、fixed-html
- 默认:fixed-html
action=flow-parsoid-utils
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
在wiki文本和HTML之间互相转换文本。
- from
要转换内容的来源格式。
- 这个参数是必须的。
- 以下值中的一个:html、wikitext
- to
要转换内容的目标格式。
- 这个参数是必须的。
- 以下值中的一个:html、wikitext
- content
要转换的内容。
- 这个参数是必须的。
- title
页面标题。不能与pageid一起使用。
- pageid
页面ID。不能与title一起使用。
- 类型:整数
- 将wiki文本'''lorem''' ''blah''转换为HTML
- api.php?action=flow-parsoid-utils&from=wikitext&to=html&content='''lorem'''+''blah''&title=Main_Page [在沙盒中打开]
action=groupreview
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
设置信息组工作流状态。
- group
信息组。
- 这个参数是必须的。
- language
语言代码。
- 默认:en
- state
组的新状态。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 将用于消息组“group-Example”的德语翻译状态标记为已就绪
- api.php?action=groupreview&group=page-Example&language=de&state=ready&token=foo [在沙盒中打开]
action=help
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
显示指定模块的帮助。
- 主模块帮助。
- api.php?action=help [在沙盒中打开]
- 用于action=query及其所有子模块的帮助。
- api.php?action=help&modules=query&submodules=1 [在沙盒中打开]
- 一个页面中的所有帮助。
- 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-or-later
旋转一幅或多幅图像。
- rotation
顺时针旋转图像的度数。
- 这个参数是必须的。
- 以下值中的一个:90、180、270
- continue
当更多结果可用时,使用这个继续。
- tags
要在上传日志中应用到实体的标签。
- 值(以|或替代物分隔):
- titles
要工作的标题列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- allcategories
- 列举所有分类。
- alldeletedrevisions
- 列举由一位用户或在一个名字空间中所有已删除的修订。
- allfileusages
- 列出所有文件用途,包括不存在的。
- allimages
- 按顺序枚举所有图像。
- alllinks
- 列举所有指向至指定名字空间的链接。
- allpages
- 循序列举在指定名字空间中的所有页面。
- allredirects
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、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-or-later
从其他wiki,或从XML文件导入页面。
注意当发送用于xml参数的文件时,HTTP POST必须作为文件上传完成(即使用multipart/form-data)
- summary
日志记录导入摘要。
- xml
上传的XML文件。
- 必须被公布为使用multipart/form-data的一次文件上传。
- interwikiprefix
对于上传导入:要应用到位置用户名的跨wiki前缀(如果设置了assignknownusers的话,则也包含已知用户)。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- assignknownusers
分配编辑至本地用户,只要命名用户存在于本地。
- 类型:布尔值(详细信息)
- rootpage
作为此页面的子页面导入。不能与namespace一起使用。
- tags
要在导入日志,以及在导入页面的空修订版本中应用到实体的更改标签。
- 值(以|或替代物分隔):
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=languagesearch
- 此模块需要读取权限。
- 来源:UniversalLanguageSelector
- 许可协议:GPL-2.0-or-later
使用任何字母搜索语言名称。
- search
搜索字符串。
- 这个参数是必须的。
- typos
搜索字符串中允许的拼写错误数量。
- 类型:整数
- 默认:1
action=linkaccount (link)
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
将来自第三方提供商的账户链接至当前用户。
使用此模块的一般程序是:
- 通过amirequestsfor=link取得来自action=query&meta=authmanagerinfo的可用字段,和来自action=query&meta=tokens的csrf令牌。
- 向用户显示字段,并获得其提交的内容。
- 发送(POST)至此模块,提供linkreturnurl及任何相关字段。
- 在响应中检查status。
- 如果您收到了PASS(成功)或FAIL(失败),则认为操作结束。成功与否如上句所示。
- 如果您收到了UI,向用户显示新字段,并再次获取其提交的内容。然后再次使用linkcontinue,向本模块提交相关字段,并重复第四步。
- 如果您收到了REDIRECT,将用户指向redirecttarget中的目标,等待其返回linkreturnurl。然后再次使用linkcontinue,向本模块提交返回URL中提供的一切字段,并重复第四步。
- 如果您收到了RESTART,这意味着身份验证正常运作,但我们没有链接的用户账户。您可以将此看做UI或FAIL。
- linkrequests
只使用这些身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=link,或来自此模块之前的响应。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- linkmessageformat
用于返回消息的格式。
- 以下值中的一个:html、wikitext、raw、none
- 默认:wikitext
- linkmergerequestfields
合并用于所有身份验证请求的字段信息至一个数组中。
- 类型:布尔值(详细信息)
- linkreturnurl
为第三方身份验证流返回URL,必须为绝对值。需要此值或linkcontinue两者之一。
在接收REDIRECT响应时,您将代表性的打开浏览器或web视图到特定用于第三方身份验证流的redirecttarget URL。当它完成时,第三方将发生浏览器或web视图至此URL。您应当提取任何来自URL的查询或POST参数,并作为linkcontinue请求传递至此API模块。
- linkcontinue
此请求是在早先的UI或REDIRECT响应之后的附加请求。必需此值或linkreturnurl。
- 类型:布尔值(详细信息)
- linktoken
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- *
- 此模块允许额外参数,取决于可用的身份验证请求。使用action=query&meta=authmanagerinfo与amirequestsfor=link(或之前来自此模块的相应,如果可以)以决定可用请求及其使用的字段。
action=login (lg)
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
登录并获取身份验证cookie。
此操作只应与Special:BotPasswords一起使用;用于主账户登录的方式已弃用,并可能在没有警告的情况下失败。要安全登录主账户,请使用action=clientlogin。
- lgname
用户名。
- lgpassword
密码。
- lgdomain
域名(可选)。
- lgtoken
从action=query&meta=tokens取回的“login”令牌
action=logout
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
退出并清除会话数据。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=managetags
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
执行有关更改标签的管理任务。
- operation
要执行哪个操作:
- create
- 创建一个新的更改标签供手动使用。
- delete
- 从数据库中移除一个更改标签,包括移除已使用在所有修订版本、最近更改记录和日志记录上的该标签。
- activate
- 激活一个更改标签,允许用户手动应用它。
- deactivate
- 停用一个更改标签,阻止用户手动应用它。
- 这个参数是必须的。
- 以下值中的一个:create、delete、activate、deactivate
- tag
要创建、删除、激活或取消激活的标签。要创建标签,标签必须不存在。要删除标签,标签必须存在。要激活标签,标签必须存在,且不被任何扩展使用。要取消激活标签,标签必须当前处于激活状态,且被手动定义。
- 这个参数是必须的。
- reason
一个创建、删除、激活或停用标签时的原因,可选。
- ignorewarnings
是否忽略操作期间发生的任何警告。
- 类型:布尔值(详细信息)
- tags
要在标签管理日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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=mergehistory
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
合并页面历史。
- from
将被合并历史的页面的标题。不能与fromid一起使用。
- fromid
将被合并历史的页面的页面ID。不能与from一起使用。
- 类型:整数
- to
将要合并历史的页面的标题。不能与toid一起使用。
- toid
将要合并历史的页面的页面ID。不能与to一起使用。
- 类型:整数
- timestamp
指定时间戳,决定源页面的哪些修订历史被移动到目标页面的历史中。如果省略,源页面的所有历史记录都将被合并到目标页面。
- 类型:时间戳(允许格式)
- reason
历史合并的原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 将Oldpage的完整历史合并至Newpage。
- api.php?action=mergehistory&from=Oldpage&to=Newpage&token=123ABC&reason=Reason [在沙盒中打开]
- 将Oldpage直到2015-12-31T04:37:41Z的页面修订版本合并至Newpage。
- api.php?action=mergehistory&from=Oldpage&to=Newpage&token=123ABC&reason=Reason×tamp=2015-12-31T04%3A37%3A41Z [在沙盒中打开]
action=mobileview
- 此模块需要读取权限。
- 来源:MobileFrontend
- 许可协议:GPL-2.0-or-later
返回移动浏览需要的数据。
- page
待处理的页面标题。
- 这个参数是必须的。
- redirect
是否允许重定向。
- 以下值中的一个:yes、no
- 默认:yes
- sections
用于返回文本的逗号分隔的段数列表。“all”可用于返回所有的。格式范围“1-4”是指获取1、2、3、4段。没有指定第二个数字的范围,例如“1-”意思是获取所有直到末尾。“references”可被用于指定所有包含参考资料的段落应该被返回。
- prop
要获得的信息:
- text
- 选定段落的HTML。
- sections
- 有关页面上所有段落的信息。
- normalizedtitle
- 标准化的页面标题。
- lastmodified
- 页面最近修改时的 ISO 8601 时间戳,例如“2014-04-13T22:42:14Z”。
- lastmodifiedby
- 有关最近修改页面的用户的信息。
- revision
- 返回页面的当前修订版本ID。
- protection
- 有关保护级别的信息。
- editable
- 当前用户是否可以编辑此页面。这考虑所有用于登录用户的因素,但不考虑匿名用户的封禁状态。
- languagecount
- 此页面可用的语言数。
- hasvariants
- 此页面在其他语言变体中是否可用。
- displaytitle
- 页面的渲染标题,{{DISPLAYTITLE}}等代码生效。
- pageprops
- 页面属性。
- 值(以|或替代物分隔):id、text、sections、normalizedtitle、lastmodified、lastmodifiedby、revision、protection、editable、languagecount、hasvariants、displaytitle、pageprops、description、contentmodel、namespace、image、thumb
- 默认:text|sections|normalizedtitle
- sectionprop
要获取的有关操作的信息。
- 值(以|或替代物分隔):toclevel、level、line、number、index、fromtitle、anchor
- 默认:toclevel|line
- pageprops
返回的页面属性,竖线(“|”)分隔列表或“*”对于所有属性。
- 默认:notoc|noeditsection|wikibase_item
- variant
转换内容至这种语言变体。
- 默认:(空)
- noimages
返回不带图片的HTML。
- 类型:布尔值(详细信息)
- noheadings
输出时不包含标题。
- 类型:布尔值(详细信息)
- notransform
不要改变HTML至移动适配版。
- 类型:布尔值(详细信息)
- onlyrequestedsections
只返回请求的与prop=sections一样的段落。
- 类型:布尔值(详细信息)
- offset
假装所有文本结果是一个字符串,并返回此点位开始的子字符串。
- 值必须不少于0。
- 类型:整数
- 默认:0
- maxlen
假装所有文本结果是一个字符串,并限制结果至此长度。
- 值必须不少于0。
- 类型:整数
- 默认:0
- revision
请求一个特定修订版本。
- 值必须不少于0。
- 类型:整数
- 默认:0
- thumbheight
最大缩略图高度。
- 值必须不少于0。
- 类型:整数
- thumbwidth
最大缩略图宽度。
- 值必须不少于0。
- 类型:整数
- thumbsize
最大缩略图尺寸。
- 值必须不少于0。
- 类型:整数
- 获取有关Doom metal的第0章节的信息
- api.php?action=mobileview&page=Doom_metal§ions=0 [在沙盒中打开]
- 获取有关第0节和包含Candlemass的参考资料的段落的信息
- api.php?action=mobileview&page=Candlemass§ions=0|references [在沙盒中打开]
- 获得有关第1节及以后,和包含Candlemass的参考资料的段落的信息
- api.php?action=mobileview&page=Candlemass§ions=1-|references [在沙盒中打开]
action=move
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
移动一个页面。
- from
要重命名的页面标题。不能与fromid一起使用。
- fromid
您希望移动的页面ID。不能与from一起使用。
- 类型:整数
- to
页面重命名的目标标题。
- 这个参数是必须的。
- reason
重命名的原因。
- 默认:(空)
- movetalk
重命名讨论页,如果存在。
- 类型:布尔值(详细信息)
- movesubpages
重命名子页面,如果可以。
- 类型:布尔值(详细信息)
- noredirect
不要创建重定向。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- ignorewarnings
忽略任何警告。
- 类型:布尔值(详细信息)
- tags
要在移动日志,以及在目标页面的空修订版本中应用到实体的更改标签。
- 值(以|或替代物分隔):
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 移动Badtitle到Goodtitle,不保留重定向。
- api.php?action=move&from=Badtitle&to=Goodtitle&token=123ABC&reason=Misspelled%20title&movetalk=&noredirect= [在沙盒中打开]
action=oathvalidate
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 此模块只允许POST请求。
- 来源:OATHAuth
- 许可协议:GPL-2.0-or-later AND GPL-3.0-or-later
验证一个双因素验证(OATH)令牌。
- user
要验证令牌的用户。默认为当前用户。
- 类型:用户名
- totp
双因素验证(OATH)令牌。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=opensearch
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
使用开放搜索协议搜索wiki。
- search
搜索字符串。
- 这个参数是必须的。
- namespace
搜索的名字空间。如果search以有效名字空间前缀开头则忽略。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 默认:0
- limit
要返回的结果最大数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- 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-or-later
更改当前用户的参数设置。
只有注册在核心或者已安装扩展中的选项,或者具有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-or-later
获得关于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、allrevisions、alltransclusions、allusers、authmanagerinfo、babel、backlinks、betafeatures、blocks、categories、categoryinfo、categorymembers、cirrusbuilddoc、cirrusdoc、contributors、deletedrevisions、deletedrevs、duplicatefiles、embeddedin、extlinks、extracts、exturlusage、filearchive、filerepoinfo、fileusage、flowinfo、gadgetcategories、gadgets、imageinfo、images、imageusage、info、iwbacklinks、iwlinks、langbacklinks、langlinks、languagestats、links、linkshere、logevents、messagecollection、messagegroups、messagegroupstats、messagetranslations、mystashedfiles、notifications、oath、pageimages、pagepropnames、pageprops、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、references、revisions、search、siteinfo、stashimageinfo、tags、templates、tokens、transcludedin、unreadnotificationpages、usercontribs、userinfo、users、watchlist、watchlistraw
- 值的最大数量是50(对于机器人则是500)。
- mainmodule
- 已弃用。
获取有关主要(最高级)模块的信息。也可使用modules=main。
- pagesetmodule
- 已弃用。
获取有关页面设置模块(提供titles=和朋友)的信息。
- formatmodules
- 已弃用。
格式模块名称(format参数的值)的列表。也可使用modules。
- 值(以|或替代物分隔):json、jsonfm、none、php、phpfm、rawfm、xml、xmlfm
action=parse
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
解析内容并返回解析器输出。
参见action=query的各种prop-module以从页面的当前版本获得信息。
这里有几种方法可以指定解析的文本:
- 指定一个页面或修订,使用page、pageid或oldid。
- 明确指定内容,使用text、title、revid和contentmodel。
- 只指定一段摘要解析。prop应提供一个空值。
- title
文本属于的页面标题。如果省略,contentmodel就必须被指定,且API将作为标题使用。
- text
要解析的文本。使用title或contentmodel以控制内容模型。
- revid
修订版本ID,用于
{{REVISIONID}}
和类似变体。- 类型:整数
- 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文本添加标题。
- headhtml
- 提供页面的被解析
<head>
。 - modules
- 提供在页面中使用的ResourceLoader模块。要加载,请使用
mw.loader.using()
。无论jsconfigvars还是encodedjsconfigvars都必须与modules共同被请求。 - jsconfigvars
- 针对页面提供JavaScript配置变量。要应用,请使用
mw.config.set()
。 - encodedjsconfigvars
- 针对页面提供JavaScript配置变量为一个JSON字符串。
- indicators
- 提供页面上使用的页面状态指示器的HTML。
- iwlinks
- 在被解析的wiki文本中提供跨wiki链接。
- wikitext
- 提供被解析的原始wiki文本。
- properties
- 提供多种定义在被解析的wiki文本中的属性。
- limitreportdata
- 以结构化的方式提供限制报告。如果disablelimitreport被设定则不提供数据。
- limitreporthtml
- 提供限制报告的HTML版本。当disablelimitreport被设置时不会提供数据。
- parsetree
- 修订内容的XML解析树(需要内容模型
wikitext
) - parsewarnings
- 在解析内容时提供发生的警告
- headitems
- 已弃用。 提供项目以插入至页面的
<head>
。
- 值(以|或替代物分隔):text、langlinks、categories、categorieshtml、links、templates、images、externallinks、sections、revid、displaytitle、headhtml、modules、jsconfigvars、encodedjsconfigvars、indicators、iwlinks、wikitext、properties、limitreportdata、limitreporthtml、parsetree、parsewarnings、headitems
- 默认:text|langlinks|categories|links|templates|images|externallinks|sections|revid|displaytitle|iwlinks|properties|parsewarnings
- wrapoutputclass
要用于包裹解析输出的CSS类。
- 默认:mw-parser-output
- pst
在解析输入前,对输入做一次保存前变换处理。仅当使用文本时有效。
- 类型:布尔值(详细信息)
- onlypst
在输入内容中执行预保存转换(PST),但不解析它。在PST被应用后返回相同的wiki文本。只当与text一起使用时有效。
- 类型:布尔值(详细信息)
- effectivelanglinks
- 已弃用。
包含由扩展提供的语言链接(用于与prop=langlinks一起使用)。
- 类型:布尔值(详细信息)
- section
只解析此段数的内容。
当new时,将text和sectiontitle解析为添加新段落至页面。
new段落只当指定text时允许。
- sectiontitle
当section为new时新段落标题。
不像页面编辑,当省略或为空时将不会备选为summary。
- disablepp
- 已弃用。
请改用disablelimitreport。
- 类型:布尔值(详细信息)
- disablelimitreport
从解析器输出中省略限制报告(“NewPP limit report”)。
- 类型:布尔值(详细信息)
- disableeditsection
从解析器输出中省略编辑段落链接。
- 类型:布尔值(详细信息)
- disabletidy
- 已弃用。
不要在解析器输出中运行HTML清理(例如tidy)。
- 类型:布尔值(详细信息)
- disablestylededuplication
不要在解析器输出中删除重复的行内样式表。
- 类型:布尔值(详细信息)
- generatexml
- 已弃用。
生成XML解析树(需要内容模型
wikitext
;被prop=parsetree所取代)。- 类型:布尔值(详细信息)
- preview
在预览模式下解析。
- 类型:布尔值(详细信息)
- sectionpreview
在段落预览模式下解析(同时要启用预览模式)。
- 类型:布尔值(详细信息)
- disabletoc
在输出中省略目录。
- 类型:布尔值(详细信息)
- useskin
为解析器输出应用选择的皮肤。会影响以下属性:langlinks、headitems、modules、jsconfigvars和indicators。
- 以下值中的一个:monobook、timeless、vector、minerva
- contentformat
用于输入文本的内容序列化格式。只当与text一起使用时有效。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- contentmodel
输入文本的内容模型。如果省略,title必须指定,并且默认将为指定标题的模型。只当与text一起使用时有效。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- mobileformat
以适配移动设备的格式返回解析输出。
- 类型:布尔值(详细信息)
- noimages
在移动输出中禁用图片。
- 类型:布尔值(详细信息)
- mainpage
应用移动首页转换。
- 类型:布尔值(详细信息)
action=patrol
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
巡查页面或修订版本。
- rcid
要巡查的最近更改 ID。
- 类型:整数
- revid
要巡查的修订版本ID。
- 类型:整数
- tags
要在巡查日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- token
从action=query&meta=tokens取回的“patrol”令牌
- 这个参数是必须的。
action=protect
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
更改页面的保护等级。
- title
要(解除)保护的页面标题。不能与pageid一起使用。
- pageid
要(解除)保护的页面ID。不能与title一起使用。
- 类型:整数
- protections
保护等级列表,格式:action=level(例如edit=sysop)。等级all意味着任何人都可以执行操作,也就是说没有限制。
注意:未列出的操作将移除限制。
- 这个参数是必须的。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- expiry
到期时间戳。如果只有一个时间戳被设置,它将被用于所有保护。使用infinite、indefinite、infinity或never用于永不过期的保护。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 默认:infinite
- reason
(解除)保护的原因。
- 默认:(空)
- tags
要在保护日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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-or-later
为指定标题刷新缓存。
- forcelinkupdate
更新链接表。
- 类型:布尔值(详细信息)
- forcerecursivelinkupdate
更新链接表中,并更新任何使用此页作为模板的页面的链接表。
- 类型:布尔值(详细信息)
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- allcategories
- 列举所有分类。
- alldeletedrevisions
- 列举由一位用户或在一个名字空间中所有已删除的修订。
- allfileusages
- 列出所有文件用途,包括不存在的。
- allimages
- 按顺序枚举所有图像。
- alllinks
- 列举所有指向至指定名字空间的链接。
- allpages
- 循序列举在指定名字空间中的所有页面。
- allredirects
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、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-or-later
取得来自并有关MediaWiki的数据。
所有数据修改须首先使用查询来获得令牌,以阻止来自恶意网站的滥用行为。
- prop
要为已查询页面获取的属性。
- categories
- 页面属于的所有分类列表。
- categoryinfo
- 返回有关给定分类的信息。
- cirrusbuilddoc
- 来自数据库服务器的CirrusSearch条目文档的转储
- cirrusdoc
- 来自搜索服务器的CirrusSearch条目文档的转储
- contributors
- 获取对一个页面的登录贡献者列表和匿名贡献数。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- extlinks
- 从指定页面返回所有外部URL(非跨wiki链接)。
- extracts
- 返回指定页面的纯文本或有限的HTML页面内容提取物。
- fileusage
- 查找所有使用指定文件的页面。
- imageinfo
- 返回文件信息和上传历史。
- images
- 返回指定页面上包含的所有文件。
- info
- 获取基本页面信息。
- iwlinks
- 从指定页面返回所有跨wiki链接。
- langlinks
- 从指定页面返回所有跨语言链接。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- pageimages
- 返回页面上的图像的相关信息,例如缩略图和照片呈现信息。
- pageprops
- 获取页面内容中定义的各种页面属性。
- redirects
- 返回至指定页面的所有重定向。
- references
- 返回与指定页面相关联的参考文献的数据表示法。
- revisions
- 获取修订版本信息。
- stashimageinfo
- 返回用于藏匿文件的文件信息。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- flowinfo
- 已弃用。 获取有关页面的基本Flow信息。
- 值(以|或替代物分隔):categories、categoryinfo、cirrusbuilddoc、cirrusdoc、contributors、deletedrevisions、duplicatefiles、extlinks、extracts、fileusage、imageinfo、images、info、iwlinks、langlinks、links、linkshere、pageimages、pageprops、redirects、references、revisions、stashimageinfo、templates、transcludedin、flowinfo
- list
要获取的列表。
- allcategories
- 列举所有分类。
- alldeletedrevisions
- 列举由一位用户或在一个名字空间中所有已删除的修订。
- allfileusages
- 列出所有文件用途,包括不存在的。
- allimages
- 按顺序枚举所有图像。
- alllinks
- 列举所有指向至指定名字空间的链接。
- allpages
- 循序列举在指定名字空间中的所有页面。
- allredirects
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- allusers
- 列举所有注册用户。
- backlinks
- 查找所有链接至指定页面的页面。
- betafeatures
- 列出所有测试功能
- blocks
- 列出所有被封禁的用户和IP地址。
- categorymembers
- 在指定的分类中列出所有页面。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- filearchive
- 循序列举所有被删除的文件。
- gadgetcategories
- 返回小工具分类列表。
- gadgets
- 返回一个本Wiki上的小工具的列表。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- logevents
- 从日志获取事件。
- messagecollection
- 查询有关翻译的MessageCollection。
- mystashedfiles
- 获取当前用户上传暂存库中的文件列表。
- pagepropnames
- 列出wiki中所有使用中的页面属性名称。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- search
- 执行一次全文本搜索。
- tags
- 列出更改标签。
- usercontribs
- 获取一位用户的所有编辑。
- users
- 获取有关列出用户的信息。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- deletedrevs
- 已弃用。 列举删除的修订版本。
- 值(以|或替代物分隔):allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、allusers、backlinks、betafeatures、blocks、categorymembers、embeddedin、exturlusage、filearchive、gadgetcategories、gadgets、imageusage、iwbacklinks、langbacklinks、logevents、messagecollection、mystashedfiles、pagepropnames、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、search、tags、usercontribs、users、watchlist、watchlistraw、deletedrevs
- meta
要获取的元数据。
- allmessages
- 返回来自该网站的消息。
- authmanagerinfo
- 检索有关当前身份验证状态的信息。
- babel
- 获取有关用户可以理解语言的信息
- filerepoinfo
- 返回有关wiki配置的图片存储库的元信息。
- languagestats
- 查询语言状态。
- messagegroups
- 返回有关消息组的信息。
- messagegroupstats
- 查询信息组状态。
- messagetranslations
- 查询单个信息的所有翻译。
- notifications
- 获取当前用户等待的通知。
- oath
- 检查双因素验证(OATH)是否为某一用户启用。
- siteinfo
- 返回有关网站的一般信息。
- tokens
- 获取可修改数据的操作的令牌。
- unreadnotificationpages
- 获取当前用户未读通知的相关页面。
- userinfo
- 获取有关当前用户的信息。
- 值(以|或替代物分隔):allmessages、authmanagerinfo、babel、filerepoinfo、languagestats、messagegroups、messagegroupstats、messagetranslations、notifications、oath、siteinfo、tokens、unreadnotificationpages、userinfo
- indexpageids
包含一个额外的pageid段落,列举所有返回的页面ID。
- 类型:布尔值(详细信息)
- export
导出所有指定或生成页面的当前修订。
- 类型:布尔值(详细信息)
- exportnowrap
返回导出XML,不需要将其包裹在一个XML结果中(与Special:Export格式相同)。只能与query+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
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在query+titles、query+pageids和query+revids,以及在由query+generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、gan、iu、kk、ku、shi、sr、tg、uz和zh。
- 类型:布尔值(详细信息)
prop=categories (cl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
页面属于的所有分类列表。
- clprop
要为每个分类获取的额外属性:
- sortkey
- 为每个分类添加关键词(十六进制字符串)和关键词前缀(人类可读部分)。
- timestamp
- 添加分类添加时的时间戳。
- hidden
- 标记由
__HIDDENCAT__
隐藏的分类。
- 值(以|或替代物分隔):sortkey、timestamp、hidden
- clshow
显示何种分类。
- 值(以|或替代物分隔):hidden、!hidden
- cllimit
返回多少分类。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- clcontinue
当更多结果可用时,使用这个继续。
- clcategories
只列出这些分类。对于检查某一页面使用某一分类很有用。
- 通过|或替代物隔开各值。 值的最大数量是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-or-later
返回有关给定分类的信息。
- cicontinue
当更多结果可用时,使用这个继续。
- 获取有关Category:Foo和Category:Bar的信息。
- api.php?action=query&prop=categoryinfo&titles=Category:Foo|Category:Bar [在沙盒中打开]
prop=cirrusbuilddoc (cb)
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
来自数据库服务器的CirrusSearch条目文档的转储
- 获取生成自数据库的单个CirrusSearch条目的转储。
- api.php?action=query&prop=cirrusbuilddoc&titles=Main_Page [在沙盒中打开]
prop=cirrusdoc (cd)
- 此模块需要读取权限。
- 来源:CirrusSearch
- 许可协议:GPL-2.0-or-later
来自搜索服务器的CirrusSearch条目文档的转储
- 获取当前索引进搜索的单个CirrusSearch条目的转储。
- api.php?action=query&prop=cirrusdoc&titles=Main_Page [在沙盒中打开]
prop=contributors (pc)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取对一个页面的登录贡献者列表和匿名贡献数。
- pcgroup
只包括指定用户组中的用户。不包括隐性的或自动提升的用户组,例如*、用户或自动确认用户。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- pcexcludegroup
排除指定用户组中的用户。不包括隐性的或自动提升的用户组,例如*、用户或自动确认用户。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- pcrights
只包括拥有指定权限的用户。不包括隐性的或自动提升的用户组,例如*、用户或自动确认用户。
- 值(以|或替代物分隔):apihighlimits、applychangetags、autoconfirmed、autocreateaccount、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletechangetags、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjson、editmyuserjs、editmywatchlist、editsemiprotected、editsitecss、editsitejson、editsitejs、editusercss、edituserjson、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、patrol、patrolmarks、protect、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、gadgets-edit、gadgets-definition-edit、nuke、oathauth-enable、oathauth-api-all、oathauth-disable-for-user、renameuser、replacetext、spamblacklistlog、tboverride、tboverride-account、titleblacklistlog、flow-hide、flow-lock、flow-delete、flow-suppress、flow-edit-post、flow-create-board、translate、translate-import、translate-manage、translate-messagereview、translate-groupreview、pagetranslation、interwiki
- 值的最大数量是50(对于机器人则是500)。
- pcexcluderights
排除拥有指定权限的用户。不包括隐性的或自动提升的用户组,例如*、用户或自动确认用户。
- 值(以|或替代物分隔):apihighlimits、applychangetags、autoconfirmed、autocreateaccount、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletechangetags、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjson、editmyuserjs、editmywatchlist、editsemiprotected、editsitecss、editsitejson、editsitejs、editusercss、edituserjson、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、patrol、patrolmarks、protect、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、gadgets-edit、gadgets-definition-edit、nuke、oathauth-enable、oathauth-api-all、oathauth-disable-for-user、renameuser、replacetext、spamblacklistlog、tboverride、tboverride-account、titleblacklistlog、flow-hide、flow-lock、flow-delete、flow-suppress、flow-edit-post、flow-create-board、translate、translate-import、translate-manage、translate-messagereview、translate-groupreview、pagetranslation、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-or-later
获取删除的修订版本信息。
可在很多途径中使用:
- 获得一组页面的已删除修订,通过设置标题或页面ID。以标题和时间戳排序。
- 通过设置它们的ID与修订ID获得关于一组已删除修订。以修订ID排序。
- drvprop
要为每个修订获取的属性:
- ids
- 修订版本的ID。
- flags
- 修订标记(小编辑)。
- timestamp
- 修订的时间戳。
- user
- 做出修订的用户。
- userid
- 修订创建者的用户ID。
- size
- 修订的长度(字节)。
- slotsize
- 每次修订间隔的长度(字节)。
- sha1
- 修订的SHA-1(base 16)。
- slotsha1
- 每次修订间隔的SHA-1(base 16)。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 由用户对修订做出的摘要。
- parsedcomment
- 由用户对修订做出的被解析的摘要。
- content
- 每次修订间隔的内容。
- tags
- 修订标签。
- roles
- List content slot roles that exist in the revision.
- parsetree
- 已弃用。 请改用action=expandtemplates或action=parse。修订内容的XML解析树(需要内容模型
wikitext
)。
- 值(以|或替代物分隔):ids、flags、timestamp、user、userid、size、slotsize、sha1、slotsha1、contentmodel、comment、parsedcomment、content、tags、roles、parsetree
- 默认:ids|timestamp|flags|comment|user
- drvslots
Which revision slots to return data for, when slot-related properties are included in drvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- 值(以|或替代物分隔):main
- 要指定所有值,请使用*。
- drvlimit
限制返回多少修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- drvexpandtemplates
- 已弃用。
请改用action=expandtemplates。展开修订内容中的模板(需要drvprop=content)。
- 类型:布尔值(详细信息)
- drvgeneratexml
- 已弃用。
请改用action=expandtemplates或action=parse。生成用于修订内容的XML解析树(需要drvprop=content;被drvprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- drvparse
- 已弃用。
请改用action=parse。解析修订内容(需要drvprop=content)。由于性能原因,如果此选项被使用,drvlimit会被强制为1。
- 类型:布尔值(详细信息)
- drvsection
只检索此段落数的内容。
- drvdiffto
- 已弃用。
请改用action=compare。要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- drvdifftotext
- 已弃用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖drvdiffto。如果drvsection被设置,只有那个段落将与此文本之间比较差异
- drvdifftotextpst
- 已弃用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与drvdifftotext一起使用时有效。
- 类型:布尔值(详细信息)
- drvcontentformat
- 已弃用。
序列化用于drvdifftotext的格式并预估内容输出。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- drvstart
要开始枚举的时间戳。当处理修订ID列表时会被忽略。
- 类型:时间戳(允许格式)
- drvend
要停止枚举的时间戳。当处理修订ID列表时会被忽略。
- 类型:时间戳(允许格式)
- 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&drvslots=*&drvprop=user|comment|content [在沙盒中打开]
- 列出已删除修订123456的信息。
- api.php?action=query&prop=deletedrevisions&revids=123456 [在沙盒中打开]
prop=duplicatefiles (df)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
根据哈希值列出此给定文件的所有副本。
- dflimit
返回多少重复文件。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- dfcontinue
当更多结果可用时,使用这个继续。
- dfdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- dflocalonly
只看本地存储库的文件。
- 类型:布尔值(详细信息)
prop=extlinks (el)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从指定页面返回所有外部URL(非跨wiki链接)。
- ellimit
返回多少链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- elcontinue
当更多结果可用时,使用这个继续。
- 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=extracts (ex)
- 此模块需要读取权限。
- 来源:TextExtracts
- 许可协议:GPL-2.0-or-later
返回指定页面的纯文本或有限的HTML页面内容提取物。
- exchars
返回多少个字符。实际返回的文本可能比这稍长。
- 值必须介于1和1,200之间。
- 类型:整数
- exsentences
返回的句子数量。
- 值必须介于1和10之间。
- 类型:整数
- exlimit
要返回多少提取物。(多个提取物只能在exintro设置为真时返回。)
- 不允许超过20个(对于机器人则是20个)。
- 类型:整数或max
- 默认:20
- exintro
只返回在首个章节前的内容
- 类型:布尔值(详细信息)
- explaintext
返回提取物为纯文本而非HTML。
- 类型:布尔值(详细信息)
- exsectionformat
纯文本模式下如何格式化章节:
- plain
- 无格式。
- wiki
- Wiki文本样式的格式(== 像是这样 ==)。
- raw
- 此模块的内部表示方法(章节标题前缀<ASCII 1><ASCII 2><章节级别><ASCII 2><ASCII 1>)
- 以下值中的一个:plain、wiki、raw
- 默认:wiki
- excontinue
当更多结果可用时,使用这个继续。
- 类型:整数
prop=fileusage (fu)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有使用指定文件的页面。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- fushow
只显示符合以下标准的项:
- redirect
- 只显示重定向。
- !redirect
- 只显示非重定向。
- 值(以|或替代物分隔):redirect、!redirect
- fulimit
返回多少。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- fucontinue
当更多结果可用时,使用这个继续。
prop=flowinfo (fli)
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:Flow
- 许可协议:GPL-2.0-or-later
获取有关页面的基本Flow信息。
prop=imageinfo (ii)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回文件信息和上传历史。
- 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核心以外代码。
- badfile
- 无论文件是否在MediaWiki:Bad image list都添加
- 值(以|或替代物分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、mediatype、metadata、commonmetadata、extmetadata、archivename、bitdepth、uploadwarning、badfile
- 默认: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的语言。这会影响到抓取翻译的选择,如果有多个可用的话,还会影响到数字等数值的格式。
- 默认:zh
- iiextmetadatamultilang
如果用于extmetadata属性的翻译可用,则全部取得。
- 类型:布尔值(详细信息)
- iiextmetadatafilter
如果指定且非空,则只为iiprop=extmetadata返回这些键。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- iiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。iiurlwidth必须被使用,并与iiurlparam一致。
- 默认:(空)
- iibadfilecontexttitle
如果badfilecontexttitleprop=badfile被设置,这会是在评估MediaWiki:Bad image list时使用的页面标题
- iicontinue
当更多结果可用时,使用这个继续。
- iilocalonly
只看本地存储库的文件。
- 类型:布尔值(详细信息)
prop=images (im)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回指定页面上包含的所有文件。
- imlimit
返回多少文件。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- imcontinue
当更多结果可用时,使用这个继续。
- imimages
只列出这些文件。对于检查某一页面是否使用某一文件很有用。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- imdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
prop=info (in)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取基本页面信息。
- inprop
要获取的额外属性:
- protection
- 列出每个页面的保护等级。
- talkid
- 每个非讨论页面的讨论页的页面ID。
- watched
- 列出每个页面的被监视状态。
- watchers
- 监视人员数,如果允许。
- visitingwatchers
- 访问了每个页面的最近编辑的监视者数量,如果允许。
- notificationtimestamp
- 每个页面的监视列表通知时间戳。
- subjectid
- 每个讨论页的母页面的页面ID。
- url
- 为每个页面提供一个完整URL、一个编辑URL和规范URL。
- readable
- 已弃用。 用户是否可以阅读此页面。
- preload
- 提供由EditFormPreloadText返回的文本。
- displaytitle
- 在页面标题实际显示的地方提供方式。
- varianttitles
- 提供网站内容语言所有变体的显示标题。
- 值(以|或替代物分隔):protection、talkid、watched、watchers、visitingwatchers、notificationtimestamp、subjectid、url、readable、preload、displaytitle、varianttitles
- intestactions
测试当前用户是否可以在页面上执行某种操作。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- intestactionsdetail
Detail level for intestactions. Use the main module's errorformat and errorlang parameters to control the format of the messages returned.
- boolean
- Return a boolean value for each action.
- full
- Return messages describing why the action is disallowed, or an empty array if it is allowed.
- quick
- Like full but skipping expensive checks.
- 以下值中的一个:boolean、full、quick
- 默认:boolean
- 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-or-later
从指定页面返回所有跨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-or-later
从指定页面返回所有跨语言链接。
- llprop
要为每个跨语言链接获取的额外属性:
- url
- 添加完整URL。
- langname
- 添加本地化语言名(尽可能)。使用llinlanguagecode以控制语言。
- autonym
- 添加本地语言名。
- 值(以|或替代物分隔):url、langname、autonym
- lllang
只返回带此语言代码的语言链接。
- lltitle
要搜索的链接。必须与lllang一起使用。
- lldir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- llinlanguagecode
本地化语言名称的语言代码。
- 默认:zh
- 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-or-later
从指定页面返回所有链接。
- plnamespace
只显示这些名字空间的链接。
- 值(以|或替代物分隔):-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- pllimit
返回多少链接。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- plcontinue
当更多结果可用时,使用这个继续。
- pltitles
只列出这些标题。对于检查某一页面是否使用某一标题很有用。
- 通过|或替代物隔开各值。 值的最大数量是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 [在沙盒中打开]
- 获取在User和Template名字空间中来自页面Main Page的链接。
- api.php?action=query&prop=links&titles=Main%20Page&plnamespace=2|10 [在沙盒中打开]
prop=linkshere (lh)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有链接至指定页面的页面。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- lhshow
只显示符合以下标准的项:
- redirect
- 只显示重定向。
- !redirect
- 只显示非重定向。
- 值(以|或替代物分隔):redirect、!redirect
- lhlimit
返回多少。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- lhcontinue
当更多结果可用时,使用这个继续。
prop=pageimages (pi)
- 此模块需要读取权限。
- 来源:PageImages
- 许可协议:WTFPL
返回页面上的图像的相关信息,例如缩略图和照片呈现信息。
- piprop
返回哪些信息:
- thumbnail
- 与页面相关联的缩略图图像URL及其尺寸,如有。
- original
- 与页面相关联的图像URL及其原始尺寸,如有。
- name
- 图像标题。
- 值(以|或替代物分隔):thumbnail、name、original
- 默认:thumbnail|name
- pithumbsize
缩略图的最大宽度(像素)。
- 类型:整数
- 默认:50
- pilimit
返回的页面数的属性。
- 不允许超过50个(对于机器人则是100个)。
- 类型:整数或max
- 默认:50
- pilicense
限制页面图片至特定的许可协议类型
- 以下值中的一个:free、any
- 默认:free
- picontinue
当更多结果可用时,使用这个继续。
- 类型:整数
- 获取Albert Einstein页面中一张图片的名称及其100像素大小的缩略图。
- api.php?action=query&prop=pageimages&titles=Albert%20Einstein&pithumbsize=100 [在沙盒中打开]
prop=pageprops (pp)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取页面内容中定义的各种页面属性。
- ppcontinue
当更多结果可用时,使用这个继续。
- ppprop
只列出这些页面属性(action=query&list=pagepropnames返回使用中的页面属性名称)。在检查页面是否使用某一页面属性时有用。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 获取用于页面Main Page和MediaWiki的属性。
- api.php?action=query&prop=pageprops&titles=Main%20Page|MediaWiki [在沙盒中打开]
prop=redirects (rd)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回至指定页面的所有重定向。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- rdshow
只显示符合这些标准的项目:
- fragment
- 只显示带碎片的重定向。
- !fragment
- 只显示不带碎片的重定向。
- 值(以|或替代物分隔):fragment、!fragment
- rdlimit
返回多少重定向。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- rdcontinue
当更多结果可用时,使用这个继续。
prop=references (rf)
- 此模块需要读取权限。
- 来源:Cite
- 许可协议:GPL-2.0-or-later
返回与指定页面相关联的参考文献的数据表示法。
- rfcontinue
当更多结果可用时,使用这个继续。
- 与Albert Einstein相关联的参考文献。
- api.php?action=query&prop=references&titles=Albert%20Einstein [在沙盒中打开]
prop=revisions (rv)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取修订版本信息。
可用于以下几个方面:
- 通过设置标题或页面ID获取一批页面(最新修订)的数据。
- 通过使用带start、end或limit的标题或页面ID获取给定页面的多个修订。
- 通过revid设置一批修订的ID获取它们的数据。
- rvprop
要为每个修订获取的属性:
- ids
- 修订版本的ID。
- flags
- 修订标记(小编辑)。
- timestamp
- 修订的时间戳。
- user
- 做出修订的用户。
- userid
- 修订创建者的用户ID。
- size
- 修订的长度(字节)。
- slotsize
- 每次修订间隔的长度(字节)。
- sha1
- 修订的SHA-1(base 16)。
- slotsha1
- 每次修订间隔的SHA-1(base 16)。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 由用户对修订做出的摘要。
- parsedcomment
- 由用户对修订做出的被解析的摘要。
- content
- 每次修订间隔的内容。
- tags
- 修订标签。
- roles
- List content slot roles that exist in the revision.
- parsetree
- 已弃用。 请改用action=expandtemplates或action=parse。修订内容的XML解析树(需要内容模型
wikitext
)。
- 值(以|或替代物分隔):ids、flags、timestamp、user、userid、size、slotsize、sha1、slotsha1、contentmodel、comment、parsedcomment、content、tags、roles、parsetree
- 默认:ids|timestamp|flags|comment|user
- rvslots
Which revision slots to return data for, when slot-related properties are included in rvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- 值(以|或替代物分隔):main
- 要指定所有值,请使用*。
- rvlimit
限制返回多少修订。
- 只能在单一页面模式中使用(模式#2)。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- rvexpandtemplates
- 已弃用。
请改用action=expandtemplates。展开修订内容中的模板(需要rvprop=content)。
- 类型:布尔值(详细信息)
- rvgeneratexml
- 已弃用。
请改用action=expandtemplates或action=parse。生成用于修订内容的XML解析树(需要rvprop=content;被rvprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- rvparse
- 已弃用。
请改用action=parse。解析修订内容(需要rvprop=content)。由于性能原因,如果此选项被使用,rvlimit会被强制为1。
- 类型:布尔值(详细信息)
- rvsection
只检索此段落数的内容。
- rvdiffto
- 已弃用。
请改用action=compare。要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- rvdifftotext
- 已弃用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖rvdiffto。如果rvsection被设置,只有那个段落将与此文本之间比较差异
- rvdifftotextpst
- 已弃用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与rvdifftotext一起使用时有效。
- 类型:布尔值(详细信息)
- rvcontentformat
- 已弃用。
序列化用于rvdifftotext的格式并预估内容输出。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- rvstartid
从这个修订版本时间戳开始列举。修订版本必须存在,但未必与该页面相关。
- 只能在单一页面模式中使用(模式#2)。
- 类型:整数
- rvendid
在这个修订版本时间戳停止列举。修订版本必须存在,但未必与该页面相关。
- 只能在单一页面模式中使用(模式#2)。
- 类型:整数
- rvstart
从哪个修订版本时间戳开始列举。
- 只能在单一页面模式中使用(模式#2)。
- 类型:时间戳(允许格式)
- rvend
列举直至此时间戳。
- 只能在单一页面模式中使用(模式#2)。
- 类型:时间戳(允许格式)
- rvdir
列举的方向:
- newer
- 最早的优先。注意:rvstart应早于rvend。
- older
- 最新的优先(默认)。注意:rvstart应晚于rvend。
- 只能在单一页面模式中使用(模式#2)。
- 以下值中的一个:newer、older
- 默认:older
- rvuser
只包含由用户做出的修订。
- 只能在单一页面模式中使用(模式#2)。
- 类型:用户名
- rvexcludeuser
不包括由用户做出的修订。
- 只能在单一页面模式中使用(模式#2)。
- 类型:用户名
- rvtag
只列出被此标签标记的修订。
- rvtoken
- 已弃用。
要为每个修订版本获得的令牌。
- 值(以|或替代物分隔):rollback
- rvcontinue
当更多结果可用时,使用这个继续。
- 获取带内容的数据,用于标题API和Main Page的最近修订。
- api.php?action=query&prop=revisions&titles=API|Main%20Page&rvslots=*&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-or-later
返回用于藏匿文件的文件信息。
- siifilekey
用于识别一次临时藏匿的早前上传的关键字。
- 通过|或替代物隔开各值。 值的最大数量是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
- 添加修订的字节深度。
- badfile
- 无论文件是否在MediaWiki:Bad image list都添加
- 值(以|或替代物分隔):timestamp、canonicaltitle、url、size、dimensions、sha1、mime、thumbmime、metadata、commonmetadata、extmetadata、bitdepth、badfile
- 默认:timestamp|url
- siiurlwidth
如果siiprop=url被设定,将返回至缩放到此宽度的一张图片的URL。 由于性能原因,如果此消息被使用,将不会返回超过50张被缩放的图片。
- 类型:整数
- 默认:-1
- siiurlheight
与siiurlwidth类似。
- 类型:整数
- 默认:-1
- siiurlparam
处理器特定的参数字符串。例如PDF可能使用page15-100px。siiurlwidth必须被使用,并与siiurlparam一致。
- 默认:(空)
prop=templates (tl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回指定页面上所有被嵌入的页面。
- tlnamespace
只显示此名字空间的模板。
- 值(以|或替代物分隔):-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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 [在沙盒中打开]
- 获取在User和Template名字空间中,嵌入在Main Page页面的页面。
- api.php?action=query&prop=templates&titles=Main%20Page&tlnamespace=2|10 [在沙盒中打开]
prop=transcludedin (ti)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有嵌入指定页面的页面。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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-or-later
列举所有分类。
- 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-or-later
列举由一位用户或在一个名字空间中所有已删除的修订。
- adrprop
要为每个修订获取的属性:
- ids
- 修订版本的ID。
- flags
- 修订标记(小编辑)。
- timestamp
- 修订的时间戳。
- user
- 做出修订的用户。
- userid
- 修订创建者的用户ID。
- size
- 修订的长度(字节)。
- slotsize
- 每次修订间隔的长度(字节)。
- sha1
- 修订的SHA-1(base 16)。
- slotsha1
- 每次修订间隔的SHA-1(base 16)。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 由用户对修订做出的摘要。
- parsedcomment
- 由用户对修订做出的被解析的摘要。
- content
- 每次修订间隔的内容。
- tags
- 修订标签。
- roles
- List content slot roles that exist in the revision.
- parsetree
- 已弃用。 请改用action=expandtemplates或action=parse。修订内容的XML解析树(需要内容模型
wikitext
)。
- 值(以|或替代物分隔):ids、flags、timestamp、user、userid、size、slotsize、sha1、slotsha1、contentmodel、comment、parsedcomment、content、tags、roles、parsetree
- 默认:ids|timestamp|flags|comment|user
- adrslots
Which revision slots to return data for, when slot-related properties are included in adrprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- 值(以|或替代物分隔):main
- 要指定所有值,请使用*。
- adrlimit
限制返回多少修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- adrexpandtemplates
- 已弃用。
请改用action=expandtemplates。展开修订内容中的模板(需要adrprop=content)。
- 类型:布尔值(详细信息)
- adrgeneratexml
- 已弃用。
请改用action=expandtemplates或action=parse。生成用于修订内容的XML解析树(需要adrprop=content;被adrprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- adrparse
- 已弃用。
请改用action=parse。解析修订内容(需要adrprop=content)。由于性能原因,如果此选项被使用,adrlimit会被强制为1。
- 类型:布尔值(详细信息)
- adrsection
只检索此段落数的内容。
- adrdiffto
- 已弃用。
请改用action=compare。要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- adrdifftotext
- 已弃用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖adrdiffto。如果adrsection被设置,只有那个段落将与此文本之间比较差异
- adrdifftotextpst
- 已弃用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与adrdifftotext一起使用时有效。
- 类型:布尔值(详细信息)
- adrcontentformat
- 已弃用。
序列化用于adrdifftotext的格式并预估内容输出。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- adruser
只列出此用户做出的修订。
- 类型:用户名
- adrnamespace
只列出此名字空间的页面。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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&adrnamespace=0&adrlimit=50 [在沙盒中打开]
list=allfileusages (af)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出所有文件用途,包括不存在的。
- 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-or-later
按顺序枚举所有图像。
- 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
- 添加修订的字节深度。
- badfile
- 无论文件是否在MediaWiki:Bad image list都添加
- 值(以|或替代物分隔):timestamp、user、userid、comment、parsedcomment、canonicaltitle、url、size、dimensions、sha1、mime、mediatype、metadata、commonmetadata、extmetadata、bitdepth、badfile
- 默认: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-or-later
列举所有指向至指定名字空间的链接。
- alcontinue
当更多结果可用时,使用这个继续。
- alfrom
要列举的起始标题链接。
- alto
要列举的最终标题链接。
- alprefix
搜索所有以此值开头的已链接标题。
- alunique
只显示明显的链接标题。不能与alprop=ids一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- alprop
要包含的信息束:
- ids
- 添加链接中的页面的页面ID(不能与alunique一起使用)。
- title
- 添加链接的标题。
- 值(以|或替代物分隔):ids、title
- 默认:title
- alnamespace
要列举的名字空间。
- 以下值中的一个:-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 默认: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-or-later
循序列举在指定名字空间中的所有页面。
- apfrom
枚举的起始页面标题。
- apcontinue
当更多结果可用时,使用这个继续。
- apto
枚举的结束页面标题。
- apprefix
搜索所有以此值开头的页面标题。
- apnamespace
要列举的名字空间。
- 以下值中的一个:0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 默认:0
- apfilterredir
要列出哪些页面。
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- apminsize
限于至少这么多字节的页面。
- 类型:整数
- apmaxsize
限于至多这么多字节的页面。
- 类型:整数
- apprtype
仅限于受保护页面。
- 值(以|或替代物分隔):edit、move、upload
- apprlevel
过滤基于保护等级的保护(必须与apprtype=参数一起使用)。
- 值(以|或替代物分隔):可以为空,或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
- 显示以字母B开头的页面的列表。
- api.php?action=query&list=allpages&apfrom=B [在沙盒中打开]
- 显示有关4个以字母T开头的页面的信息。
- api.php?action=query&generator=allpages&gaplimit=4&gapfrom=T&prop=info [在沙盒中打开]
- 显示前2个以Re开头的非重定向页面的内容。
- api.php?action=query&generator=allpages&gaplimit=2&gapfilterredir=nonredirects&gapfrom=Re&prop=revisions&rvprop=content [在沙盒中打开]
list=allredirects (ar)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出至一个名字空间的重定向。
- 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
要列举的名字空间。
- 以下值中的一个:-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 默认:0
- arlimit
返回的总计项目数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ardir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- 列举目标页面,包含丢失的页面、它们来自的页面ID,以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=allrevisions (arv)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列举所有修订。
- arvprop
要为每个修订获取的属性:
- ids
- 修订版本的ID。
- flags
- 修订标记(小编辑)。
- timestamp
- 修订的时间戳。
- user
- 做出修订的用户。
- userid
- 修订创建者的用户ID。
- size
- 修订的长度(字节)。
- slotsize
- 每次修订间隔的长度(字节)。
- sha1
- 修订的SHA-1(base 16)。
- slotsha1
- 每次修订间隔的SHA-1(base 16)。
- contentmodel
- 每次修订间隔的内容模型ID。
- comment
- 由用户对修订做出的摘要。
- parsedcomment
- 由用户对修订做出的被解析的摘要。
- content
- 每次修订间隔的内容。
- tags
- 修订标签。
- roles
- List content slot roles that exist in the revision.
- parsetree
- 已弃用。 请改用action=expandtemplates或action=parse。修订内容的XML解析树(需要内容模型
wikitext
)。
- 值(以|或替代物分隔):ids、flags、timestamp、user、userid、size、slotsize、sha1、slotsha1、contentmodel、comment、parsedcomment、content、tags、roles、parsetree
- 默认:ids|timestamp|flags|comment|user
- arvslots
Which revision slots to return data for, when slot-related properties are included in arvprops. If omitted, data from the main slot will be returned in a backwards-compatible format.
- 值(以|或替代物分隔):main
- 要指定所有值,请使用*。
- arvlimit
限制返回多少修订。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- arvexpandtemplates
- 已弃用。
请改用action=expandtemplates。展开修订内容中的模板(需要arvprop=content)。
- 类型:布尔值(详细信息)
- arvgeneratexml
- 已弃用。
请改用action=expandtemplates或action=parse。生成用于修订内容的XML解析树(需要arvprop=content;被arvprop=parsetree所取代)。
- 类型:布尔值(详细信息)
- arvparse
- 已弃用。
请改用action=parse。解析修订内容(需要arvprop=content)。由于性能原因,如果此选项被使用,arvlimit会被强制为1。
- 类型:布尔值(详细信息)
- arvsection
只检索此段落数的内容。
- arvdiffto
- 已弃用。
请改用action=compare。要比较修订差异的修订ID。使用prev、next和cur分别用于上个、下个和当前修订。
- arvdifftotext
- 已弃用。
请改用action=compare。要比较修订差异的文本。只有修订的有限数字内的差异。覆盖arvdiffto。如果arvsection被设置,只有那个段落将与此文本之间比较差异
- arvdifftotextpst
- 已弃用。
请改用action=compare。在编辑文本前对其执行预保存转换。只当与arvdifftotext一起使用时有效。
- 类型:布尔值(详细信息)
- arvcontentformat
- 已弃用。
序列化用于arvdifftotext的格式并预估内容输出。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- arvuser
只列出此用户做出的修订。
- 类型:用户名
- arvnamespace
只列出此名字空间的页面。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- arvstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- arvend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- arvdir
列举的方向:
- newer
- 最早的优先。注意:arvstart应早于arvend。
- older
- 最新的优先(默认)。注意:arvstart应晚于arvend。
- 以下值中的一个:newer、older
- 默认:older
- arvexcludeuser
不要列出此用户做出的修订。
- 类型:用户名
- arvcontinue
当更多结果可用时,使用这个继续。
- arvgeneratetitles
当作为生成器使用时,生成标题而不是修订ID。
- 类型:布尔值(详细信息)
- 列出由用户Example作出的最近50次贡献。
- api.php?action=query&list=allrevisions&arvuser=Example&arvlimit=50 [在沙盒中打开]
- 列举主名字空间中的前50次修订。
- api.php?action=query&list=allrevisions&arvdir=newer&arvlimit=50 [在沙盒中打开]
list=alltransclusions (at)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- atcontinue
当更多结果可用时,使用这个继续。
- atfrom
要列举的起始嵌入标题。
- atto
要列举的最终嵌入标题。
- atprefix
搜索所有以此值开头的嵌入的标题。
- atunique
只显示明显的被嵌入标题。不能与atprop=ids一起使用。 当作为生成器使用时,产生目标页面而不是来源页面。
- 类型:布尔值(详细信息)
- atprop
要包含的信息束:
- ids
- 添加嵌入中的页面的页面ID(不能与atunique一起使用)。
- title
- 添加嵌入的标题。
- 值(以|或替代物分隔):ids、title
- 默认:title
- atnamespace
要列举的名字空间。
- 以下值中的一个:-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 默认: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-or-later
列举所有注册用户。
- aufrom
枚举的起始用户名。
- auto
枚举的结束用户名。
- auprefix
搜索所有以此值开头的用户。
- audir
排序方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- augroup
只包含指定组中的用户。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- auexcludegroup
排除指定组中的用户。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- aurights
仅列出有所选权限的用户。不包括隐性的或自动加入的用户组别(如*、用户或自动确认用户)所授予的权限。
- 值(以|或替代物分隔):apihighlimits、applychangetags、autoconfirmed、autocreateaccount、autopatrol、bigdelete、block、blockemail、bot、browsearchive、changetags、createaccount、createpage、createtalk、delete、deletechangetags、deletedhistory、deletedtext、deletelogentry、deleterevision、edit、editcontentmodel、editinterface、editprotected、editmyoptions、editmyprivateinfo、editmyusercss、editmyuserjson、editmyuserjs、editmywatchlist、editsemiprotected、editsitecss、editsitejson、editsitejs、editusercss、edituserjson、edituserjs、hideuser、import、importupload、ipblock-exempt、managechangetags、markbotedits、mergehistory、minoredit、move、movefile、move-categorypages、move-rootuserpages、move-subpages、nominornewtalk、noratelimit、override-export-depth、pagelang、patrol、patrolmarks、protect、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、gadgets-edit、gadgets-definition-edit、nuke、oathauth-enable、oathauth-api-all、oathauth-disable-for-user、renameuser、replacetext、spamblacklistlog、tboverride、tboverride-account、titleblacklistlog、flow-hide、flow-lock、flow-delete、flow-suppress、flow-edit-post、flow-create-board、translate、translate-import、translate-manage、translate-messagereview、translate-groupreview、pagetranslation、interwiki
- 值的最大数量是50(对于机器人则是500)。
- auprop
要包含的信息束:
- blockinfo
- 添加有关用户当前封禁的信息。
- groups
- 列举用户所在的组。这使用更多服务器资源,并可能返回少于限制的结果。
- implicitgroups
- 列出用户自动属于的所有组。
- rights
- 用户拥有的权限列表。
- editcount
- 添加用户的编辑计数。
- registration
- 如果可能,添加用户注册时的时间戳(可能为空白)。
- centralids
- 添加中心ID并为用户附加状态。
- 值(以|或替代物分隔):blockinfo、groups、implicitgroups、rights、editcount、registration、centralids
- aulimit
返回的总计用户数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- auwitheditsonly
只列出有编辑的用户。
- 类型:布尔值(详细信息)
- auactiveusers
只列出最近30天内活跃的用户。
- 类型:布尔值(详细信息)
- auattachedwiki
与auprop=centralids一起使用,也表明用户是否附加于此ID定义的wiki。
list=backlinks (bl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有链接至指定页面的页面。
- bltitle
要搜索的标题。不能与blpageid一起使用。
- blpageid
要搜索的页面ID。不能与bltitle一起使用。
- 类型:整数
- blcontinue
当更多结果可用时,使用这个继续。
- blnamespace
要列举的名字空间。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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=betafeatures (bf)
- 此模块需要读取权限。
- 来源:BetaFeatures
- 许可协议:GPL-2.0-or-later
列出所有测试功能
- bfcounts
是否取得有多少用户启用了特定的设置分项。
- 获取所有可用测试功能,并显示启用它们的用户数量
- api.php?action=query&list=betafeatures&bfcounts= [在沙盒中打开]
list=blocks (bk)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出所有被封禁的用户和IP地址。
- bkstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- bkend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- bkdir
列举的方向:
- newer
- 最早的优先。注意:bkstart应早于bkend。
- older
- 最新的优先(默认)。注意:bkstart应晚于bkend。
- 以下值中的一个:newer、older
- 默认:older
- bkids
要列出的封禁ID列表(可选)。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- bkusers
要搜索的用户列表(可选)。
- 类型:用户名列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- bkip
获取应用到此IP地址或者CIDR范围的所有封禁,包括范围封禁。不能与bkusers一起使用。CIDR范围不允许比IPv4/16或IPv6/19更宽。
- bklimit
封禁列表的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- bkprop
要获取的属性:
- id
- 添加封禁ID。
- user
- 添加被封禁用户的用户名。
- userid
- 添加被封禁用户的用户ID。
- by
- 添加执行封禁的用户的用户名。
- byid
- 添加执行封禁的用户的用户ID。
- timestamp
- 添加封禁生效时的时间戳。
- expiry
- 添加封禁截止时的时间戳。
- reason
- 添加封禁原因。
- range
- 添加受封禁影响的IP地址段。
- flags
- 标记编辑禁止(自动封禁、仅限匿名用户等)。
- restrictions
- Adds the partial block restrictions if the block is not sitewide.
- 值(以|或替代物分隔):id、user、userid、by、byid、timestamp、expiry、reason、range、flags、restrictions
- 默认:id|user|by|timestamp|expiry|reason|flags
- bkshow
只显示符合这些标准的项目。 例如,要只查看IP地址的无限期封禁,设置bkshow=ip|!temp。
- 值(以|或替代物分隔):account、!account、temp、!temp、ip、!ip、range、!range
- bkcontinue
当更多结果可用时,使用这个继续。
list=categorymembers (cm)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
在指定的分类中列出所有页面。
- cmtitle
要列举的分类(必需)。必须包括Category:前缀。不能与cmpageid一起使用。
- cmpageid
要枚举的分类的页面 ID。不能与cmtitle一起使用。
- 类型:整数
- cmprop
要包含的信息束:
- ids
- 添加页面ID。
- title
- 添加页面标题和名字空间ID。
- sortkey
- 添加用于分类中排序的关键字(十六进制字符串)。
- sortkeyprefix
- 添加用于分类中排序的关键字前缀(关键字的人类可读部分)。
- type
- 添加页面被分类的类型(page、subcat或file)。
- timestamp
- 添加页面被包括时的时间戳。
- 值(以|或替代物分隔):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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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
要结束列举before的关键字前缀(而不是at;如果此值出现,它将不被包括!)只能与cmsort=sortkey一起使用。覆盖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-or-later
列举删除的修订版本。
操作于三种模式中:
- 为指定标题列举已删除修订,按时间戳排列。
- 为指定用户列举已删除贡献,按时间戳排列(未指定标题)。
- 在指定名字空间中列举所有已删除修订,按标题和时间戳排列(无指定标题,未设置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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 默认: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
要列出的最大修订数量。
- 不允许超过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次Talk名字空间已删除页面(模式3)。
- api.php?action=query&list=deletedrevs&drdir=newer&drlimit=50&drnamespace=1&drunique= [在沙盒中打开]
list=embeddedin (ei)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有嵌入指定标题的页面。
- eititle
要搜索的标题。不能与eipageid一起使用。
- eipageid
要搜索的页面ID。不能与eititle一起使用。
- 类型:整数
- eicontinue
当更多结果可用时,使用这个继续。
- einamespace
列举的名字空间。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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-or-later
列举包含一个指定URL的页面。
- euprop
要包含的信息束:
- ids
- 添加页面ID。
- title
- 添加页面的标题和名字空间ID。
- url
- 添加页面中使用的URL。
- 值(以|或替代物分隔):ids、title、url
- 默认:ids|title|url
- eucontinue
当更多结果可用时,使用这个继续。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- eulimit
返回多少页面。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- euexpandurl
用标准协议展开协议相关URL。
- 类型:布尔值(详细信息)
list=filearchive (fa)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
循序列举所有被删除的文件。
- 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
当更多结果可用时,使用这个继续。
list=gadgetcategories (gc)
- 此模块需要读取权限。
- 来源:Gadgets
- 许可协议:GPL-2.0-or-later
返回小工具分类列表。
- 获取现有小工具分类的列表
- api.php?action=query&list=gadgetcategories [在沙盒中打开]
- 获取所有有关名称为“foo”和“bar”的分类的信息
- api.php?action=query&list=gadgetcategories&gcnames=foo|bar&gcprop=name|title|members [在沙盒中打开]
list=gadgets (ga)
- 此模块需要读取权限。
- 来源:Gadgets
- 许可协议:GPL-2.0-or-later
返回一个本Wiki上的小工具的列表。
- gaprop
要获取的小工具信息:
- id
- 内部小工具ID。
- metadata
- 小工具元数据。
- desc
- 小工具说明转换成HTML(较慢,只在需要的时候使用)。
- 值(以|或替代物分隔):id、metadata、desc
- 默认:id|metadata
- gacategories
来自要检索的分类的小工具。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- gaids
要检索的小工具ID。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- gaallowedonly
只列出允许当前用户使用的小工具。
- 类型:布尔值(详细信息)
- gaenabledonly
只列出当前用户启用的小工具。
- 类型:布尔值(详细信息)
- 获取小工具列表,连带它们的说明
- api.php?action=query&list=gadgets&gaprop=id|desc [在沙盒中打开]
- 获取含全部可能属性的小工具列表
- api.php?action=query&list=gadgets&gaprop=id|metadata|desc [在沙盒中打开]
- 获取属于分类“foo”的小工具列表
- api.php?action=query&list=gadgets&gacategories=foo [在沙盒中打开]
- 获取有关小工具“foo”和“bar”的信息
- api.php?action=query&list=gadgets&gaids=foo|bar&gaprop=id|desc|metadata [在沙盒中打开]
- 获取当前用户启用的小工具列表
- api.php?action=query&list=gadgets&gaenabledonly [在沙盒中打开]
list=imageusage (iu)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有使用指定图片标题的页面。
- iutitle
要搜索的标题。不能与iupageid一起使用。
- iupageid
要搜索的页面ID。不能与iutitle一起使用。
- 类型:整数
- iucontinue
当更多结果可用时,使用这个继续。
- iunamespace
要列举的名字空间。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- iudir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- iufilterredir
如何过滤重定向。当iuredirect被启用时如果设置为nonredirects,这只会应用到第二级。
- 以下值中的一个:all、redirects、nonredirects
- 默认:all
- iulimit
返回总计页面数。如果iuredirect被启用,则限定分别适用于每一等级(这意味着将返回多达2 * iulimit个结果)。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- iuredirect
如果链接页面是重定向,则查找所有链接至该重定向的页面。最大限制减半。
- 类型:布尔值(详细信息)
list=iwbacklinks (iwbl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
查找所有链接至指定跨wiki链接的页面。
可用于查找所有有前缀的链接,或是链至某一标题的所有链接(带指定前缀)。两参数均不使用实际上就是“all interwiki links”。
- iwblprefix
跨wiki前缀。
- 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-or-later
查找所有链接至指定语言链接的页面。
可被用于查找所有带某一语言代码的链接,或所有至某一标题的链接(带指定语言)。不使用任何参数就意味着“all language links”。
注意这可能不考虑由扩展添加的语言链接。
- 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-or-later
从日志获取事件。
- 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
过滤日志记录至仅限此类型。
- 以下值中的一个:可以为空,或renameuser、spamblacklist、titleblacklist、translationreview、block、protect、rights、delete、upload、move、import、patrol、merge、suppress、tag、managetags、contentmodel、pagetranslation、newusers、create、interwiki
- leaction
过滤日志操作为仅限此操作。覆盖letype。在可用值列表中,带星号通配符的值例如action/*可在斜线(/)后拥有不同字符串。
- 以下值中的一个:block/block、block/reblock、block/unblock、contentmodel/change、contentmodel/new、create/create、delete/delete、delete/delete_redir、delete/event、delete/flow-delete-post、delete/flow-delete-topic、delete/flow-restore-post、delete/flow-restore-topic、delete/restore、delete/revision、import/interwiki、import/lqt-to-flow-topic、import/upload、interwiki/*、lock/flow-lock-topic、lock/flow-restore-topic、managetags/activate、managetags/create、managetags/deactivate、managetags/delete、merge/merge、move/move、move/move_redir、newusers/autocreate、newusers/byemail、newusers/create、newusers/create2、newusers/newusers、pagetranslation/associate、pagetranslation/deletefnok、pagetranslation/deletefok、pagetranslation/deletelnok、pagetranslation/deletelok、pagetranslation/discourage、pagetranslation/dissociate、pagetranslation/encourage、pagetranslation/mark、pagetranslation/movenok、pagetranslation/moveok、pagetranslation/prioritylanguages、pagetranslation/unmark、patrol/autopatrol、patrol/patrol、protect/modify、protect/move_prot、protect/protect、protect/unprotect、renameuser/renameuser、rights/autopromote、rights/rights、spamblacklist/*、suppress/block、suppress/delete、suppress/event、suppress/flow-restore-post、suppress/flow-restore-topic、suppress/flow-suppress-post、suppress/flow-suppress-topic、suppress/reblock、suppress/revision、tag/update、titleblacklist/*、translationreview/group、translationreview/message、upload/overwrite、upload/revert、upload/upload
- lestart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- leend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- ledir
列举的方向:
- newer
- 最早的优先。注意:lestart应早于leend。
- older
- 最新的优先(默认)。注意:lestart应晚于leend。
- 以下值中的一个:newer、older
- 默认:older
- leuser
过滤记录为这些由指定用户做出的。
- 类型:用户名
- letitle
过滤记录至这些与页面相关的。
- lenamespace
过滤事件为在这些指定的名字空间中。
- 以下值中的一个:-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- leprefix
过滤以此前缀开头的记录。
- letag
只列举带此标签的事件日志记录。
- lelimit
返回的事件日志记录总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- lecontinue
当更多结果可用时,使用这个继续。
list=messagecollection (mc)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
查询有关翻译的MessageCollection。
- mcgroup
信息组。
- 这个参数是必须的。
- mclanguage
语言代码。
- 默认:en
- mclimit
显示的消息数量(过滤后)。
- 不允许超过5,000个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:500
- mcoffset
当更多结果可用时,使用这个继续。
- 默认:(空)
- mcfilter
消息集合过滤器。使用!否定条件。例如!fuzzy意思是只列出所有未过期消息。过滤器以特定顺序应用。
- fuzzy
- 带fuzzy标签的消息。
- optional
- 只应在需要更改时翻译的消息。
- ignored
- 不应翻译的消息。
- hastranslation
- 无论过期与否,带翻译的消息。
- translated
- 带有未过期翻译的消息。
- changed
- 自从上次导出之日起,已翻译或更改的消息。
- reviewer:N
- 当用户数字N在复核者之间时的消息。
- last-translator:N
- 当用户数字N是最终翻译者时的消息。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 默认:!optional|!ignored
- mcprop
要获取的属性:
- definition
- 信息定义。
- translation
- 当前翻译(如果有则不带!!FUZZY!!字符串,使用标签以检查已过时或损坏的翻译)。
- tags
- 信息标签,例如可选、已忽略和过时。
- properties
- 信息属性,例如状态、修订、最后翻译者。可在信息间变化。
- revision
- 已弃用!请改用mcprop=properties。
- 值(以|或替代物分隔):definition、translation、tags、revision、properties
- 默认:definition|translation
- 支持的语言列表
- api.php?action=query&meta=siteinfo&siprop=languages [在沙盒中打开]
- 定义用于组“page-Example”的非可选消息列表
- api.php?action=query&list=messagecollection&mcgroup=page-Example [在沙盒中打开]
- 芬兰语中的可选消息列表,带有用于“page-Example”组的标签
- api.php?action=query&list=messagecollection&mcgroup=page-Example&mclanguage=fi&mcprop=definition|translation|tags&mcfilter=optional [在沙盒中打开]
- 更多有关“page-Example”组最近翻译修订的信息
- api.php?action=query&generator=messagecollection&gmcgroup=page-Example&gmclanguage=nl&prop=revisions [在沙盒中打开]
list=mystashedfiles (msf)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取当前用户上传暂存库中的文件列表。
- msfprop
要检索文件的属性。
- size
- 检索文件大小和图片尺寸。
- type
- 检索文件的MIME类型和媒体类型。
- 值(以|或替代物分隔):size、type
- 默认:(空)
- msflimit
要获取文件的数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- msfcontinue
当更多结果可用时,使用这个继续。
- 获取当前用户上传暂存库中的文件的filekey、大小和像素尺寸。
- api.php?action=query&list=mystashedfiles&msfprop=size [在沙盒中打开]
list=pagepropnames (ppn)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出wiki中所有使用中的页面属性名称。
- ppncontinue
当更多结果可用时,使用这个继续。
- ppnlimit
返回名称的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- 获取前10个属性名称。
- api.php?action=query&list=pagepropnames [在沙盒中打开]
list=pageswithprop (pwp)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出所有使用指定页面属性的页面。
- pwppropname
要用于列举页面的页面属性(action=query&list=pagepropnames返回正在使用中的页面属性名称)。
- 这个参数是必须的。
- 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-or-later
为页面标题执行前缀搜索。
尽管名称类似,但此模块不等于Special:PrefixIndex;详见action=query&list=allpages中的apprefix参数。此模块的目的类似action=opensearch:基于用户的输入提供最佳匹配的标题。取决于搜索引擎后端,这可能包括错拼纠正、避免重定向和其他启发性行为。
- pssearch
搜索字符串。
- 这个参数是必须的。
- psnamespace
搜索的名字空间。如果pssearch以有效名字空间前缀开头则忽略。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 默认:0
- pslimit
要返回的结果最大数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- psoffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- 搜索以meaning开头的页面标题。
- api.php?action=query&list=prefixsearch&pssearch=meaning [在沙盒中打开]
list=protectedtitles (pt)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出所有被限制创建的标题。
- ptnamespace
只列出这些名字空间的标题。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- ptlevel
只列出带这些保护级别的标题。
- 值(以|或替代物分隔):autoconfirmed、sysop
- ptlimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ptdir
列举的方向:
- newer
- 最早的优先。注意:ptstart应早于ptend。
- older
- 最新的优先(默认)。注意:ptstart应晚于ptend。
- 以下值中的一个:newer、older
- 默认:older
- ptstart
从此保护时间戳开始列举。
- 类型:时间戳(允许格式)
- ptend
列举至此保护时间戳为止。
- 类型:时间戳(允许格式)
- 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-or-later
获取由基于QueryPage的特殊页面提供的列表。
- qppage
特殊页面的名称。注意其区分大小写。
- 这个参数是必须的。
- 以下值中的一个: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、GadgetUsage
- qpoffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- qplimit
返回的结果数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
list=random (rn)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取随机页面集。
页面列举在一个固定序列中,只有起始点是随机的。这意味着如果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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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-or-later
列举最近更改。
- rcstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- rcend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- rcdir
列举的方向:
- newer
- 最早的优先。注意:rcstart应早于rcend。
- older
- 最新的优先(默认)。注意:rcstart应晚于rcend。
- 以下值中的一个:newer、older
- 默认:older
- rcnamespace
过滤更改为仅限这些名字空间。
- 值(以|或替代物分隔):-2、-1、0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- rcuser
只列出此用户的更改。
- 类型:用户名
- rcexcludeuser
不要列出此用户的更改。
- 类型:用户名
- rctag
只列出带此标签的更改。
- rcprop
包含的额外信息束:
- user
- 添加造成编辑的用户,并标出它们是否是IP。
- userid
- 为编辑添加用户ID责任。
- comment
- 为编辑添加摘要。
- parsedcomment
- 为编辑添加解析的摘要。
- flags
- 为编辑添加标记。
- timestamp
- 添加编辑的时间戳。
- title
- 添加编辑的页面标题。
- ids
- 添加页面ID、最近更改ID和新旧修订的ID。
- sizes
- 添加新旧页面长度(字节)。
- redirect
- 如果页面是重定向的话,标记编辑。
- patrolled
- 将可巡查编辑标记为已巡查或未巡查。
- loginfo
- 添加日志信息(日志ID、日志类型等)至日志记录。
- tags
- 列举条目的标签。
- sha1
- 为与某一修订版本有关的记录添加内容校验和。
- 值(以|或替代物分隔):user、userid、comment、parsedcomment、flags、timestamp、title、ids、sizes、redirect、patrolled、loginfo、tags、sha1
- 默认:title|timestamp|ids
- rctoken
- 已弃用。
- 值(以|或替代物分隔):patrol
- rcshow
只显示满足这些标准的项目。例如,要只查看由登录用户做出的小编辑,设置rcshow=minor|!anon。
- 值(以|或替代物分隔):minor、!minor、bot、!bot、anon、!anon、redirect、!redirect、patrolled、!patrolled、unpatrolled、autopatrolled、!autopatrolled
- rclimit
返回总计更新数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- rctype
显示的更改类型。
- 值(以|或替代物分隔):edit、new、log、external、categorize
- 默认:edit|new|log|categorize
- rctoponly
只列举作为最新修订的更改。
- 类型:布尔值(详细信息)
- rctitle
过滤记录至这些与页面相关的。
- rccontinue
当更多结果可用时,使用这个继续。
- rcgeneraterevisions
当作为生成器使用时,生成修订ID而不是标题。不带关联修订ID的最近更改记录(例如大多数日志记录)将不会生成任何东西。
- 类型:布尔值(详细信息)
list=search (sr)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
执行一次全文本搜索。
- srsearch
搜索所有匹配此值的页面标题或内容。根据wiki的搜索后端工具,您可以使用搜索字符串以调用特殊搜索功能。
- 这个参数是必须的。
- srnamespace
只在这些名字空间搜索。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 默认:0
- srlimit
返回的总计页面数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- sroffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- srqiprofile
查询要使用的独立描述(影响排序算法)。
- classic
- 基于传入链接、一些模板、页面语言和新近程度的排名(模板/语言/新近程度可能不会在此wiki激活)。
- classic_noboostlinks
- 基于一些模板、页面语言和新近程度的排名,当在此wiki激活时。
- empty
- 完全基于查询相关特性的排名(仅用于调试)。
- wsum_inclinks
- 基于传入链接的加权和
- wsum_inclinks_pv
- 基于传入链接及每周页面浏览的加权和
- popular_inclinks_pv
- 主要基于页面预览排名
- popular_inclinks
- 主要基于链入链接数排名
- engine_autoselect
- 让搜索引擎决定使用的最佳个人资料。
- 以下值中的一个:classic、classic_noboostlinks、empty、wsum_inclinks、wsum_inclinks_pv、popular_inclinks_pv、popular_inclinks、engine_autoselect
- 默认:engine_autoselect
- srwhat
要执行的搜索类型。
- 以下值中的一个:title、text、nearmatch
- srinfo
要返回的元数据。
- 值(以|或替代物分隔):totalhits、suggestion、rewrittenquery
- 默认:totalhits|suggestion|rewrittenquery
- srprop
要返回的属性:
- size
- 添加页面大小,单位为字节。
- wordcount
- 添加页面的字数。
- timestamp
- 添加页面上次编辑时的时间戳。
- snippet
- 添加已解析的页面片段。
- titlesnippet
- 添加已解析的页面标题片段。
- redirecttitle
- 添加匹配的重定向的标题。
- redirectsnippet
- 添加被解析的重定向标题的片段。
- sectiontitle
- 添加匹配章节的标题。
- sectionsnippet
- 添加已解析的匹配章节标题片段。
- isfilematch
- 添加布尔值,表明搜索是否匹配文件内容。
- categorysnippet
- 添加已解析的匹配分类片段。
- score
- 已弃用。 已忽略。
- hasrelated
- 已弃用。 已忽略。
- extensiondata
- 添加由扩展生成的额外数据。
- 值(以|或替代物分隔):size、wordcount、timestamp、snippet、titlesnippet、redirecttitle、redirectsnippet、sectiontitle、sectionsnippet、isfilematch、categorysnippet、score、hasrelated、extensiondata
- 默认:size|wordcount|timestamp|snippet
- srinterwiki
搜索结果中包含跨wiki结果,如果可用。
- 类型:布尔值(详细信息)
- srenablerewrites
启用内部查询重写。一些搜索后端可以重写查询到另一个被认为能提供更好结果的位置,例如纠正拼写错误。
- 类型:布尔值(详细信息)
- srsort
设置返回结果的排序。
- 以下值中的一个:relevance、just_match、none、incoming_links_asc、incoming_links_desc、last_edit_asc、last_edit_desc、create_timestamp_asc、create_timestamp_desc
- 默认:relevance
list=tags (tg)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
列出更改标签。
- tgcontinue
当更多结果可用时,使用这个继续。
- tglimit
列出标签的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- tgprop
要获取的属性:
- displayname
- 为标签添加系统消息。
- description
- 为标签添加描述。
- hitcount
- 已添加此标签的修订版本与日志数量。
- defined
- 标识标签是否已定义。
- source
- 获得标签来源,它可能包括用于扩展定义的标签的extension,以及用于可被用户手动应用的标签的manual。
- active
- 标签是否仍可被应用。
- 值(以|或替代物分隔):displayname、description、hitcount、defined、source、active
- 默认:(空)
list=usercontribs (uc)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取一位用户的所有编辑。
- uclimit
返回贡献的最大数量。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- ucstart
返回的起始时间戳。
- 类型:时间戳(允许格式)
- ucend
返回的最终时间戳。
- 类型:时间戳(允许格式)
- uccontinue
当更多结果可用时,使用这个继续。
- ucuser
要检索贡献的用户。不能与ucuserids或ucuserprefix一起使用。
- 类型:用户名列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- ucuserids
要检索贡献的用户ID。不能与ucuser或ucuserprefix一起使用。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- ucuserprefix
取得所有用户名以这个值开头的用户的贡献。不能与ucuser或ucuserids一起使用。
- 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、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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、autopatrolled、!autopatrolled、top、!top、new、!new
- uctag
只列出被此标签标记的修订。
- uctoponly
- 已弃用。
只列举作为最新修订的更改。
- 类型:布尔值(详细信息)
- 显示用户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-or-later
获取有关列出用户的信息。
- usprop
要包含的信息束:
- blockinfo
- 如果用户被封禁就标记,并注明是谁封禁,以何种原因封禁的。
- groups
- 列举每位用户属于的所有组。
- groupmemberships
- 列举明确分配给每位用户的用户组,包括每个用户组成员的过期时间。
- implicitgroups
- 列举用户自动作为成员之一的所有组。
- rights
- 列举每位用户拥有的所有权限。
- editcount
- 添加用户的编辑计数。
- registration
- 添加用户的注册时间戳。
- emailable
- 当用户可以并希望通过Special:Emailuser接收电子邮件时标记。
- gender
- 标记用户性别。返回“male”、“female”或“unknown”。
- centralids
- 添加中心ID并为用户附加状态。
- cancreate
- 表明是否可以为有效但尚未注册的用户名创建一个账户。
- 值(以|或替代物分隔):blockinfo、groups、groupmemberships、implicitgroups、rights、editcount、registration、emailable、gender、centralids、cancreate
- usattachedwiki
与usprop=centralids一起使用,表明用户是否附加于此ID定义的wiki。
- ususers
要获取信息的用户列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- ususerids
要获得信息的用户ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- ustoken
- 已弃用。
- 值(以|或替代物分隔):userrights
list=watchlist (wl)
- 此模块需要读取权限。
- 此模块可作为发生器使用。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
在当前用户的监视列表中获取对页面的最近更改。
- wlallrev
将同一页面的多个修订包含于指定的时间表内。
- 类型:布尔值(详细信息)
- wlstart
枚举的起始时间戳。
- 类型:时间戳(允许格式)
- wlend
枚举的结束时间戳。
- 类型:时间戳(允许格式)
- wlnamespace
过滤更改为仅限指定名字空间。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- 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
- 在适当位置添加日志信息。
- tags
- 列举条目的标签。
- 值(以|或替代物分隔):ids、title、flags、user、userid、comment、parsedcomment、timestamp、patrol、sizes、notificationtimestamp、loginfo、tags
- 默认:ids|title|flags
- wlshow
只显示满足这些标准的项目。例如,要只查看由登录用户做出的小编辑,设置wlshow=minor|!anon。
- 值(以|或替代物分隔):minor、!minor、bot、!bot、anon、!anon、patrolled、!patrolled、autopatrolled、!autopatrolled、unread、!unread
- wltype
要显示的更改类型:
- edit
- 普通页面编辑。
- new
- 页面创建。
- log
- 日志记录。
- external
- 外部更改。
- categorize
- 分类成员组更改。
- 值(以|或替代物分隔):edit、new、log、external、categorize
- 默认:edit|new|log|categorize
- wlowner
与wltoken一起使用以访问不同用户的监视列表。
- 类型:用户名
- 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-or-later
获得当前用户的监视列表上的所有页面。
- wrcontinue
当更多结果可用时,使用这个继续。
- wrnamespace
只列出指定名字空间的页面。
- 值(以|或替代物分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、828、829、1198、1199、2300、2301、2302、2303、2500、2501、2600
- 要指定所有值,请使用*。
- wrlimit
根据结果返回的结果总数。
- 不允许超过500个(对于机器人则是5,000个)。
- 类型:整数或max
- 默认:10
- wrprop
要获取的额外属性:
- changed
- 添加最近被通知有关编辑的用户的时间戳。
- 值(以|或替代物分隔):changed
- wrshow
只列出符合这些标准的项目。
- 值(以|或替代物分隔):changed、!changed
- wrowner
与wrtoken一起使用以访问不同用户的监视列表。
- 类型:用户名
- wrtoken
允许访问其他用户监视列表的安全密钥(可通过用户的参数设置找到)。
- wrdir
罗列所采用的方向。
- 以下值中的一个:ascending、descending
- 默认:ascending
- wrfromtitle
要列举的起始标题(带名字空间前缀)。
- wrtotitle
要列举的最终标题(带名字空间前缀)。
- 列出当前用户的监视列表中的页面。
- api.php?action=query&list=watchlistraw [在沙盒中打开]
- 检索当前用户监视列表上的页面的页面信息。
- api.php?action=query&generator=watchlistraw&gwrshow=changed&prop=info [在沙盒中打开]
meta=allmessages (am)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回来自该网站的消息。
- ammessages
要输出的消息。*(默认)表示所有消息。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 默认:*
- amprop
要获取的属性。
- 值(以|或替代物分隔):default
- amenableparser
设置以启用解析器,将处理消息的wiki文本(替代魔术字、处理模板等)。
- 类型:布尔值(详细信息)
- amnocontent
如果设置,不要在输出中包含消息内容。
- 类型:布尔值(详细信息)
- amincludelocal
也包括本地消息,也就是不存在于软件但存在于MediaWiki名字空间的消息。 这会列举所有MediaWiki名字空间页面,因此它也将列举那些不是真消息的消息,例如Common.js。
- 类型:布尔值(详细信息)
- amargs
要替代进消息的参数。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- amfilter
只返回名称包含此字符串的消息。
- amcustomised
只返回在此定制情形下的消息。
- 以下值中的一个:all、modified、unmodified
- 默认:all
- amlang
返回这种语言的信息。
- amfrom
从此消息开始返回消息。
- amto
返回消息至此消息为止。
- amtitle
当解析消息时,要用作环境的页面(用于amenableparser选项)。
- amprefix
返回带有该前缀的消息。
- 显示以ipb-开始的消息。
- api.php?action=query&meta=allmessages&refix=ipb- [在沙盒中打开]
- 显示德语版的august和mainpage消息。
- api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de [在沙盒中打开]
meta=authmanagerinfo (ami)
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
检索有关当前身份验证状态的信息。
- amisecuritysensitiveoperation
测试用户当前的身份验证状态是否足够用于指定的安全敏感操作。
- amirequestsfor
取得指定身份验证操作所需的有关身份验证请求的信息。
- 以下值中的一个:login、login-continue、create、create-continue、link、link-continue、change、remove、unlink
- amimergerequestfields
合并用于所有身份验证请求的字段信息至一个数组中。
- 类型:布尔值(详细信息)
- amimessageformat
用于返回消息的格式。
- 以下值中的一个:html、wikitext、raw、none
- 默认:wikitext
- 检索当开始登录时可能使用的请求。
- api.php?action=query&meta=authmanagerinfo&amirequestsfor=login [在沙盒中打开]
- 检索当开始登录时可能使用的请求,并合并表单字段。
- api.php?action=query&meta=authmanagerinfo&amirequestsfor=login&amimergerequestfields=1 [在沙盒中打开]
- 测试身份验证对操作foo是否足够。
- api.php?action=query&meta=authmanagerinfo&amisecuritysensitiveoperation=foo [在沙盒中打开]
meta=babel (bab)
- 此模块需要读取权限。
- 来源:Babel
- 许可协议:GPL-2.0-or-later
获取有关用户可以理解语言的信息
- babuser
要获取相关信息的用户
- 这个参数是必须的。
- 类型:用户名
- 获取用户Example的巴别信息
- api.php?action=query&meta=babel&babuser=Example [在沙盒中打开]
meta=filerepoinfo (fri)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回有关wiki配置的图片存储库的元信息。
- friprop
要获取的存储库属性(可用属性在其他wiki上可能不同)。
- apiurl
- 至存储库API的URL - 对从主机获取图片信息有用。
- articlepath
- 存储库wiki的$wgArticlePath或等价物。
- canUpload
- 文件是否可以上传至此存储库,例如通过CORS和共享身份验证。
- descriptionCacheExpiry
- (没有说明)
- displayname
- 人类可读的存储库wiki名称。
- favicon
- 存储库wiki的网站图标URL,来自$wgFavicon。
- fetchDescription
- 当查看本地文件说明页面时,文件描述页面是否检索自此存储库。
- initialCapital
- 文件名是否隐式地以大写字母开头。
- local
- 存储库是否为本地的。
- name
- 存储库的关键词 - 用于例如$wgForeignFileRepos和imageinfo返回的值。
- rootUrl
- 用于图片路径的根URL路径。
- scriptDirUrl
- 用于存储库wiki的MediaWiki安装副本的根URL路径。
- server
- 存储库wiki的$wgServer或等价物。
- thumbUrl
- 用于缩略图路径的根URL路径。
- url
- 公开区域URL路径。
- 值(以|或替代物分隔):apiurl、articlepath、canUpload、descriptionCacheExpiry、displayname、favicon、fetchDescription、initialCapital、local、name、rootUrl、scriptDirUrl、server、thumbUrl、url
- 默认:apiurl|articlepath|canUpload|descriptionCacheExpiry|displayname|favicon|fetchDescription|initialCapital|local|name|rootUrl|scriptDirUrl|server|thumbUrl|url
meta=languagestats (ls)
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
查询语言状态。
- lsoffset
当更多结果可用时,使用这个继续。
- 默认:0
- lstimelimit
- 已弃用。
花费在统计缺失信息上的最长时间。如果为零,立即返回缓存的结果。
- 值必须介于0和10之间。
- 类型:整数
- 默认:8
- lslanguage
语言代码。
- 这个参数是必须的。
meta=messagegroups (mg)
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
返回有关消息组的信息。
注意uselang测试影响语言依赖部分的输出。
- mgdepth
当使用树形格式时,限制深度至如此多水平。值0意味着不会显示子组。如果达到限制,输出会包含一个“groupcount”值,它指出直系子组的数值。
- 类型:整数
- 默认:100
- mgfilter
只返回匹配一个或更多输入内容的ID的消息(不区分大小写,以逗号分隔,* 通配符)。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 默认:(空)
- mgformat
在树格式信息组可以存在于树中的多个位置。
- 以下值中的一个:flat、tree
- 默认:flat
- mgiconsize
栅格化群组图标的首选大小。
- 类型:整数
- 默认:64
- mgprop
要获得的有关翻译的信息:
- id
- 包含组ID。
- label
- 包含组标签。
- description
- 包含组描述。
- class
- 包含组分类名。
- namespace
- 包含组名字空间。不是所有组都属于单一名字空间。
- exists
- 包含自计算的组实际属性。
- icon
- 包含至URL的组图标。
- priority
- 包含优先状态,例如劝阻。
- prioritylangs
- 包含首选语言。如果未设置,这将返回否。
- priorityforce
- 包含优先状态——优先语言是否被强制设置。
- workflowstates
- 包含用于消息组的工作流状态。
- 值(以|或替代物分隔):id、label、description、class、namespace、exists、icon、priority、prioritylangs、priorityforce、workflowstates
- 默认:id|label|description|class|exists
- mgroot
何时使用树形格式,而不是从来自指定信息组最高级开始,那样必须是一个聚合信息组。当使用单调格式时只有指定组被返回。
- 默认:(空)
meta=messagegroupstats (mgs)
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
查询信息组状态。
- mgsoffset
当更多结果可用时,使用这个继续。
- 默认:0
- mgstimelimit
- 已弃用。
计算缺失统计所花费的最长时间。如果为零,则只有从开始起缓存的结果会被返回。
- 值必须介于0和10之间。
- 类型:整数
- 默认:8
- mgsgroup
信息组ID。
- 这个参数是必须的。
- 用于“page-Example”组的翻译完成统计列表
- api.php?action=query&meta=messagegroupstats&mgsgroup=page-Example [在沙盒中打开]
meta=messagetranslations (mt)
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
查询单个信息的所有翻译。
- mttitle
已知消息的完整标题。
- 这个参数是必须的。
- mtoffset
当更多结果可用时,使用这个继续。
- 类型:整数
- 默认:0
- Wiki中用于“MediaWiki:January”的翻译列表
- api.php?action=query&meta=messagetranslations&mttitle=MediaWiki:January [在沙盒中打开]
meta=notifications (not)
- 此模块需要读取权限。
- 来源:Echo
- 许可协议:MIT
获取当前用户等待的通知。
- notfilter
过滤返回的通知。
- 值(以|或替代物分隔):read、!read
- 默认:read|!read
- notprop
请求的细节。
- 值(以|或替代物分隔):list、count、seenTime
- 默认:list
- notsections
要查询的通知部分(也就是说“alert”和“message”的一些结合)。
- 值(以|或替代物分隔):alert、message
- 默认:alert|message
- notgroupbysection
是否按章节分组结果。如果设置,将分别获取每个章节。
- 类型:布尔值(详细信息)
- notformat
如果指定,通知将以此格式返回。
- model
- 原始通知数据
- special
- 格式化用于Special:Notifications页面(并仅限于此!)不要依赖HTML,这可能在任何指定的时间更改。
- flyout
- 已弃用。使用notformat=model用于原始数据
- html
- 已弃用。使用notformat=model用于原始数据
- 以下值中的一个:model、special、flyout、html
- notlimit
返回通知的最大数量。
- 不允许超过50个(对于机器人则是500个)。
- 类型:整数或max
- 默认:20
- notcontinue
当更多结果可用时,使用这个继续。
- notunreadfirst
是否首先显示未读通知(只当groupbysection未设置时使用)。
- 类型:布尔值(详细信息)
- nottitles
只返回这些页面的通知。要获取未分配给任何页面的通知,使用[]作为标题。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- notbundle
是否根据通知类型捆绑规则,显示兼容捆绑的未读通知。
- 类型:布尔值(详细信息)
- notalertcontinue
当更多提醒结果可用时,使用这个继续。
- notalertunreadfirst
是否首先显示未读的消息通知(只当groupbysection已设置时使用)。
- 类型:布尔值(详细信息)
- notmessagecontinue
当更多消息结果可用时,使用这个继续。
- notmessageunreadfirst
是否首先显示未读的提醒通知(只当groupbysection已设置时使用)。
- 类型:布尔值(详细信息)
meta=oath (oath)
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:OATHAuth
- 许可协议:GPL-2.0-or-later AND GPL-3.0-or-later
检查双因素验证(OATH)是否为某一用户启用。
- oathuser
获取相关信息的用户。默认为当前用户。
- 类型:用户名
- 获取有关当前用户的信息
- api.php?action=query&meta=oath [在沙盒中打开]
- 获取有关用户Example的信息
- api.php?action=query&meta=oath&oathuser=Example [在沙盒中打开]
meta=siteinfo (si)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
返回有关网站的一般信息。
- siprop
要获取的信息:
- general
- 全部系统信息。
- namespaces
- 注册的名字空间及其规范名称列表。
- namespacealiases
- 注册的名字空间别名列表。
- specialpagealiases
- 特殊页面别名列表。
- magicwords
- 魔术字及其别名列表。
- interwikimap
- 返回跨wiki映射(可选过滤,可选择使用siinlanguagecode本地化)。
- dbrepllag
- 返回数据库服务器与最高反应延迟。
- statistics
- 返回网站统计。
- usergroups
- 返回用户组及其相关权限。
- libraries
- 返回wiki上安装的库。
- extensions
- 返回wiki上安装的扩展。
- fileextensions
- 返回允许上传的文件扩展名(文件类型)列表。
- rightsinfo
- 当可用时返回wiki的版权(许可协议)信息。
- restrictions
- 返回可用的编辑限制(保护)类型信息。
- languages
- 返回MediaWiki支持的语言列表(可选择使用siinlanguagecode本地化)。
- languagevariants
- 当启用了语言转换器,并且每个语言变体都受支持时,返回语言代码列表。
- skins
- 返回所有启用的皮肤列表(可选择使用siinlanguagecode本地化,否则是内容语言)。
- extensiontags
- 返回解析器扩展标签列表。
- functionhooks
- 返回解析器函数钩列表。
- showhooks
- 返回所有订阅的钩列表($wgHooks的内容)。
- variables
- 返回变量ID列表。
- protocols
- 返回外部链接中允许的协议列表。
- defaultoptions
- 返回用户设置的默认值。
- uploaddialog
- 返回上传对话框的配置。
- 值(以|或替代物分隔):general、namespaces、namespacealiases、specialpagealiases、magicwords、interwikimap、dbrepllag、statistics、usergroups、libraries、extensions、fileextensions、rightsinfo、restrictions、languages、languagevariants、skins、extensiontags、functionhooks、showhooks、variables、protocols、defaultoptions、uploaddialog
- 默认:general
- sifilteriw
只返回跨wiki地图中的本地或非本地记录。
- 以下值中的一个:local、!local
- sishowalldb
列出所有数据库服务器,不只是最落后的那个。
- 类型:布尔值(详细信息)
- sinumberingroup
列出用户组中的用户数。
- 类型:布尔值(详细信息)
- siinlanguagecode
用于本地化语言名称(尽可能)和皮肤名称的语言代码。
meta=tokens
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取可修改数据的操作的令牌。
- type
要请求的令牌类型。
- 值(以|或替代物分隔):createaccount、csrf、login、patrol、rollback、userrights、watch
- 默认:csrf
- 检索一个csrf令牌(默认)。
- api.php?action=query&meta=tokens [在沙盒中打开]
- 检索一个监视令牌和一个巡查令牌。
- api.php?action=query&meta=tokens&type=watch|patrol [在沙盒中打开]
meta=unreadnotificationpages (unp)
- 此模块需要读取权限。
- 来源:Echo
- 许可协议:MIT
获取当前用户未读通知的相关页面。
- unpgrouppages
将讨论页与它们的主题页面一起分组,并将未分配给某一页面的通知与当前用户的用户页一起分组。
- 类型:布尔值(详细信息)
- unplimit
返回页面的最大数量。
- 不允许超过2,000个(对于机器人则是2,000个)。
- 类型:整数或max
- 默认:10
- 列举有(对应数量)未读通知的页面
- api.php?action=query&meta=unreadnotificationpages [在沙盒中打开]
meta=userinfo (ui)
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取有关当前用户的信息。
- uiprop
要包含的信息束:
- blockinfo
- 如果当前用户被封禁就标记,并注明是谁封禁,以何种原因封禁的。
- hasmsg
- 如果当前用户有等待中的消息的话,添加标签messages。
- groups
- 列举当前用户隶属的所有群组。
- groupmemberships
- 列举明确分配给当前用户的用户组,包括每个用户组成员的过期时间。
- implicitgroups
- 列举当前用户的所有自动成为成员的用户组。
- rights
- 列举当前用户拥有的所有权限。
- changeablegroups
- 列举当前用户可以添加并移除的用户组。
- options
- 列举当前用户设置的所有参数设置。
- editcount
- 添加当前用户的编辑计数。
- ratelimits
- 列举所有应用到当前用户的速率限制。
- 添加用户的电子邮件地址及电子邮件验证日期。
- realname
- 添加用户的真实姓名。
- acceptlang
- 重复由客户端以结构化格式发送的
Accept-Language
标头。 - registrationdate
- 添加用户的注册时间。
- unreadcount
- 添加用户监视列表上的未独页面计数(最高999;如果更多则返回1000+)。
- centralids
- 添加中心ID并为用户附加状态。
- preferencestoken
- 已弃用。 获取令牌以更改当前用户的参数设置。
- latestcontrib
- Adds the date of user's latest contribution.
- 值(以|或替代物分隔):blockinfo、hasmsg、groups、groupmemberships、implicitgroups、rights、changeablegroups、options、editcount、ratelimits、email、realname、acceptlang、registrationdate、unreadcount、centralids、preferencestoken、latestcontrib
- uiattachedwiki
与uiprop=centralids一起使用,表明用户是否附加于此ID定义的wiki。
action=removeauthenticationdata
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从当前用户移除身份验证数据。
- request
使用此身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=remove。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 尝试移除当前用户的FooAuthenticationRequest数据。
- api.php?action=removeauthenticationdata&request=FooAuthenticationRequest&token=123ABC [在沙盒中打开]
action=resetpassword
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
向用户发送密码重置邮件。
- user
正在重置的用户。
- 类型:用户名
正在重置用户的电子邮件地址。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 向用户Example发送密码重置邮件。
- api.php?action=resetpassword&user=Example&token=123ABC [在沙盒中打开]
- 向所有电子邮件地址为[email protected]的用户发送密码重置邮件。
- api.php?action=resetpassword&[email protected]&token=123ABC [在沙盒中打开]
action=revisiondelete
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
删除和恢复修订版本。
- type
正在执行的修订版本删除类型。
- 这个参数是必须的。
- 以下值中的一个:revision、archive、oldimage、filearchive、logging
- target
要进行修订版本删除的页面标题,如果对某一类型需要。
- ids
用于将被删除的修订的标识符。
- 这个参数是必须的。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- hide
每次修订要隐藏的东西。
- 值(以|或替代物分隔):content、comment、user
- show
每次修订要恢复显示的东西。
- 值(以|或替代物分隔):content、comment、user
- suppress
是否对管理员及其他人禁止数据。
- 以下值中的一个:yes、no、nochange
- 默认:nochange
- reason
删除或恢复的原因。
- tags
要在删除日志中应用到实体的标签。
- 值(以|或替代物分隔):
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=rollback
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
撤销对页面的最近编辑。
如果上一对页面做出编辑的用户连续做出了多次编辑,它们将全数被回退。
- title
要回退的页面标题。不能与pageid一起使用。
- pageid
要回退的页面的页面 ID。不能与title一起使用。
- 类型:整数
- tags
要应用在回退上的标签。
- 值(以|或替代物分隔):
- user
做出要回退的编辑的用户名称。
- 这个参数是必须的。
- 类型:用户名
- summary
自定义编辑摘要。如果为空,将使用默认摘要。
- 默认:(空)
- markbot
将被回退的编辑和回退操作标记为机器人编辑。
- 类型:布尔值(详细信息)
- 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-or-later
导出一个RSD(Really Simple Discovery)架构。
- 导出RSD架构。
- api.php?action=rsd [在沙盒中打开]
action=scribunto-console
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:Scribunto
- 许可协议:GPL-2.0-or-later AND MIT
从Scribunto控制台提供XHR请求的内部模块。
- title
要测试的模块的标题。
- content
模块的新内容。
- session
会话令牌。
- 类型:整数
- question
要作为脚本评估的下一行。
- 这个参数是必须的。
- clear
设置以清除当前的会话状态。
- 类型:布尔值(详细信息)
action=searchtranslations
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
搜索译文。
- service
哪些翻译服务可供使用。
- 以下值中的一个:
- query
要搜索的字符串。
- 这个参数是必须的。
- sourcelanguage
原始文本的语言代码。
- 默认:zh
- language
要搜索字符串的语言代码。
- 默认:(空)
- group
要搜索字符串的组id。
- 默认:(空)
- filter
消息译文状态过滤器。
- 以下值中的一个:可以为空,或translated、fuzzy、untranslated
- 默认:(空)
- match
匹配任何/所有搜索词。
- 默认:(空)
- case
(不)区分大小写的搜索。
- 默认:0
- offset
用于译文的偏移。
- 类型:整数
- 默认:0
- limit
结果的大小。
- 不允许超过50个(对于机器人则是500个)。
- 类型:整数或max
- 默认:25
action=setnotificationtimestamp
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
更新监视页面的通知时间戳。
这会影响监视列表和历史中已更改页面的高亮度,并且如果“当我的监视列表中的页面或文件更改时发送电子邮件通知我”设置被启用的话,也会影响电子邮件的发送。
- 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
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、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 [在沙盒中打开]
- 重置在User名字空间中的页面的通知状态。
- api.php?action=setnotificationtimestamp&generator=allpages&gapnamespace=2&token=123ABC [在沙盒中打开]
action=setpagelanguage
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
更改页面的语言。
此wiki不允许更改页面的语言。
启用$wgPageLanguageUseDB以使用此操作。
- title
您希望更改语言的页面标题。不能与pageid一起使用。
- pageid
您希望更改语言的页面ID。不能与title一起使用。
- 类型:整数
- lang
更改页面的目标语言的语言代码。使用default以重置页面为wiki的默认内容语言。
- 这个参数是必须的。
- 以下值中的一个:default、ab、abs、ace、ady、ady-cyrl、aeb、aeb-arab、aeb-latn、af、ak、aln、am、an、ang、anp、ar、arc、arn、arq、ary、arz、as、ase、ast、atj、av、avk、awa、ay、az、azb、ba、ban、bar、bbc、bbc-latn、bcc、bcl、be、be-tarask、bg、bgn、bh、bho、bi、bjn、bm、bn、bo、bpy、bqi、br、brh、bs、btm、bto、bug、bxr、ca、cbk-zam、cdo、ce、ceb、ch、chr、chy、ckb、co、cps、cr、crh、crh-cyrl、crh-latn、cs、csb、cu、cv、cy、da、de、de-at、de-ch、de-formal、din、diq、dsb、dtp、dty、dv、dz、ee、egl、el、eml、en、en-ca、en-gb、eo、es、es-formal、et、eu、ext、fa、ff、fi、fit、fj、fo、fr、frc、frp、frr、fur、fy、ga、gag、gan、gan-hans、gan-hant、gcr、gd、gl、glk、gn、gom、gom-deva、gom-latn、gor、got、grc、gsw、gu、gv、ha、hak、haw、he、hi、hif、hif-latn、hil、hr、hrx、hsb、ht、hu、hu-formal、hy、hyw、ia、id、ie、ig、ii、ik、ike-cans、ike-latn、ilo、inh、io、is、it、iu、ja、jam、jbo、jut、jv、ka、kaa、kab、kbd、kbd-cyrl、kbp、kg、khw、ki、kiu、kjp、kk、kk-arab、kk-cn、kk-cyrl、kk-kz、kk-latn、kk-tr、kl、km、kn、ko、ko-kp、koi、krc、kri、krj、krl、ks、ks-arab、ks-deva、ksh、ku、ku-arab、ku-latn、kum、kv、kw、ky、la、lad、lb、lbe、lez、lfn、lg、li、lij、liv、lki、lmo、ln、lo、loz、lrc、lt、ltg、lus、luz、lv、lzh、lzz、mai、map-bms、mdf、mg、mhr、mi、min、mk、ml、mn、mni、mnw、mo、mr、mrj、ms、mt、mwl、my、myv、mzn、na、nah、nan、nap、nb、nds、nds-nl、ne、new、niu、nl、nl-informal、nn、nov、nrm、nso、nv、ny、nys、oc、olo、om、or、os、pa、pag、pam、pap、pcd、pdc、pdt、pfl、pi、pih、pl、pms、pnb、pnt、prg、ps、pt、pt-br、qqq、qu、qug、rgn、rif、rm、rmy、ro、roa-tara、ru、rue、rup、ruq、ruq-cyrl、ruq-latn、rw、sa、sah、sat、sc、scn、sco、sd、sdc、sdh、se、sei、ses、sg、sgs、sh、shi、shn、shy-latn、si、sk、skr、skr-arab、sl、sli、sm、sma、sn、so、sq、sr、sr-ec、sr-el、srn、ss、st、stq、sty、su、sv、sw、szl、ta、tay、tcy、te、tet、tg、tg-cyrl、tg-latn、th、ti、tk、tl、tly、tn、to、tpi、tr、tru、ts、tt、tt-cyrl、tt-latn、tw、ty、tyv、tzm、udm、ug、ug-arab、ug-latn、uk、ur、uz、ve、vec、vep、vi、vls、vmf、vo、vot、vro、wa、war、wo、wuu、xal、xh、xmf、xsy、yi、yo、yue、za、zea、zgh、zh、zh-cn、zh-hans、zh-hant、zh-hk、zh-mo、zh-my、zh-sg、zh-tw、zu
- reason
更改原因。
- tags
要应用到此操作导致的日志记录的更改标签。
- 值(以|或替代物分隔):
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 更改Main Page的语言为巴斯克语。
- api.php?action=setpagelanguage&title=Main%20Page&lang=eu&token=123ABC [在沙盒中打开]
- 更改ID为123的页面的语言为wiki的默认内容语言。
- api.php?action=setpagelanguage&pageid=123&lang=default&token=123ABC [在沙盒中打开]
action=shortenurl
- 此模块需要读取权限。
- 此模块只允许POST请求。
- 来源:UrlShortener
- 许可协议:Apache-2.0
将一个长URL缩短。
- url
将被缩短的URL。
- 这个参数是必须的。
- 获取用于https://en.wikipedia.org/wiki/Arctica的短URL。
- api.php?action=shortenurl&url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FArctica [在沙盒中打开]
action=spamblacklist
- 此模块需要读取权限。
- 来源:SpamBlacklist
- 许可协议:GPL-2.0-or-later
验证一个或多个URL是否触发垃圾链接黑名单。
- url
要验证是否触发黑名单的URL。
- 这个参数是必须的。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
action=stashedit
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
在分享缓存中准备编辑。
这是打算通过使用来自编辑表单的AJAX以改进页面保存的性能。
- title
已开始编辑的页面标题。
- 这个参数是必须的。
- section
段落数。0用于首段,new用于新的段落。
- sectiontitle
新段落的标题。
- text
页面内容。
- stashedtexthash
要使用的来自先前暂存处的页面内容哈希。
- summary
更改摘要。
- contentmodel
新内容的内容模型。
- 这个参数是必须的。
- 以下值中的一个:GadgetDefinition、flow-board、Scribunto、sanitized-css、JsonSchema、wikitext、javascript、json、css、text
- contentformat
用于输入文本的内容序列化格式。
- 这个参数是必须的。
- 以下值中的一个:application/json、text/plain、text/css、text/x-wiki、text/javascript
- baserevid
基础修订的修订ID。
- 这个参数是必须的。
- 类型:整数
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=tag
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从个别修订或日志记录中添加或移除更改标签。
- rcid
要添加或移除标签的一个或更多的最近更改ID。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- revid
要添加或移除标签的一个或更多的修订ID。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- logid
要添加或移除标签的一个或更多的日志记录ID。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- add
要添加的标签。只有手动定义的标签可以添加。
- 值(以|或替代物分隔):
- remove
要移除的标签。只有手动定义或完全不明确的标签可以被移除。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- reason
更改原因。
- 默认:(空)
- tags
要应用到将被创建为此操作结果的日志实体的标签。
- 值(以|或替代物分隔):
- 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=templatedata
- 此模块需要读取权限。
- 来源:TemplateData
- 许可协议:GPL-2.0-or-later
获取由TemplateData扩展存储的数据。
- includeMissingTitles
返回有关标题的数据,即便其丢失或缺少模板数据。默认情况下只在标题存在且有模板数据时返回标题。
- 类型:布尔值(详细信息)
- doNotIgnoreMissingTitles
- 已弃用。
返回有关标题的数据,即便其丢失或缺少模板数据。默认情况下(出于向后兼容性)只在标题存在且有模板数据时返回标题。
- 类型:布尔值(详细信息)
- lang
返回此语言的本地化值。默认会返回所有可用翻译。
- titles
要工作的标题列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- allcategories
- 列举所有分类。
- alldeletedrevisions
- 列举由一位用户或在一个名字空间中所有已删除的修订。
- allfileusages
- 列出所有文件用途,包括不存在的。
- allimages
- 按顺序枚举所有图像。
- alllinks
- 列举所有指向至指定名字空间的链接。
- allpages
- 循序列举在指定名字空间中的所有页面。
- allredirects
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、gan、iu、kk、ku、shi、sr、tg、uz和zh。
- 类型:布尔值(详细信息)
- 返回Template:Stub和Template:Example的模板数据,如果模板不存在,或虽然存在但没有模板数据的话就返回结果
- api.php?action=templatedata&titles=Template:Stub|Template:Example&includeMissingTitles=1 [在沙盒中打开]
- 返回Template:Stub和Template:Example的模板数据,如果模板不存在,或虽然存在但没有模板数据的话就不返回结果
- api.php?action=templatedata&titles=Template:Stub|Template:Example [在沙盒中打开]
action=titleblacklist (tb)
- 此模块需要读取权限。
- 来源:TitleBlacklist
- 许可协议:GPL-2.0-or-later
验证一个页面的标题、文件名或用户名是否触发标题黑名单。
- tbtitle
验证是否触发黑名单的字符串。
- 这个参数是必须的。
- tbaction
要检查的操作。
- 以下值中的一个:create、edit、upload、createtalk、createpage、move、new-account
- 默认:edit
- tbnooverride
不要尝试绕开标题黑名单。
- 类型:布尔值(详细信息)
action=tokens
- 此模块已弃用。
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
获取数据修改操作的令牌。
此模块已弃用,以便action=query&meta=tokens使用。
- type
要请求的令牌类型。
- 值(以|或替代物分隔):block、createaccount、csrf、delete、edit、email、import、login、move、options、patrol、protect、rollback、unblock、userrights、watch
- 默认:edit
- 检索一个编辑令牌(默认)。
- api.php?action=tokens [在沙盒中打开]
- 检索一个电子邮件令牌和一个移动令牌。
- api.php?action=tokens&type=email|move [在沙盒中打开]
action=translationaids
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
查询所有翻译帮助。
- title
已知消息的完整标题。
- 这个参数是必须的。
- group
信息属于哪个信息组。如果为空则使用首要组。
- prop
包含的翻译助手。
- 值(以|或替代物分隔):definition、translation、inotherlanguages、documentation、mt、definitiondiff、ttmserver、support、gettext、insertables
- 默认:definition|translation|inotherlanguages|documentation|mt|definitiondiff|ttmserver|support|gettext|insertables
action=translationcheck
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
验证翻译。
- title
带名字空间和语言代码的页面标题。
- 这个参数是必须的。
- translation
要验证的翻译。
- 这个参数是必须的。
action=translationreview
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
标记该翻译为已复核。
- revision
要复核的修订版本号。
- 这个参数是必须的。
- 类型:整数
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=ttmserver
- 此模块需要读取权限。
- 来源:Translate
- 许可协议:GPL-2.0-or-later
从翻译记忆库查询建议。
- service
哪些翻译服务可供使用。
- 以下值中的一个:
- sourcelanguage
原始文本的语言代码。
- 这个参数是必须的。
- targetlanguage
建议的语言代码。
- 这个参数是必须的。
- text
用于寻找建议的文本。
- 这个参数是必须的。
- 获取有关将“Help”从英语翻译成芬兰语的建议
- api.php?action=ttmserver&sourcelanguage=en&targetlanguage=fi&text=Help [在沙盒中打开]
action=ulslocalization
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:UniversalLanguageSelector
- 许可协议:GPL-2.0-or-later
获取指定语言的ULS本地化。
- language
语言代码。
- 这个参数是必须的。
action=unblock
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
解封一位用户。
- id
解封时需要的封禁ID(通过list=blocks获得)。不能与user或userid一起使用。
- 类型:整数
- user
要解封的用户名、IP地址或IP地址段。不能与id或userid一起使用。
- userid
要封禁的用户ID。不能与id或user一起使用。
- 类型:整数
- reason
解封的原因。
- 默认:(空)
- tags
要在封禁日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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-or-later
恢复删除页面的修订版本。
被删除修订的列表(包括时间戳)可通过prop=deletedrevisions检索到,并且被删除的文件ID列表可通过list=filearchive检索到。
- title
要恢复的页面标题。
- 这个参数是必须的。
- reason
恢复的原因。
- 默认:(空)
- tags
要在删除日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- timestamps
要回复的修订的时间戳。如果timestamps和fileids都为空,所有将被恢复。
- 类型:时间戳列表(允许格式)
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- fileids
要恢复的文件修订ID。如果timestamps和fileids都为空,所有将被恢复。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、unwatch、preferences、nochange
- 默认:preferences
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=unlinkaccount
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从当前用户移除已连接的第三方账户。
- request
使用此身份验证请求,通过返回自action=query&meta=authmanagerinfo的id与amirequestsfor=unlink。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- 尝试移除当前用户的,与FooAuthenticationRequest相关联提供方的链接。
- api.php?action=unlinkaccount&request=FooAuthenticationRequest&token=123ABC [在沙盒中打开]
action=upload
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
上传文件,或获取正在等待中的上传的状态。
可以使用的几种方法:
- 直接上传文件内容,使用file参数。
- 成批上传文件,使用filesize、chunk和offset参数。
- 有MediaWiki服务器从URL检索一个文件,使用url参数。
- 完成一次由于警告而失败的早前上传,使用filekey参数。
需要注意,当发送file时,HTTP POST必须做为一次文件上传(也就是使用multipart/form-data
)完成。
- filename
目标文件名。
- comment
上传注释。如果没有指定text,那么它也被用于新文件的初始页面文本。
- 默认:(空)
- tags
更改标签以应用于上传日志记录和文件页面修订中。
- 值(以|或替代物分隔):
- text
用于新文件的初始页面文本。
- watch
- 已弃用。
监视页面。
- 类型:布尔值(详细信息)
- watchlist
无条件地将页面加入至当前用户的监视列表或将其移除,使用设置或不更改监视。
- 以下值中的一个:watch、preferences、nochange
- 默认:preferences
- ignorewarnings
忽略任何警告。
- 类型:布尔值(详细信息)
- file
文件内容。
- 必须被公布为使用multipart/form-data的一次文件上传。
- url
要检索文件来源的URL。
- filekey
用于识别一次临时藏匿的早前上传的关键字。
- sessionkey
- 已弃用。
与filekey相同,基于向后兼容而维护。
- stash
如果设置,服务器将临时藏匿文件而不是加入存储库。
- 类型:布尔值(详细信息)
- filesize
全部上传的文件大小。
- 值必须介于0和104,857,600之间。
- 类型:整数
- offset
数据块的偏移量(字节)。
- 值必须不少于0。
- 类型:整数
- chunk
大块内容。
- 必须被公布为使用multipart/form-data的一次文件上传。
- async
在可能的情况下,使潜在的大文件操作异步进行。
- 类型:布尔值(详细信息)
- checkstatus
只检索指定文件密钥的上传状态。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
action=userrights
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
更改一位用户的组成员。
- user
用户名。
- 类型:用户名
- userid
用户ID。
- 类型:整数
- add
将用户加入至这些组中,或如果其已作为成员,更新其所在用户组成员资格的终止时间。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- expiry
到期时间戳。可以是相对值(例如5 months或2 weeks)或绝对值(例如2014-09-18T12:34:56Z)。如果只设置一个时间戳,它将被用于所有传递给add参数的组。对于永不过时的用户组,使用infinite、indefinite、infinity或never。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- 默认:infinite
- remove
将用户从这些组中移除。
- 值(以|或替代物分隔):bot、sysop、interface-admin、bureaucrat、oversight、flow-bot
- reason
更改原因。
- 默认:(空)
- token
从action=query&meta=tokens取回的“userrights”令牌
出于兼容性考虑,web UI中使用的令牌也被接受。
- 这个参数是必须的。
- tags
要在用户权限日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 将用户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 [在沙盒中打开]
- 添加用户SometimeSysop至用户组sysop,为期1个月。
- api.php?action=userrights&user=SometimeSysop&add=sysop&expiry=1%20month&token=123ABC [在沙盒中打开]
action=validatepassword
- 此模块需要读取权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
验证密码是否符合wiki的密码方针。
如果密码可以接受,就报告有效性为Good,如果密码可用于登录但必须更改,则报告为Change,或如果密码不可使用,则报告为Invalid。
- password
要验证的密码。
- 这个参数是必须的。
- user
用户名,供测试账户创建时使用。命名的用户必须不存在。
- 类型:用户名
电子邮件,供测试账户创建时使用。
- realname
真实姓名,供测试账户创建时使用。
- 验证当前用户的密码foobar。
- api.php?action=validatepassword&password=foobar [在沙盒中打开]
- 为创建用户Example验证密码qwerty。
- api.php?action=validatepassword&password=querty&user=Example [在沙盒中打开]
action=visualeditor
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 来源:VisualEditor
- 许可协议:MIT
从Parsoid服务返回页面的HTML5。
- page
要执行操作的页面。
- 这个参数是必须的。
- format
输出的格式。
- 以下值中的一个:json、jsonfm
- 默认:jsonfm
- paction
要执行的操作。
- 这个参数是必须的。
- 以下值中的一个:parse、metadata、templatesused、wikitext、parsefragment、parsedoc
- wikitext
要发送至Parsoid以转换成HTML的Wiki文本(paction=parsefragment)。
- section
起作用的章节。
- oldid
所要使用的修订版本号(默认为最新修订版本)。
- editintro
编辑介绍以添加至通知中。
- pst
在发送至Parsoid前预保存转换的wiki文本(paction=parsefragment)。
- 类型:布尔值(详细信息)
- preload
要使用内容的页面,如果检索的页面尚无内容的话。
- preloadparams
要替代到预加载页面的参数(如有)。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
action=visualeditoredit
- 此模块是内部或不稳定的。它的操作可以更改而不另行通知。
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:VisualEditor
- 许可协议:MIT
保存一个HTML5页面至MediaWiki(通过Parsoid服务转换为wiki文本)。
- paction
要执行的操作。
- 这个参数是必须的。
- 以下值中的一个:serialize、serializeforcache、diff、save
- page
要执行操作的页面。
- 这个参数是必须的。
- token
从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
- wikitext
扮演的wiki文本。
- section
起作用的章节。
- sectiontitle
新章节的标题。
- basetimestamp
当保存时,设置它作为编辑的修订的时间戳。用于检测编辑冲突。
- starttimestamp
当保存时,设置它作为页面加载时的时间戳。用于检测编辑冲突。
- oldid
要使用的修订版本号。默认为最新版本。0用于一个新页面。
- minor
标记小编辑。
- watch
将该页面加入当前用户的监视列表。
- html
要发送至Parsoid与wiki文本交换的HTML。
- etag
要发送的ETag。
- summary
编辑摘要。
- captchaid
验证码ID(当带验证码保存时)。
- captchaword
回答验证码(当带验证码保存时)。
- cachekey
使用之前的serializeforcache请求的结果带此密钥。覆盖html。
action=watch
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
从当前用户的监视列表中添加或移除页面。
- title
- 已弃用。
要(取消)监视的页面。也可使用titles。
- unwatch
如果设置页面将被取消监视而不是被监视。
- 类型:布尔值(详细信息)
- continue
当更多结果可用时,使用这个继续。
- titles
要工作的标题列表。
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- pageids
要工作的页面ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- revids
要工作的修订ID列表。
- 类型:整数列表
- 通过|或替代物隔开各值。 值的最大数量是50(对于机器人则是500)。
- generator
通过执行指定查询模块获得页面列表以工作。
注意:发生器参数名称必须以“g”开头,参见例子。
- allcategories
- 列举所有分类。
- alldeletedrevisions
- 列举由一位用户或在一个名字空间中所有已删除的修订。
- allfileusages
- 列出所有文件用途,包括不存在的。
- allimages
- 按顺序枚举所有图像。
- alllinks
- 列举所有指向至指定名字空间的链接。
- allpages
- 循序列举在指定名字空间中的所有页面。
- allredirects
- 列出至一个名字空间的重定向。
- allrevisions
- 列举所有修订。
- alltransclusions
- 列出所有嵌入页面(使用{{x}}嵌入的页面),包括不存在的。
- backlinks
- 查找所有链接至指定页面的页面。
- categories
- 页面属于的所有分类列表。
- categorymembers
- 在指定的分类中列出所有页面。
- deletedrevisions
- 获取删除的修订版本信息。
- duplicatefiles
- 根据哈希值列出此给定文件的所有副本。
- embeddedin
- 查找所有嵌入指定标题的页面。
- exturlusage
- 列举包含一个指定URL的页面。
- fileusage
- 查找所有使用指定文件的页面。
- images
- 返回指定页面上包含的所有文件。
- imageusage
- 查找所有使用指定图片标题的页面。
- iwbacklinks
- 查找所有链接至指定跨wiki链接的页面。
- langbacklinks
- 查找所有链接至指定语言链接的页面。
- links
- 从指定页面返回所有链接。
- linkshere
- 查找所有链接至指定页面的页面。
- messagecollection
- 查询有关翻译的MessageCollection。
- pageswithprop
- 列出所有使用指定页面属性的页面。
- prefixsearch
- 为页面标题执行前缀搜索。
- protectedtitles
- 列出所有被限制创建的标题。
- querypage
- 获取由基于QueryPage的特殊页面提供的列表。
- random
- 获取随机页面集。
- recentchanges
- 列举最近更改。
- redirects
- 返回至指定页面的所有重定向。
- revisions
- 获取修订版本信息。
- search
- 执行一次全文本搜索。
- templates
- 返回指定页面上所有被嵌入的页面。
- transcludedin
- 查找所有嵌入指定页面的页面。
- watchlist
- 在当前用户的监视列表中获取对页面的最近更改。
- watchlistraw
- 获得当前用户的监视列表上的所有页面。
- 以下值中的一个:allcategories、alldeletedrevisions、allfileusages、allimages、alllinks、allpages、allredirects、allrevisions、alltransclusions、backlinks、categories、categorymembers、deletedrevisions、duplicatefiles、embeddedin、exturlusage、fileusage、images、imageusage、iwbacklinks、langbacklinks、links、linkshere、messagecollection、pageswithprop、prefixsearch、protectedtitles、querypage、random、recentchanges、redirects、revisions、search、templates、transcludedin、watchlist、watchlistraw
- redirects
自动解决在titles、pageids和revids,以及在由generator返回的页面中的重定向。
- 类型:布尔值(详细信息)
- converttitles
如有需要,将标题转换为其他变体。只有当wiki的内容语言支持变体转换时才能工作。支持变体转换的语言包括en、crh、gan、iu、kk、ku、shi、sr、tg、uz和zh。
- 类型:布尔值(详细信息)
- token
从action=query&meta=tokens取回的“watch”令牌
- 这个参数是必须的。
action=webapp-manifest
- 此模块需要读取权限。
- 来源:MobileFrontend
- 许可协议:GPL-2.0-or-later
返回webapp证明。
format=json
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为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-or-later
输出数据为JSON格式(HTML优质打印效果)。
- wrappedhtml
作为一个JSON对象返回优质打印的HTML和关联的ResouceLoader模块。
- 类型:布尔值(详细信息)
- 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-or-later
不输出任何东西。
format=php
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为序列化PHP格式。
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可能更改!
- latest
- 使用最新格式(当前为2),格式可能在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=phpfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为序列化PHP格式(HTML优质打印效果)。
- wrappedhtml
作为一个JSON对象返回优质打印的HTML和关联的ResouceLoader模块。
- 类型:布尔值(详细信息)
- formatversion
输出格式:
- 1
- 向后兼容格式(XML样式布尔值、用于内容节点的*键等)。
- 2
- 实验现代格式。细节可能更改!
- latest
- 使用最新格式(当前为2),格式可能在没有警告的情况下更改。
- 以下值中的一个:1、2、latest
- 默认:1
format=rawfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为JSON格式,包含调试元素(HTML优质打印效果)。
- wrappedhtml
作为一个JSON对象返回优质打印的HTML和关联的ResouceLoader模块。
- 类型:布尔值(详细信息)
format=xml
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为XML格式。
- xslt
如果指定,加入已命名的页面作为一个XSL样式表。值必须是在MediaWiki名字空间以
.xsl
为结尾的标题。- includexmlnamespace
如果指定,添加一个XML名字空间。
- 类型:布尔值(详细信息)
format=xmlfm
- 此模块需要读取权限。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
输出数据为XML格式(HTML优质打印效果)。
数据类型
至MediaWiki的输入应为NFC标准化的UTF-8。MediaWiki可以尝试转换其他输入,但这可能导致一些操作失败(例如带MD5校验编辑)。
一些在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
- 替代多值分隔符
- 使用多个值的参数通常会与管道符号分隔的值一起提交,例如param=value1|value2或param=value1%7Cvalue2。如果值必须包含管道符号,使用U+001F(单位分隔符)作为分隔符,并在值前加前缀U+001F,例如param=%1Fvalue1%1Fvalue2。
模板参数
模板参数支持API模块需要为每个其他参数赋值的情况。例如如果有API模块请求水果,它会有参数水果指定请求的水果,以及模板参数{水果}-数量以指定每种水果请求多少。需要1个苹果、5个香蕉和20个草莓的API客户端可以做出类似水果=苹果|香蕉|草莓&苹果-数量=1&香蕉-数量=5&草莓-数量=20的请求。
制作人员
API 开发人员:
- Yuri Astrakhan(创建者,2006年9月~2007年9月的开发组领导)
- Roan Kattouw(2007年9月~2009年的开发组领导)
- Victor Vasiliev
- Bryan Tong Minh
- Sam Reed
- Brad Jorsch(2013年至今的开发组领导)
请将您的评论、建议和问题发送至[email protected],或提交错误请求至https://phabricator.wikimedia.org/。