MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=managetags
(main | managetags)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
執行相關到更改標籤的管理任務。
參數:
- operation
要執行的操作:
- create:創建一個供手動使用的新更改標籤。
- delete:從資料庫移除一個更改標籤,包含移除來自於所有修訂、近期變更項目以及日誌項目的所被使用標籤。
- activate:啟用一個更改標籤,允許使用者手動套用。
- deactivate:棄用一個更改標籤,不允許使用者手動套用。
- 此為必填參數。
- 單值:activate、create、deactivate、delete
- tag
要創建、刪除、啟用或停用的標籤。要標籤創建,標籤必須不存在。要標籤刪除,標籤必須存在。要標籤啟用,標籤必須存在且不能被任何擴充使用到。要標籤停用,標籤必須目前為啟用並且有被手動定義。
- 此為必填參數。
- reason
創建、刪除、啟用、或停用標籤的原因(可選)。
- ignorewarnings
是否在處理期間發生問題時忽略任何警告。
- 類型:布林值(詳細資訊)
- tags
在標籤管理日誌裡更改套用到項目的標籤。
- 多值 (以 | 或 alternative 分隔):
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 建立名為 spam 的標籤,原因:For use in edit patrolling
- api.php?action=managetags&operation=create&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC [在沙盒中開啟]
- 以原因 Misspelt 來刪除 vandlaism 標籤
- api.php?action=managetags&operation=delete&tag=vandlaism&reason=Misspelt&token=123ABC [在沙盒中開啟]
- 啟用名為 spam 的標籤,原因:For use in edit patrolling
- api.php?action=managetags&operation=activate&tag=spam&reason=For+use+in+edit+patrolling&token=123ABC [在沙盒中開啟]
- 停用名為 spam 的標籤,原因:No longer required
- api.php?action=managetags&operation=deactivate&tag=spam&reason=No+longer+required&token=123ABC [在沙盒中開啟]