MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例：https://www.mediawiki.org/wiki/API
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
要搜尋的使用者清單（可選）。
- 類型：使用者名稱列表
- 將幾個值以 | 或 alternative 分隔。 上限值為 50（機器人為 500）。
- bkip
取得套用在此 IP 位址或 CIDR 範圍的所有封鎖與所包含的範圍封鎖。不可與 bkusers 一起使用。CIDR 範圍不可超過 IPv4/16 或 IPv6/19。
- bklimit
能列出封鎖的最大數量。
- 不允許超過 500 (機器人為 5,000)。
- 類型：整數或max
- 預設值：10
- bkprop
要取得的屬性。
- id
- 添加封鎖 ID。
- user
- 添加已封鎖使用者的使用者名稱。
- userid
- 添加已封鎖使用者的使用者 ID。
- by
- 添加進行封鎖中的使用者之使用者名稱。
- byid
- 添加進行封鎖中的使用者之使用者 ID。
- timestamp
- 添加當封鎖生效的時間戳記。
- expiry
- 添加當封鎖到期的時間戳記。
- reason
- 添加封鎖的原因。
- range
- 添加受封鎖影響的 IP 地址範圍。
- flags
- 以自動封鎖、僅限匿名、或其它來標記該禁令。
- restrictions
- 若封鎖非整個網站範圍，添加部份封鎖限制。
- 多值 (以 | 或 alternative 分隔)：id、user、userid、by、byid、timestamp、expiry、reason、range、flags、restrictions
- 預設值：id|user|by|timestamp|expiry|reason|flags
- bkshow
僅顯示符合這些標準的項目。 例如僅想查看在 IP 地址的無限期封鎖，請設定 bkshow=ip|!temp。
- 多值 (以 | 或 alternative 分隔)：account、!account、temp、!temp、ip、!ip、range、!range
- bkcontinue
當有更多結果可用時，使用這個繼續。
範例：
- 列出封鎖。
- api.php?action=query&list=blocks [在沙盒中開啟]
- 列出使用者 Alice 與 Bob 的封鎖。
- api.php?action=query&list=blocks&bkusers=Alice|Bob [在沙盒中開啟]