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 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
要在封禁日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- 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 [在沙盒中打开]