MediaWiki API 帮助
这是自动生成的MediaWiki API文档页面。
文档和例子:-{R|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 的用户页和讨论页。
- 类型:布尔型 (详情)
- watchlistexpiry
监视列表期限时间戳。完全忽略该参数可保持当前期限不变。
- 类型:过期(详情)
要在封禁日志中应用到实体的更改标签。
- 值(以|或其转义序列分隔):AWB、CheckNewusermessageSignatures、CleanupCiteDates、CleanupCiteDates (Antigng)、CleanupCiteInvisible、CleanupCiteRedundant、CleanupCiteScriptTitles、CleanupCiteURLWikilinkConflict、CleanupCiteYMD、CleanupDates、CleanupDuplicateArgs、CleanupDuplicateArgs (Antigng)、CleanupExternalLinks、CleanupILH_DOM、DispatchRecentChanges、EditCLI、FillInCitations、F word、MOSIW、MakeRedirect、NonFreeReduce、PopulateCite、ProveIt edit、Remove maintenance tags、RollbackUserEdits、TagGeo、ToolsRedirect、TranslateVariants、Twinkle、WikiMirror、WikitextExtensionForVSCode、ctop edit restriction、file added、huggle、jimmy-bot-non-free、rater、rcpatrol-autopatrol、rcpatrol-ores、rcpatrol-undo、unreferenced template removed、wikiplus、修改演员绰号昵称、修改艺人条目的角色性质、创建与用户名相同条目、添加刪除模板、用户页、疑似COVID-19命名破坏、移除COI模板
- 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、100、101、102、103、118、119、710、711、828、829、2600
- 要指定所有值,请使用*。
- actionrestrictions
阻止用户执行的操作列表。仅在partial设置为true时适用。
- 值(以|或其转义序列分隔):create、move、thanks、upload
- 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 [在沙盒中打开]