MediaWiki API 帮助

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

文档和例子:-{R|https://www.mediawiki.org/wiki/API:Main_page/zh}-

action=block

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

封禁一位用户。

参数:
user

要封禁的用户、IP地址或IP地址段。不能与userid一起使用

类型:用户名
userid

要封禁的用户ID。不能与user一起使用。

类型:整数
expiry

到期时间。可以是相对时间(例如5 months2 weeks)或绝对时间(例如2014-09-18T12:34:56Z)。如果设置为infiniteindefinitenever,封禁将无限期。

默认: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 [在沙盒中打开]