MediaWiki API 帮助
这是一个自动生成的 MediaWiki API 文档页面。
文档和示例: https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=block
- 此模块需要读取权限。
- 此模块需要写入权限。
- 此模块仅接受 POST 请求。
- 来源: MediaWiki
- 许可:
封禁用户。
- id
修改封禁的 ID(通过 list=blocks 获取)。不能与 user、reblock 或 newblock 一起使用。
- 类型:integer
- user
要封禁的用户。不能与 id 一起使用。
- 类型:user,可通过用户名、IP、临时用户、IP 范围和用户 ID(例如“#12345”)识别
- userid
- 已弃用。
请改用 user=#ID。
- 类型:integer
- 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
如果用户已经被单个封禁封禁,则覆盖现有的封禁。如果用户被多次封禁,这将失败——使用 id 参数指定要覆盖的封禁。不能与 id 或 newblock 一起使用。
- 类型:布尔值(详情)
- newblock
即使用户已经被封禁,也添加另一个封禁。不能与 id 或 reblock 一起使用。
- 类型:布尔值(详情)
- watchuser
监视用户或 IP 地址的用户和讨论页面。
- 类型:布尔值(详情)
- watchlistexpiry
监视列表到期时间戳。完全省略此参数可保留当前到期时间不变。
- 类型:expiry (details)
要应用于封禁日志条目的更改标签。
- 值(用 | 或 备用选项 分隔)
- partial
禁止用户编辑特定页面或命名空间,而不是整个站点。
- 类型:布尔值(详情)
- pagerestrictions
要禁止用户编辑的标题列表。仅当 partial 设置为 true 时才适用。
- 类型:page title
- 用 | 或 其他方式分隔值。
- 最大值是 50。
- 仅接受存在的页面。
- namespacerestrictions
要禁止用户编辑的命名空间 ID 列表。仅当 partial 设置为 true 时才适用。
- 值(用 | 或 其他方式分隔): 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 710, 711, 828, 829
- 要指定所有值,请使用 *。
- actionrestrictions
要禁止用户执行的操作列表。仅当 partial 设置为 true 时才适用。
- 值(用 | 或 alternative 分隔):create, move, thanks, upload
- token
从 action=query&meta=tokens 获取的 "csrf" token
- 此参数是必需的。
- 封禁 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