MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
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 分隔):Twinkle
- cascade
啟用連鎖保護(也就是保護包含於此頁面的頁面)。如果所有提供的保護等級不支援連鎖,就將其忽略。
- 类型:布尔值(详细信息)
- watch
- 已停用。
如果被設定,就將被(解除)保護的頁面加至目前使用者的監視列表。
- 类型:布尔值(详细信息)
- watchlist
無條件地將該頁面加入至或移除自目前使用者的監視列表、使用偏好設定或不更改監視。
- 單值:watch、unwatch、preferences、nochange
- 預設值: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 [在沙盒中打开]