API沙盒

使用此页面来试验MediaWiki网页服务API。有关API使用的更多细节，请参考API文档。例如：搜索与特定关键字匹配的页面标题。请选择一个操作以便查看更多示例。注意，虽然这是一个沙盒，但你在这个页面上进行的操作可能会修改wiki。

main

状态：MediaWiki API是一个成熟稳定的接口，得到了积极的支持和改进。尽管我们尽力避免，但偶尔也需要作出重大更新；请订阅mediawiki-api-announce 邮件列表以便获得更新通知。

错误请求：当API收到错误请求时，HTTP header将会返回一个包含"MediaWiki-API-Error"的值，随后header的值与error code将会送回并设置为相同的值。详细信息请参阅API：错误与警告。

测试中：测试API请求的易用性，请参见Special:ApiSandbox。

示例

要执行的操作。展开

block: 封禁一位用户。
cargoautocomplete: 由Cargo扩展使用的自动完成调用。
cargofields: 取得指定表格裡的所有欄位
cargoformatparams: 获取每个Cargo查询格式的显示参数的集合。
cargoquery: 在Cargo数据上运行一次查询。
cargoqueryautocomplete: CargoQuery（之前是ViewData）特殊页面使用的自动完成调用。
cargorecreatedata: 重新在Cargo表格中填充数据。
cargorecreatespecialtable: 创建特殊Cargo表。
cargorecreatetables: 重新创建一个或多个Cargo表格。
cargotables: 取得系統裡的所有表格
changeauthenticationdata: 更改当前用户的身份验证数据。
changecontentmodel: 变更页面的内容模型
checktoken: 从action=query&meta=tokens检查令牌有效性。
clearhasmsg: 清除当前用户的hasmsg标记。
clientlogin: 使用交互式流登录wiki。
compare: 获取两页面之间的差异。
createaccount: 创建一个新用户账号。
delete: 删除一个页面。
echomarkread: 对当前用户标记通知为已读。
echomarkseen: 对当前用户标记通知为已读。
echomute: 将来自某些用户或页面的通知静音或取消静音。
edit: 创建和编辑页面。
emailuser: 电子邮件联系一位用户。
embedvideo: 得到所给参数生成的视频嵌入代码。
expandtemplates: 展开wikitext中的所有模板。
feedcontributions: 返回用户贡献纲要。
feedrecentchanges: 返回最近更改的摘要。
feedwatchlist: 返回监视列表纲要。
filerevert: 回退一个文件至某一旧版本。
getgeetestcode: 获取极验验证码所需的数据
help: 显示指定模块的帮助。
imagerotate: 旋转一幅或多幅图像。
import: 从其他wiki，或从XML文件导入页面。
linkaccount: 将来自第三方提供商的账号链接至当前用户。
login: 登录并获取身份验证cookie。
logout: 退出并清除会话数据。
managetags: 执行有关更改标签的管理任务。
mergehistory: 合并页面历史。
move: 移动一个页面。
opensearch: 使用开放搜索协议搜索wiki。
options: 更改当前用户的参数设置。
paraminfo: 获得关于API模块的信息。
parse: 解析内容并返回解析器输出。
patrol: 巡查页面或修订版本。
protect: 更改页面的保护等级。
purge: 为指定标题刷新缓存。
query: 取得来自并有关MediaWiki的数据。
removeauthenticationdata: 从当前用户移除身份验证数据。
resetpassword: 向用户发送密码重置邮件。
revisiondelete: 删除和恢复修订版本。
rollback: 撤销对页面的最近编辑。
rsd: 导出一个RSD（Really Simple Discovery）架构。
setnotificationtimestamp: 更新监视页面的通知时间戳。
setpagelanguage: 更改页面的语言。
tag: 从个别修订或日志记录中添加或移除更改标签。
thank: 向一名编辑者发送感谢通知。
unblock: 解封一位用户。
undelete: 取消删除页面的修订版本。
unlinkaccount: 从当前用户移除已链接的第三方账号。
upload: 上传文件，或获取正在等待中的上传的状态。
userrights: 更改一位用户的组成员。
validatepassword: 验证密码是否符合wiki的密码方针。
watch: 从当前用户的监视列表中添加或移除页面。
categorytree: 内部的。用于CategoryTree扩展的内部模块。
cspreport: 内部的。由浏览器使用以报告违反内容安全方针的内容。此模块应永不使用，除了在被CSP兼容的浏览器自动使用时。
oathvalidate: 内部的。验证一个双因素验证（OATH）令牌。
stashedit: 内部的。在分享缓存中准备编辑。
visualeditor: 内部的。从Parsoid服务返回页面的HTML5。
visualeditoredit: 内部的。保存一个HTML5页面至MediaWiki（通过Parsoid服务转换为wikitext）。

输出的格式。展开

json: 输出数据为JSON格式。
jsonfm: 输出数据为JSON格式（使用HTML格式显示）。
none: 不输出任何东西。
php: 输出数据为序列化PHP格式。
phpfm: 输出数据为序列化PHP格式（使用HTML格式显示）。
rawfm: 输出数据为JSON格式，包含调试元素（使用HTML格式显示）。
xml: 输出数据为XML格式。
xmlfm: 输出数据为XML格式（使用HTML格式显示）。

最大延迟可被用于MediaWiki安装于数据库复制集中。要保存导致更多网站复制延迟的操作，此参数可使客户端等待直到复制延迟少于指定值时。万一发生过多延迟，错误代码maxlag会返回消息，例如等待$host中：延迟$lag秒。
参见手册:Maxlag参数以获取更多信息。

设置s-maxage HTTP缓存控制头至这些秒。错误不会缓存。

设置max-age HTTP缓存控制头至这些秒。错误不会缓存。

如果设置为user就验证用户已登录；如果设置为anon就验证用户未登录；如果设置为bot就验证是否有机器人用户权限。

验证当前用户是命名用户。

任何在此提供的值将包含在响应中。可以用以区别请求。

包含保存结果请求的主机名。

在结果中包括当前时间戳。

包含在结果中用于uselang和errorlang的语言。

使用跨域AJAX请求(CORS)访问API时，请将其设置为原始域。这必须包括在任何pre-flight请求中，因此必须是请求URI（而不是POST正文）的一部分。

对于已验证的请求，这必须正确匹配Origin标头中的原点之一，因此必须将其设置为类似-{R|https://zh.wikipedia.org}-或-{R|https://meta.wikimedia.org}-的东西。如果此参数不匹配Origin页顶，就返回403错误响应。如果此参数与Origin标头不匹配，将返回403响应。如果此参数与Origin标头匹配并且允许来源，则将设置Access-Control-Allow-Origin和Access-Control-Allow-Credentials开头。

对于未验证的请求，会指定值*。这将导致Access-Control-Allow-Origin标头被设置，但Access-Control-Allow-Credentials将为false，且所有用户特定数据将受限制。

用于消息翻译的语言。action=query&meta=siteinfo与siprop=languages可返回语言代码列表，或指定user以使用当前用户的语言设置，或指定content以使用此wiki的内容语言。

语言变种。仅当基础语言支持变种转换时起作用。

用于警告和错误文本输出的格式展开

plaintext: 包括HTML标签的wikitext被移除并且实体被替换。
wikitext: 未解析的wikitext。
html: HTML
raw: 消息的键和参数。
none: 没有文本输出，仅有错误代码。
bc: MediaWiki 1.29之前使用的格式。errorlang和errorsuselocal会被忽略。

用于警告和错误的语言。action=query&meta=siteinfo带siprop=languages返回语言代码的列表，或指定content以使用此wiki的内容语言，或指定uselang以使用与uselang参数相同的值。

如果指定，错误文本将使用来自MediaWiki命名空间的本地自定义消息。