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范围和用户ID(例如“#12345”) 中任意一种方式指定的用户
- userid
- 已弃用。
改成指定user=#ID。
- Type: integer
- expiry
到期时间。可以是相对时间（例如5 months或2 weeks）或绝对时间（例如2014-09-18T12:34:56Z）。如果设置为infinite、indefinite或never，封禁将无限期。
- Default: never
- reason
封禁的原因。
- 默认：（空）
- anononly
只封禁匿名用户（也就是说禁止此 IP 地址的匿名编辑）。
- Type: boolean (details)
- nocreate
防止创建帐户。
- Type: boolean (details)
- autoblock
自动封禁最近使用的IP地址，以及以后他们尝试登陆使用的IP地址。
- Type: boolean (details)
- noemail
阻止用户通过wiki发送电子邮件。（需要
blockemail权限）。- Type: boolean (details)
- hidename
从封禁日志中隐藏用户名。（需要
hideuser权限）。- Type: boolean (details)
- allowusertalk
允许用户编辑自己的讨论页（取决于$wgBlockAllowsUTEdit）。
- Type: boolean (details)
- reblock
如果该用户已被封禁，则覆盖已有的封禁。
- Type: boolean (details)
- watchuser
监视用户或该 IP 的用户页和讨论页。
- Type: boolean (details)
- tags
要在封禁日志中应用到实体的更改标签。
- 值（以|或替代物分隔）：
- partial
封禁用户于特定页面或名字空间而不是整个站点。
- Type: boolean (details)
- pagerestrictions
阻止用户编辑的标题列表。仅在partial设置为true时适用。
- 通过|或替代物隔开各值。
- Maximum number of values is 10.
- namespacerestrictions
用于阻止用户编辑的名字空间ID列表。仅在partial设置为true时适用。
- 值（以|或替代物分隔）：0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 要指定所有值，请使用*。
- token
从action=query&meta=tokens取回的“csrf”令牌
- This parameter is required.
例子：
- 有原因地将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 [在沙盒中打开]