MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/API
action=protect
(main | protect)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
更改页面的保护等级。
參數:
- 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