MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=protect
(main | protect)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 来源:MediaWiki
- 许可协议:GPL-2.0+
變更頁面的保護層級。
參數:
- title
要(解除)保護頁面的標題。 不能與 pageid 一起使用。
- pageid
要(解除)保護頁面的 ID。 不能與 title 一起使用。
- 类型:整数
- protections
保護層級清單,格式為 action=level (例如 edit=sysop)。
注意: 任何未列入清單項目的限制將會被移除。
- 此參數為必填。
- 使用 | 分隔數值。 上限值為 50 (機器人為 500)。
- expiry
期限時間戳記,若只設定一個時間戳記,該時間戳記將會套用至所有的保護層級。 使用 infinite、indefinite、infinity 或 never 來設定保護層級期限為永遠。
- 使用 | 分隔數值。 上限值為 50 (機器人為 500)。
- 預設值:infinite
- reason
(解除)保護的原因。
- 預設值:(空)
- 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