MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
action=block
(main | block)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 来源：MediaWiki
- 许可协议：GPL-2.0+
封鎖使用者。
參數：
- 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
要在封禁日志中应用到实体的更改标签。
- 多值 (以 | 或 alternative 分隔)：
- 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 [在沙盒中打开]
- 永久封鎖 IP 位址 Vandal，原因為 Vandalism。
- api.php?action=block&user=Vandal&expiry=never&reason=Vandalism&nocreate=&autoblock=&noemail=&token=123ABC [在沙盒中打开]