MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=block
(main | block)
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块只允许POST请求。
- 来源:MediaWiki
- 许可协议:GPL-2.0-or-later
封禁一位用户。
参数:
- user
要封禁的用户。
- 类型:通过 用户名、IP、IP范围和用户ID(例如“#12345”) 中任意一种方式指定的用户
- userid
- 已弃用。
改成指定user=#ID。
- 类型:整数
- 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
要在封禁日志中应用到实体的更改标签。
- 值(以|或替代物分隔):
- partial
封禁用户于特定页面或命名空间而不是整个站点。
- 类型:布尔型 (详情)
- pagerestrictions
阻止用户编辑的标题列表。仅在partial设置为true时适用。
- 类型:页面标题
- 通过|或替代物隔开各值。
- 值的最大值为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”令牌
- 这个参数是必须的。
例子:
- 有原因地将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 [在沙盒中打开]