MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
action=block
（main | block）
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源：MediaWiki
- 授權條款：GPL-2.0-or-later
封鎖使用者。
參數：
- 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 [在沙盒中開啟]