MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=blocks （bk）
- 此模組需要讀取權限。
- 來源：MediaWiki
- 授權條款：GPL-2.0-or-later
列出所有被封鎖使用者與 IP 位址。
具體參數：
其他通用參數可用。
- bkstart
起始列舉的時間戳記。
- 類型：時間戳記（允許格式）
- bkend
終止列舉的時間戳記。
- 類型：時間戳記（允許格式）
- bkdir
列舉的方向：
- newer
- 最早的優先。注意：bkstart應早於bkend。
- older
- 最新的優先（預設）。注意：bkstart應晚於bkend。
- 單值：newer、older
- 預設值：older
- bkids
要列出的封鎖 ID 清單（可選）。
- 類型：整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50（用於客戶端允許的較高限制為 500）。
- bkusers
要搜尋的使用者清單（可選）。
- 類型：使用者清單，按任何使用者名稱、IP和IP 範圍
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50（用於客戶端允許的較高限制為 500）。
- bkip
取得套用在此 IP 位址或 CIDR 範圍的所有封鎖與所包含的範圍封鎖。不可與 bkusers 一起使用。CIDR 範圍不可超過 IPv4/16 或 IPv6/19。
- bklimit
能列出封鎖的最大數量。
- 類型：整數或max
- 數值必須在 1 與 500 之間。
- 預設值：10
- bkprop
要取得的屬性。
- id
- 添加封鎖 ID。
- user
- 添加已封鎖使用者的使用者名稱。
- userid
- 添加已封鎖使用者的使用者 ID。
- by
- 加入執行封鎖的使用者名稱。
- byid
- 新增執行封鎖者的使用者ID。
- timestamp
- 添加當封鎖生效的時間戳記。
- expiry
- 添加當封鎖到期的時間戳記。
- reason
- 添加封鎖的原因。
- range
- 添加受封鎖影響的 IP 地址範圍。
- flags
- 以自動封鎖、僅限匿名、或其它來標記該禁令。
- restrictions
- 若封鎖非整個網站範圍，添加部份封鎖限制。
- 多值 (以 | 或 alternative 分隔)：by、byid、expiry、flags、id、range、reason、restrictions、timestamp、user、userid
- 預設值：id|user|by|timestamp|expiry|reason|flags
- bkshow
僅顯示符合這些標準的項目。 例如僅想查看在 IP 地址的無限期封鎖，請設定 bkshow=ip|!temp。
- 多值 (以 | 或 alternative 分隔)：!account、!ip、!range、!temp、account、ip、range、temp
- bkcontinue
當更多結果可用時，使用這個繼續。可在 mediawiki.org 取得更多有關如何繼續查詢的詳細資訊。
範例：
- 列出封鎖。
- api.php?action=query&list=blocks [在沙盒中開啟]
- 列出使用者 Alice 與 Bob 的封鎖。
- api.php?action=query&list=blocks&bkusers=Alice|Bob [在沙盒中開啟]