MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
action=tag
(main | tag)
- 此模組需要讀取權限。
- 此模組需要寫入權限。
- 此模組僅接受 POST 請求。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
從各別修訂或日誌項目添加或移除變更標籤。
參數:
- rcid
要添加或移除標籤的一個或多個近期變更 ID。
- 類型:整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- revid
要添加或移除標籤的一個或多個修訂 ID。
- 類型:整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- logid
要添加或移除標籤的一個或多個日誌項目 ID。
- 類型:整數列表
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- add
要添加的標籤。僅有手動定義的標籤可被添加。
- 多值 (以 | 或 alternative 分隔):
- remove
要移除的標籤。僅有手動定義或完全未定義的標籤可被移除。
- 將幾個值以 | 或 alternative 分隔。
- 值的最大數目為 50(用於客戶端允許的較高限制為 500)。
- reason
變更的原因。
- 預設值:(空)
- tags
套用到日誌項目的標籤會被建立為此操作的結果。
- 多值 (以 | 或 alternative 分隔):
- token
自 action=query&meta=tokens 接收的「csrf」權杖。
- 此為必填參數。
範例:
- 不指明原因將 ID 為 123 的修訂添加 vandalism 標籤
- api.php?action=tag&revid=123&add=vandalism&token=123ABC [在沙盒中開啟]
- 將 ID 為 123 的日誌項目移除 spam 標籤,原因:Wrongly applied
- api.php?action=tag&logid=123&remove=spam&reason=Wrongly+applied&token=123ABC [在沙盒中開啟]