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
在封鎖日誌裡更改套用到項目的標籤。
- 多值 (以 | 或 alternative 分隔)：
- partial
封鎖使用者訪問特殊頁面或命名空間，而不是整個網站。
- 類型：布林值（詳細資訊）
- pagerestrictions
封鎖使用者做出編輯的標題清單。僅在 partial 被設定為 true 時套用。
- 類型：首頁標題
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數量為 10。
- 僅接受存在的頁面。
- namespacerestrictions
封鎖使用者做出編輯的命名空間 ID 清單。僅在 partial 被設定為 true 時套用。
- 多值 (以 | 或 alternative 分隔)：0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、274、275
- 要指定所有值，請使用*。
- 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 [在沙盒中開啟]