MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子：-{R|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 [在沙盒中打开]