MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=regexblock
(main | regexblock)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:RegexBlock
- 授權條款:GPL-2.0-or-later
透過正規表達式封禁使用者名稱和 IP 位址。
參數:
- regex
封禁用的正規表達式。請注意在 URL 裡若有提供「exact」參數時,這不會被視為正規表達式;而是簡單的字串。
- 此為必填參數。
- expiry
到期時間。可以是相對時間(例如:5 months 或 2 weeks)或是絕對時間(例如:2014-09-18T12:34:56Z)。如果設定成infinite、indefinite或never,封鎖將會無期限。
- 預設值:never
- reason
封鎖原因。
- 預設值:(空)
- nocreate
禁止建立帳號。
- 類型:布林值(詳細資訊)
- exact
使用精準相配來準確地封禁提供的名稱(而不是將此視為正規表達式)。
- 類型:布林值(詳細資訊)
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 以「First strike」為原因來封禁符合「192.0.2.5」的 IP 位址三天
- api.php?action=regexblock®ex=192.0.2.5&expiry=3%20days&reason=First%20strike&exact=&token=123ABC [在沙盒中開啟]
- 封禁正規表達式「SpamUser.*」後,將會封禁任何所有符合表達式內容的使用者名稱,例如像是「SpamUser66」這樣的帳號;以「Bad username」做為原因,會另外在建立新使用者帳號時禁止採用任何符合表達式內容的名稱。
- api.php?action=regexblock®ex=SpamUser.*&expiry=never&reason=Bad%20username&nocreate=&token=123ABC [在沙盒中開啟]