MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:https://www.mediawiki.org/wiki/API:Main_page/zh
action=block
(main | block)
- 此模块需要读取权限。
 - 此模块需要写入权限。
 - 此模块只允许POST请求。
 - 来源:MediaWiki
 - 许可协议:GPL-2.0+
 
封禁一位用户。
参数:
- user
 您要封禁的用户、IP地址或IP地址段。
- 这个参数是必须的。
 - 类型:用户名
 - expiry
 到期时间。可以是相对时间(例如5 months或2 weeks)或绝对时间(例如2014-09-18T12:34:56Z)。如果设置为infinite、indefinite或never,封禁将无限期。
- 默认:never
 - reason
 封禁的原因。
- 默认:(空)
 - anononly
 只封禁匿名用户(也就是说禁止此 IP 地址的匿名编辑)。
- 类型:布尔值(详细信息)
 - nocreate
 防止创建帐户。
- 类型:布尔值(详细信息)
 - autoblock
 自动封禁最近使用的IP地址,以及以后他们尝试登陆使用的IP地址。
- 类型:布尔值(详细信息)
 - noemail
 阻止用户通过wiki发送电子邮件。(需要
blockemail权限)。- 类型:布尔值(详细信息)
 - hidename
 从封禁日志中隐藏用户名。(需要
hideuser权限)。- 类型:布尔值(详细信息)
 - allowusertalk
 允许用户编辑自己的讨论页(取决于$wgBlockAllowsUTEdit)。
- 类型:布尔值(详细信息)
 - reblock
 如果该用户已被封禁,则覆盖已有的封禁。
- 类型:布尔值(详细信息)
 - watchuser
 监视用户或该 IP 的用户页和讨论页。
- 类型:布尔值(详细信息)
 - token
 从action=query&meta=tokens取回的“csrf”令牌
- 这个参数是必须的。
 
例子:
- 封禁IP地址192.0.2.5三天,原因First strike。
 - api.php?action=block&user=192.0.2.5&expiry=3%20days&reason=First%20strike&token=123ABC [在沙盒中打开]
 - 无限期封禁用户Vandal,原因Vandalism,并阻止新账户创建和电子邮件发送。
 - api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [在沙盒中打开]