MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=protect
(main | protect)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
變更頁面的保護層級。
參數:
- title
要(解除)保護頁面的標題。 不能與 pageid 一起使用。
- pageid
要(解除)保護頁面的 ID。 不能與 title 一起使用。
- 類型:整數
- protections
保護層級清單,格式為 action=level(例如 edit=sysop)。all 層級代表所有人都可以進行行動,亦即無限制。
注意:未列入清單項目的限制皆會移除。
- 此為必填參數。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- expiry
期限時間戳記,若只設定一個時間戳記,該時間戳記將會套用至所有的保護層級。 使用 infinite、indefinite、infinity 或 never 來設定保護層級期限為永遠。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- 預設值:infinite
- reason
(解除)保護的原因。
- 預設值:(空)
- tags
修改標籤以套用於保護日誌裡的項目。
- 多值 (以 | 或 alternative 分隔):
- cascade
啟用連鎖保護(也就是保護包含於此頁面的頁面)。如果所有提供的保護等級不支援連鎖,就將其忽略。
- 類型:布林值(詳細資訊)
- watch
- 已棄用。
如果被設定,就將被(解除)保護的頁面加至目前使用者的監視列表。
- 類型:布林值(詳細資訊)
- watchlist
使用偏好設定無條件地將頁面加入至或移除自目前使用者的監視清單,或不更改監視。
- 單值:nochange、preferences、unwatch、watch
- 預設值:preferences
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 保護一個頁面。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=sysop|move=sysop&cascade=&expiry=20070901163000|never [在沙盒中開啟]
- 透過設定為 all(註:代表任何人都可以執行操作),來解除對頁面的保護。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=edit=all|move=all&reason=Lifting%20restrictions [在沙盒中開啟]
- 透過設定為沒有限制,來解除對頁面的保護。
- api.php?action=protect&title=Main%20Page&token=123ABC&protections=&reason=Lifting%20restrictions [在沙盒中開啟]