MediaWiki API 帮助

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

文档和例子：https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page

action=block

（main | block）
  • 此模块需要读取权限。
  • 此模块需要写入权限。
  • 此模块只允许POST请求。
  • 来源：MediaWiki
  • 许可协议：GPL-2.0-or-later

封禁一位用户。

参数：
user

要封禁的用户。

类型：通过 用户名、​IP、​IP范围和用户ID(例如“#12345”) 中任意一种方式指定的用户
userid
已弃用。

改成指定user=#ID。

类型：整数
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

要在封禁日志中应用到实体的更改标签。

值（以|或替代物分隔）：
partial

封禁用户于特定页面或命名空间而不是整个站点。

类型：布尔型 (详情)
pagerestrictions

阻止用户编辑的标题列表。仅在partial设置为true时适用。

类型：页面标题
通过|或替代物隔开各值。
值的最大值为10。
仅接受存在的页面。
namespacerestrictions

用于阻止用户编辑的命名空间ID列表。仅在partial设置为true时适用。

值（以|或替代物分隔）：0、​1、​2、​3、​4、​5、​6、​7、​8、​9、​10、​11、​12、​13、​14、​15、​710、​711、​2300、​2301、​2302、​2303
要指定所有值，请使用*。
token

从action=query&meta=tokens取回的“csrf”令牌

这个参数是必需的。
例子：
有原因地将IP地址192.0.2.5封禁三天。
api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [在沙盒中打开]
有原因地将用户Vandal永久封禁，并阻止新账户创建和电子邮件发送。
api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [在沙盒中打开]
取自“http://mtf.aimo.moe/wiki/特殊:Api帮助”